langwatch 1.3.0 → 1.4.0

package/dist/observability-sdk/index.d.mts

@@ -1,9 +1,9 @@
-export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, b as LangWatchExporterOptions, c as LangWatchLogger, L as LangWatchTraceExporter, b as LangWatchTraceExporterOptions, S as SpanProcessingExcludeRule, g as getLangWatchLogger, d as getLangWatchLoggerFromProvider, a as getLangWatchTracer, e as getLangWatchTracerFromProvider } from '../implementation-Bd2Z0kjH.mjs';
+export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, b as LangWatchExporterOptions, c as LangWatchLogger, L as LangWatchTraceExporter, b as LangWatchTraceExporterOptions, S as SpanProcessingExcludeRule, g as getLangWatchLogger, d as getLangWatchLoggerFromProvider, a as getLangWatchTracer, e as getLangWatchTracerFromProvider } from '../implementation-WfGxOvyq.mjs';
 import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
 import { D as DataCaptureMode } from '../types-DLfhJb38.mjs';
 export { a as DataCaptureConfig, b as DataCaptureContext, c as DataCaptureOptions, d as DataCapturePredicate } from '../types-DLfhJb38.mjs';
-import { L as LangWatchSpan } from '../types-ruthADbq.mjs';
-export { A as AddEvaluationParams, E as EvaluationStatus, e as EvaluationTimestamps, I as INPUT_OUTPUT_TYPES, f as InputOutputType, J as JsonSerializable, g as LangWatchSpanMetrics, h as LangWatchSpanOptions, i as LangWatchSpanRAGContext, j as LangWatchTracer, S as SimpleChatMessage, k as SpanType, l as emitEvaluationEvent, s as spanTypes } from '../types-ruthADbq.mjs';
+import { L as LangWatchSpan } from '../types-NCH43GuW.mjs';
+export { A as AddEvaluationParams, E as EvaluationStatus, e as EvaluationTimestamps, I as INPUT_OUTPUT_TYPES, f as InputOutputType, J as JsonSerializable, g as LangWatchSpanMetrics, h as LangWatchSpanOptions, i as LangWatchSpanRAGContext, j as LangWatchTracer, S as SimpleChatMessage, k as SpanType, l as emitEvaluationEvent, s as spanTypes } from '../types-NCH43GuW.mjs';
 import { Span } from '@opentelemetry/api';
 export { S as SemConvAttributeKey, a as SemConvAttributes, b as SemConvLogRecordAttributes, l as attributes } from '../types-VOZv9LYO.mjs';
 import '@opentelemetry/sdk-trace-base';

package/dist/observability-sdk/index.d.ts

@@ -1,9 +1,9 @@
-export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, b as LangWatchExporterOptions, c as LangWatchLogger, L as LangWatchTraceExporter, b as LangWatchTraceExporterOptions, S as SpanProcessingExcludeRule, g as getLangWatchLogger, d as getLangWatchLoggerFromProvider, a as getLangWatchTracer, e as getLangWatchTracerFromProvider } from '../implementation-Cdrj3mBw.js';
+export { F as FilterableBatchSpanProcessor, L as LangWatchExporter, b as LangWatchExporterOptions, c as LangWatchLogger, L as LangWatchTraceExporter, b as LangWatchTraceExporterOptions, S as SpanProcessingExcludeRule, g as getLangWatchLogger, d as getLangWatchLoggerFromProvider, a as getLangWatchTracer, e as getLangWatchTracerFromProvider } from '../implementation-bVu7gJFf.js';
 import { OTLPLogExporter } from '@opentelemetry/exporter-logs-otlp-http';
 import { D as DataCaptureMode } from '../types-DLfhJb38.js';
 export { a as DataCaptureConfig, b as DataCaptureContext, c as DataCaptureOptions, d as DataCapturePredicate } from '../types-DLfhJb38.js';
-import { L as LangWatchSpan } from '../types-DzSFwVBw.js';
-export { A as AddEvaluationParams, E as EvaluationStatus, e as EvaluationTimestamps, I as INPUT_OUTPUT_TYPES, f as InputOutputType, J as JsonSerializable, g as LangWatchSpanMetrics, h as LangWatchSpanOptions, i as LangWatchSpanRAGContext, j as LangWatchTracer, S as SimpleChatMessage, k as SpanType, l as emitEvaluationEvent, s as spanTypes } from '../types-DzSFwVBw.js';
+import { L as LangWatchSpan } from '../types-DB6nS7nW.js';
+export { A as AddEvaluationParams, E as EvaluationStatus, e as EvaluationTimestamps, I as INPUT_OUTPUT_TYPES, f as InputOutputType, J as JsonSerializable, g as LangWatchSpanMetrics, h as LangWatchSpanOptions, i as LangWatchSpanRAGContext, j as LangWatchTracer, S as SimpleChatMessage, k as SpanType, l as emitEvaluationEvent, s as spanTypes } from '../types-DB6nS7nW.js';
 import { Span } from '@opentelemetry/api';
 export { S as SemConvAttributeKey, a as SemConvAttributes, b as SemConvLogRecordAttributes, l as attributes } from '../types-VOZv9LYO.js';
 import '@opentelemetry/sdk-trace-base';

package/dist/observability-sdk/index.js

@@ -14,7 +14,7 @@ var _chunkK6KPNTQOjs = require('../chunk-K6KPNTQO.js');
 
 
 
-var _chunkGOGMRTV5js = require('../chunk-GOGMRTV5.js');
+var _chunkG724AXIBjs = require('../chunk-G724AXIB.js');
 
 
 
@@ -38,5 +38,5 @@ var _chunkCLTKABMOjs = require('../chunk-CLTKABMO.js');
 
 
 
-exports.DataCapturePresets = _chunkZTOXEWNXjs.DataCapturePresets; exports.FilterableBatchSpanProcessor = _chunkZTOXEWNXjs.FilterableBatchSpanProcessor; exports.LangWatchExporter = _chunkGOGMRTV5js.LangWatchTraceExporter; exports.LangWatchLogsExporter = _chunkGOGMRTV5js.LangWatchLogsExporter; exports.LangWatchTraceExporter = _chunkGOGMRTV5js.LangWatchTraceExporter; exports.attributes = _chunkCLTKABMOjs.attributes_exports; exports.createLangWatchSpan = _chunkK6KPNTQOjs.createLangWatchSpan; exports.emitEvaluationEvent = _chunkK6KPNTQOjs.emitEvaluationEvent; exports.getDataCaptureMode = _chunkCLTKABMOjs.getDataCaptureMode; exports.getLangWatchLogger = _chunkGOGMRTV5js.getLangWatchLogger; exports.getLangWatchLoggerFromProvider = _chunkGOGMRTV5js.getLangWatchLoggerFromProvider; exports.getLangWatchTracer = _chunkK6KPNTQOjs.getLangWatchTracer; exports.getLangWatchTracerFromProvider = _chunkK6KPNTQOjs.getLangWatchTracerFromProvider; exports.shouldCaptureInput = _chunkCLTKABMOjs.shouldCaptureInput; exports.shouldCaptureOutput = _chunkCLTKABMOjs.shouldCaptureOutput; exports.spanTypes = _chunkK6KPNTQOjs.spanTypes;
+exports.DataCapturePresets = _chunkZTOXEWNXjs.DataCapturePresets; exports.FilterableBatchSpanProcessor = _chunkZTOXEWNXjs.FilterableBatchSpanProcessor; exports.LangWatchExporter = _chunkG724AXIBjs.LangWatchTraceExporter; exports.LangWatchLogsExporter = _chunkG724AXIBjs.LangWatchLogsExporter; exports.LangWatchTraceExporter = _chunkG724AXIBjs.LangWatchTraceExporter; exports.attributes = _chunkCLTKABMOjs.attributes_exports; exports.createLangWatchSpan = _chunkK6KPNTQOjs.createLangWatchSpan; exports.emitEvaluationEvent = _chunkK6KPNTQOjs.emitEvaluationEvent; exports.getDataCaptureMode = _chunkCLTKABMOjs.getDataCaptureMode; exports.getLangWatchLogger = _chunkG724AXIBjs.getLangWatchLogger; exports.getLangWatchLoggerFromProvider = _chunkG724AXIBjs.getLangWatchLoggerFromProvider; exports.getLangWatchTracer = _chunkK6KPNTQOjs.getLangWatchTracer; exports.getLangWatchTracerFromProvider = _chunkK6KPNTQOjs.getLangWatchTracerFromProvider; exports.shouldCaptureInput = _chunkCLTKABMOjs.shouldCaptureInput; exports.shouldCaptureOutput = _chunkCLTKABMOjs.shouldCaptureOutput; exports.spanTypes = _chunkK6KPNTQOjs.spanTypes;
 //# sourceMappingURL=index.js.map

package/dist/observability-sdk/index.mjs

@@ -14,7 +14,7 @@ import {
   LangWatchTraceExporter,
   getLangWatchLogger,
   getLangWatchLoggerFromProvider
-} from "../chunk-7SZIBH2A.mjs";
+} from "../chunk-TMIZYFEI.mjs";
 import {
   attributes_exports,
   getDataCaptureMode,

package/dist/observability-sdk/instrumentation/langchain/index.d.mts

@@ -1,6 +1,6 @@
 import * as _opentelemetry_api from '@opentelemetry/api';
 import { Attributes } from '@opentelemetry/api';
-import { j as LangWatchTracer, L as LangWatchSpan, m as ChatMessage } from '../../../types-ruthADbq.mjs';
+import { j as LangWatchTracer, L as LangWatchSpan, m as ChatMessage } from '../../../types-NCH43GuW.mjs';
 import { AgentAction, AgentFinish } from '@langchain/core/agents';
 import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
 import { DocumentInterface } from '@langchain/core/documents';

package/dist/observability-sdk/instrumentation/langchain/index.d.ts

@@ -1,6 +1,6 @@
 import * as _opentelemetry_api from '@opentelemetry/api';
 import { Attributes } from '@opentelemetry/api';
-import { j as LangWatchTracer, L as LangWatchSpan, m as ChatMessage } from '../../../types-DzSFwVBw.js';
+import { j as LangWatchTracer, L as LangWatchSpan, m as ChatMessage } from '../../../types-DB6nS7nW.js';
 import { AgentAction, AgentFinish } from '@langchain/core/agents';
 import { BaseCallbackHandler } from '@langchain/core/callbacks/base';
 import { DocumentInterface } from '@langchain/core/documents';

package/dist/observability-sdk/setup/node/index.js

@@ -1,11 +1,11 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
 
-var _chunkKUJACQJ2js = require('../../../chunk-KUJACQJ2.js');
-require('../../../chunk-GOGMRTV5.js');
+var _chunkDINMABRWjs = require('../../../chunk-DINMABRW.js');
+require('../../../chunk-G724AXIB.js');
 require('../../../chunk-CLTKABMO.js');
 
 
 
-exports.ensureSetup = _chunkKUJACQJ2js.ensureSetup; exports.setupObservability = _chunkKUJACQJ2js.setupObservability;
+exports.ensureSetup = _chunkDINMABRWjs.ensureSetup; exports.setupObservability = _chunkDINMABRWjs.setupObservability;
 //# sourceMappingURL=index.js.map

package/dist/observability-sdk/setup/node/index.mjs

@@ -1,8 +1,8 @@
 import {
   ensureSetup,
   setupObservability
-} from "../../../chunk-SOODMKTN.mjs";
-import "../../../chunk-7SZIBH2A.mjs";
+} from "../../../chunk-H7FNDLEM.mjs";
+import "../../../chunk-TMIZYFEI.mjs";
 import "../../../chunk-CMZFFKLA.mjs";
 export {
   ensureSetup,

package/dist/{types-DzSFwVBw.d.ts → types-DB6nS7nW.d.ts}

@@ -2088,7 +2088,7 @@ interface paths {
         put?: never;
         /**
          * Create virtual key
-         * @description Mints a new virtual key and returns the secret exactly once. The caller MUST persist the `secret` value, because LangWatch stores only a hash. `scopes` defaults to the caller's project; org- and team-scoped keys require a scoped API key holding `virtualKeys:manage` at each requested scope. An org- or team-scoped key also needs a place for its traces and spend to land: pass `trace_project_id` (needs `virtualKeys:manage` on that project), or the organization's governance project is used, and creation refuses with `trace_project_required` when neither exists. Send `Idempotency-Key` to make a retry safe: a replay returns the original response including its `secret`, which is the only way to recover a secret whose response was lost in transit.
+         * @description Mints a new virtual key and returns the secret exactly once. The caller MUST persist the `secret` value, because LangWatch stores only a hash. `scopes` defaults to the caller's project; org- and team-scoped keys require a scoped API key holding `virtualKeys:manage` at each requested scope. An org- or team-scoped key also needs a place for its traces and spend to land, and must say where: pass `trace_project_id` (needs `virtualKeys:manage` on that project). Without it, and without exactly one project scope to take it from, creation refuses with `gateway_trace_project_ambiguous`, because the spend would be attributed to the organization's hidden governance project and counted by no budget on the project you had in mind. An organization whose only project is the governance one is exempt, since there is nothing else to name; one with no governance project either refuses with `trace_project_required`. Send `Idempotency-Key` to make a retry safe: a replay returns the original response including its `secret`, which is the only way to recover a secret whose response was lost in transit.
          */
         post: operations["postApiGatewayV1Virtual-keys"];
         delete?: never;
@@ -2257,7 +2257,7 @@ interface paths {
         put?: never;
         /**
          * Create budget
-         * @description Creates an organization-owned budget. The scope discriminates which resource the budget covers (organization / team / project / virtual_key / principal / group). `group` budgets are per-member allowances and require a deployment with the ClickHouse spend ledger (`group_budget_requires_clickhouse` otherwise). `provider_key` optionally pins the budget to one model provider. `cycle_anchor_at` optionally phases the window off a chosen instant instead of the calendar, for budgets that have to line up with a billing date. Send `Idempotency-Key` to make a retry safe.
+         * @description Creates an organization-owned budget. The scope discriminates which resource the budget covers, across all seven scope types (organization / team / project / virtual_key / principal / group / attributed_user). `group` budgets are per-member allowances and `attributed_user` budgets are per-end-user templates; both require a deployment with the ClickHouse spend ledger (`group_budget_requires_clickhouse` otherwise). `provider_key` optionally pins the budget to one model provider. `cycle_anchor_at` optionally phases the window off a chosen instant instead of the calendar, for budgets that have to line up with a billing date. A `team`, `project` or `group` budget that none of the organization's active keys can produce traffic for is refused with `gateway_budget_scope_unreachable`, since it would never spend and never block; send `allow_unreachable` to keep it anyway, and note that an organization with no active keys is never refused. Send `Idempotency-Key` to make a retry safe.
          */
         post: operations["postApiGatewayV1Budgets"];
         delete?: never;
@@ -3470,7 +3470,7 @@ interface paths {
         };
         /**
          * Read one end user's spend
-         * @description Windowed spend rollup for one external end user across the organization (the /customer/info-style read a rebilling integration polls). `cap` is the applicable attributed-user budget cap and its remaining headroom once such a budget template applies; null until then.
+         * @description Windowed spend rollup for one external end user across the organization (the /customer/info-style read a rebilling integration polls). `caps` lists every attributed-user budget that applies to this end user, each with its limit and the spend against it. It is an empty array until such a budget template applies, never null.
          */
         get: operations["getApiGatewayV1End-usersByIdSpend"];
         put?: never;
@@ -9349,6 +9349,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -9597,6 +9602,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -9752,6 +9762,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -10012,6 +10027,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -10300,6 +10320,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -10442,6 +10467,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -10576,6 +10606,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -10710,6 +10745,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -11095,6 +11135,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         }[];
                         spend_available: boolean;
                         /** @description Pass back as `cursor` for the next page. Null means the walk is exhausted; a full page does NOT mean there is more. */
@@ -11245,6 +11290,8 @@ interface operations {
                      * @description Phases the budget's cycle off this instant instead of the calendar, so a `month` budget anchored 2026-01-17T09:00:00Z starts a fresh period every 17th at 09:00 UTC. Omit for calendar alignment, which is the default and unchanged behaviour. A month cycle anchored past the 28th clamps into shorter months and springs back: anchored on the 31st gives Feb 28, then Mar 31. Immutable after create, since moving it would redraw periods the budget has already reported and enforced on. Rejected with `gateway_budget_cycle_anchor_invalid` on `total` and `manual`, which do not cycle.
                      */
                     cycle_anchor_at?: string;
+                    /** @description Keeps a `team`, `project` or `group` budget that no active key can produce traffic for, which is otherwise refused with `gateway_budget_scope_unreachable`. Send it to provision ahead of the keys that will use the budget. An organization with no active keys is never refused, so this is not needed during first setup. */
+                    allow_unreachable?: boolean;
                 };
             };
         };
@@ -11296,6 +11343,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         };
                     };
                 };
@@ -11458,6 +11510,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         };
                         spend_available: boolean;
                     };
@@ -11621,6 +11678,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         };
                     };
                 };
@@ -11778,6 +11840,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         };
                     };
                 };
@@ -11929,6 +11996,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         };
                     };
                 };

package/dist/{types-ruthADbq.d.mts → types-NCH43GuW.d.mts}

@@ -2088,7 +2088,7 @@ interface paths {
         put?: never;
         /**
          * Create virtual key
-         * @description Mints a new virtual key and returns the secret exactly once. The caller MUST persist the `secret` value, because LangWatch stores only a hash. `scopes` defaults to the caller's project; org- and team-scoped keys require a scoped API key holding `virtualKeys:manage` at each requested scope. An org- or team-scoped key also needs a place for its traces and spend to land: pass `trace_project_id` (needs `virtualKeys:manage` on that project), or the organization's governance project is used, and creation refuses with `trace_project_required` when neither exists. Send `Idempotency-Key` to make a retry safe: a replay returns the original response including its `secret`, which is the only way to recover a secret whose response was lost in transit.
+         * @description Mints a new virtual key and returns the secret exactly once. The caller MUST persist the `secret` value, because LangWatch stores only a hash. `scopes` defaults to the caller's project; org- and team-scoped keys require a scoped API key holding `virtualKeys:manage` at each requested scope. An org- or team-scoped key also needs a place for its traces and spend to land, and must say where: pass `trace_project_id` (needs `virtualKeys:manage` on that project). Without it, and without exactly one project scope to take it from, creation refuses with `gateway_trace_project_ambiguous`, because the spend would be attributed to the organization's hidden governance project and counted by no budget on the project you had in mind. An organization whose only project is the governance one is exempt, since there is nothing else to name; one with no governance project either refuses with `trace_project_required`. Send `Idempotency-Key` to make a retry safe: a replay returns the original response including its `secret`, which is the only way to recover a secret whose response was lost in transit.
          */
         post: operations["postApiGatewayV1Virtual-keys"];
         delete?: never;
@@ -2257,7 +2257,7 @@ interface paths {
         put?: never;
         /**
          * Create budget
-         * @description Creates an organization-owned budget. The scope discriminates which resource the budget covers (organization / team / project / virtual_key / principal / group). `group` budgets are per-member allowances and require a deployment with the ClickHouse spend ledger (`group_budget_requires_clickhouse` otherwise). `provider_key` optionally pins the budget to one model provider. `cycle_anchor_at` optionally phases the window off a chosen instant instead of the calendar, for budgets that have to line up with a billing date. Send `Idempotency-Key` to make a retry safe.
+         * @description Creates an organization-owned budget. The scope discriminates which resource the budget covers, across all seven scope types (organization / team / project / virtual_key / principal / group / attributed_user). `group` budgets are per-member allowances and `attributed_user` budgets are per-end-user templates; both require a deployment with the ClickHouse spend ledger (`group_budget_requires_clickhouse` otherwise). `provider_key` optionally pins the budget to one model provider. `cycle_anchor_at` optionally phases the window off a chosen instant instead of the calendar, for budgets that have to line up with a billing date. A `team`, `project` or `group` budget that none of the organization's active keys can produce traffic for is refused with `gateway_budget_scope_unreachable`, since it would never spend and never block; send `allow_unreachable` to keep it anyway, and note that an organization with no active keys is never refused. Send `Idempotency-Key` to make a retry safe.
          */
         post: operations["postApiGatewayV1Budgets"];
         delete?: never;
@@ -3470,7 +3470,7 @@ interface paths {
         };
         /**
          * Read one end user's spend
-         * @description Windowed spend rollup for one external end user across the organization (the /customer/info-style read a rebilling integration polls). `cap` is the applicable attributed-user budget cap and its remaining headroom once such a budget template applies; null until then.
+         * @description Windowed spend rollup for one external end user across the organization (the /customer/info-style read a rebilling integration polls). `caps` lists every attributed-user budget that applies to this end user, each with its limit and the spend against it. It is an empty array until such a budget template applies, never null.
          */
         get: operations["getApiGatewayV1End-usersByIdSpend"];
         put?: never;
@@ -9349,6 +9349,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -9597,6 +9602,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -9752,6 +9762,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -10012,6 +10027,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -10300,6 +10320,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -10442,6 +10467,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -10576,6 +10606,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -10710,6 +10745,11 @@ interface operations {
                             display_prefix: string;
                             principal_user_id: string | null;
                             trace_project_id: string | null;
+                            /**
+                             * @description Which rule puts this key's traces and costs where they go: `explicit` is the `trace_project_id` on the key, `project_scope` is its single project scope, and `governance_fallback` means the key names no destination and its spend is attributed to the organization's hidden governance project. Only the first two name a project the key itself chose, so a `governance_fallback` key is counted by no project budget a reader would think to look at. New keys can no longer be written in that shape.
+                             * @enum {string}
+                             */
+                            trace_project_source: "explicit" | "project_scope" | "governance_fallback";
                             external_id: string | null;
                             metadata: {
                                 [key: string]: string;
@@ -11095,6 +11135,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         }[];
                         spend_available: boolean;
                         /** @description Pass back as `cursor` for the next page. Null means the walk is exhausted; a full page does NOT mean there is more. */
@@ -11245,6 +11290,8 @@ interface operations {
                      * @description Phases the budget's cycle off this instant instead of the calendar, so a `month` budget anchored 2026-01-17T09:00:00Z starts a fresh period every 17th at 09:00 UTC. Omit for calendar alignment, which is the default and unchanged behaviour. A month cycle anchored past the 28th clamps into shorter months and springs back: anchored on the 31st gives Feb 28, then Mar 31. Immutable after create, since moving it would redraw periods the budget has already reported and enforced on. Rejected with `gateway_budget_cycle_anchor_invalid` on `total` and `manual`, which do not cycle.
                      */
                     cycle_anchor_at?: string;
+                    /** @description Keeps a `team`, `project` or `group` budget that no active key can produce traffic for, which is otherwise refused with `gateway_budget_scope_unreachable`. Send it to provision ahead of the keys that will use the budget. An organization with no active keys is never refused, so this is not needed during first setup. */
+                    allow_unreachable?: boolean;
                 };
             };
         };
@@ -11296,6 +11343,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         };
                     };
                 };
@@ -11458,6 +11510,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         };
                         spend_available: boolean;
                     };
@@ -11621,6 +11678,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         };
                     };
                 };
@@ -11778,6 +11840,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         };
                     };
                 };
@@ -11929,6 +11996,11 @@ interface operations {
                             member_count?: number;
                             end_users_seen?: number;
                             end_users_over?: number;
+                            /**
+                             * @description Whether any active key in the organization can produce traffic this budget matches. `unreachable` means it will never accrue and never block as configured: scope a key to its target, or move the budget where the keys already run. This is the only field that tells a budget nothing can reach apart from one that simply has not been breached.
+                             * @enum {string}
+                             */
+                            scope_reach?: "reachable" | "unreachable";
                         };
                     };
                 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "langwatch",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "LangWatch TypeScript/JavaScript SDK. Interact with the full LangWatch API and use the LangWatch OpenTelemetry SDK to instrument your application. For more information, see https://docs.langwatch.ai/integration/typescript/guide",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -15,6 +15,7 @@
     "dist",
     "!dist/bin",
     "!dist/cli/*.map",
+    "!dist/plugin",
     "README.md",
     "LICENSE"
   ],
@@ -99,6 +100,7 @@
     "commander": "^15.0.0",
     "dotenv": "^17.3.1",
     "js-yaml": "^5.2.0",
+    "jsonc-parser": "^3.3.1",
     "liquidjs": "^10.27.0",
     "open": "^11.0.0",
     "openapi-fetch": "^0.17.0",
@@ -158,6 +160,7 @@
     "build": "tsc --noEmit && rm -rf dist && tsup",
     "postbuild": "node -e \"const{statSync}=require('node:fs'),{execFileSync}=require('node:child_process');const f='dist/cli/index.js',want=require('./package.json').version;const s=statSync(f);if(process.platform!=='win32'&&!(s.mode&0o111))throw new Error(f+' is not executable');const got=execFileSync(process.execPath,[f,'--version'],{encoding:'utf8',env:{...process.env,LANGWATCH_NO_DAEMON:'1'}}).trim();if(got!==want)throw new Error('version mismatch: '+f+' reports '+got+', package.json says '+want);console.log('postbuild: '+f+' ok ('+got+')')\"",
     "build:binary": "bun run scripts/build-cli-binary.ts",
+    "build:plugin-hook": "tsup --config tsup.plugin-hook.config.ts",
     "tarball": "pnpm build && pnpm pack",
     "typecheck": "tsc --noEmit",
     "prepublish": "pnpm run build",