@budgetary/sdk - npm Package Compare versions

Comparing version 0.7.2 to 0.8.0

dist/cjs/index.d.ts

@@ -6,5 +6,5 @@ export { BudgetaryClient } from "./client.js";
 export type { BudgetaryNetworkErrorCode } from "./errors.js";
-export { normalizeScenario } from "./types.js";
-export type { Scenario, Distribution, EstimateContext, EstimateRequest, EstimateResponse, ActualsMetadata, ActualsTraceStep, ActualsRequest, ActualsResponse, PhaseSlice, Phases, AssessmentVerdict, EfficiencyLabel, Efficiency, Assessment, ConversionVerdict, LedgerConversion, ResolutionVerdict, LedgerResolution, LedgerAssessment, LedgerQuery, LedgerPage, LedgerEntry, LedgerActual, LedgerPredicted, } from "./types.js";
+export { normalizeScenario, CENSORING_CATEGORIES } from "./types.js";
+export type { Scenario, Distribution, EstimateContext, EstimateRequest, EstimateResponse, ActualsMetadata, ActualsTraceStep, ActualsRequest, ActualsResponse, CensoringCategory, PhaseSlice, Phases, AssessmentVerdict, EfficiencyLabel, Efficiency, Assessment, ConversionVerdict, LedgerConversion, ResolutionVerdict, LedgerResolution, LedgerAssessment, LedgerQuery, LedgerPage, LedgerEntry, LedgerActual, LedgerPredicted, } from "./types.js";
 export { DEFAULT_BASE_URL, budgetaryDir, configFilePath, resolveConfig, resolveConfigStatus, } from "./config.js";
 export type { ConfigStatus, ResolvedConfig } from "./config.js";

dist/cjs/index.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveConfigStatus = exports.resolveConfig = exports.configFilePath = exports.budgetaryDir = exports.DEFAULT_BASE_URL = exports.normalizeScenario = exports.BudgetaryNetworkError = exports.BudgetaryServerError = exports.BudgetaryValidationError = exports.BudgetaryNotFoundError = exports.BudgetaryRateLimitError = exports.BudgetaryPermissionError = exports.BudgetaryAuthError = exports.BudgetaryError = exports.BudgetaryClient = void 0;
+exports.resolveConfigStatus = exports.resolveConfig = exports.configFilePath = exports.budgetaryDir = exports.DEFAULT_BASE_URL = exports.CENSORING_CATEGORIES = exports.normalizeScenario = exports.BudgetaryNetworkError = exports.BudgetaryServerError = exports.BudgetaryValidationError = exports.BudgetaryNotFoundError = exports.BudgetaryRateLimitError = exports.BudgetaryPermissionError = exports.BudgetaryAuthError = exports.BudgetaryError = exports.BudgetaryClient = void 0;
 var client_js_1 = require("./client.js");
@@ -17,2 +17,3 @@ Object.defineProperty(exports, "BudgetaryClient", { enumerable: true, get: function () { return client_js_1.BudgetaryClient; } });
 Object.defineProperty(exports, "normalizeScenario", { enumerable: true, get: function () { return types_js_1.normalizeScenario; } });
+Object.defineProperty(exports, "CENSORING_CATEGORIES", { enumerable: true, get: function () { return types_js_1.CENSORING_CATEGORIES; } });
 var config_js_1 = require("./config.js");
@@ -19,0 +20,0 @@ Object.defineProperty(exports, "DEFAULT_BASE_URL", { enumerable: true, get: function () { return config_js_1.DEFAULT_BASE_URL; } });

dist/cjs/index.js.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AAOxB,yCASqB;AARnB,2GAAA,cAAc,OAAA;AACd,+GAAA,kBAAkB,OAAA;AAClB,qHAAA,wBAAwB,OAAA;AACxB,oHAAA,uBAAuB,OAAA;AACvB,mHAAA,sBAAsB,OAAA;AACtB,qHAAA,wBAAwB,OAAA;AACxB,iHAAA,oBAAoB,OAAA;AACpB,kHAAA,qBAAqB,OAAA;AAIvB,uCAA+C;AAAtC,6GAAA,iBAAiB,OAAA;AA6B1B,yCAMqB;AALnB,6GAAA,gBAAgB,OAAA;AAChB,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA;AACb,gHAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA8C;AAArC,4GAAA,eAAe,OAAA;AAOxB,yCASqB;AARnB,2GAAA,cAAc,OAAA;AACd,+GAAA,kBAAkB,OAAA;AAClB,qHAAA,wBAAwB,OAAA;AACxB,oHAAA,uBAAuB,OAAA;AACvB,mHAAA,sBAAsB,OAAA;AACtB,qHAAA,wBAAwB,OAAA;AACxB,iHAAA,oBAAoB,OAAA;AACpB,kHAAA,qBAAqB,OAAA;AAIvB,uCAAqE;AAA5D,6GAAA,iBAAiB,OAAA;AAAE,gHAAA,oBAAoB,OAAA;AA8BhD,yCAMqB;AALnB,6GAAA,gBAAgB,OAAA;AAChB,yGAAA,YAAY,OAAA;AACZ,2GAAA,cAAc,OAAA;AACd,0GAAA,aAAa,OAAA;AACb,gHAAA,mBAAmB,OAAA"}

dist/cjs/types.d.ts

@@ -83,2 +83,22 @@ /**
 /**
+ * The closed run-termination vocabulary for {@link ActualsRequest.censoring}
+ * (contract §4.2) — **how the run ended**, as a category:
+ *
+ * - `natural` — the run ended on its own; no cap was reached.
+ * - `harness_watchdog` — a wall-clock watchdog in the calling harness killed it.
+ * - `operative_cap` — a cap inside the agent host fired (max turns, context
+ *   exhaustion, a declared token budget).
+ * - `kill_switch` — a human or an automation deliberately aborted it.
+ *
+ * The server matches these **exactly** — no case folding, no trimming, no
+ * aliasing — and drops anything else to `null` (unknown) without failing the
+ * call. A caller does the same: forward a value from this set verbatim, or omit
+ * the field entirely. **Never default to `natural`** — an unobserved ending
+ * recorded as a normal completion is an affirmative false claim, and an absent
+ * field is the honest record that nothing observed how the run ended.
+ */
+export declare const CENSORING_CATEGORIES: readonly ["natural", "harness_watchdog", "operative_cap", "kill_switch"];
+/** A member of the closed {@link CENSORING_CATEGORIES} vocabulary. */
+export type CensoringCategory = (typeof CENSORING_CATEGORIES)[number];
+/**
  * One measured step of a run's execution trace. The `tokens` count is realized
@@ -138,2 +158,15 @@ * usage on the same cache-read-excluded basis as {@link ActualsRequest.tokensIn}
     trace?: ActualsTraceStep[];
+    /**
+     * Optional run-termination category (contract §4.2): how the run **ended**,
+     * from the closed four-member {@link CENSORING_CATEGORIES} vocabulary. It is
+     * measured harness- or client-side — a host's or harness's own termination
+     * fact, the same class of measurement as the token counts — and **never
+     * model-supplied**: a model's account of its own truncation is not a
+     * measurement. Omit rather than guess: an absent field stores `null`
+     * (unknown), which is the honest record when nothing observed the ending;
+     * `natural` is an affirmative claim, never a default. ⚠️ The server stores
+     * only the **first** submission's value for an `estimate_id` — a replay's
+     * `censoring` is silently discarded — so it must ride the first submit.
+     */
+    censoring?: CensoringCategory;
     metadata?: ActualsMetadata;
@@ -140,0 +173,0 @@ }

dist/cjs/types.js

 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.CENSORING_CATEGORIES = void 0;
 exports.normalizeScenario = normalizeScenario;
@@ -20,2 +21,25 @@ /**
 }
+/**
+ * The closed run-termination vocabulary for {@link ActualsRequest.censoring}
+ * (contract §4.2) — **how the run ended**, as a category:
+ *
+ * - `natural` — the run ended on its own; no cap was reached.
+ * - `harness_watchdog` — a wall-clock watchdog in the calling harness killed it.
+ * - `operative_cap` — a cap inside the agent host fired (max turns, context
+ *   exhaustion, a declared token budget).
+ * - `kill_switch` — a human or an automation deliberately aborted it.
+ *
+ * The server matches these **exactly** — no case folding, no trimming, no
+ * aliasing — and drops anything else to `null` (unknown) without failing the
+ * call. A caller does the same: forward a value from this set verbatim, or omit
+ * the field entirely. **Never default to `natural`** — an unobserved ending
+ * recorded as a normal completion is an affirmative false claim, and an absent
+ * field is the honest record that nothing observed how the run ended.
+ */
+exports.CENSORING_CATEGORIES = [
+    "natural",
+    "harness_watchdog",
+    "operative_cap",
+    "kill_switch",
+];
 //# sourceMappingURL=types.js.map

dist/cjs/types.js.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;AAeA,8CAUC;AAfD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe;YAClB,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";;;AAeA,8CAUC;AAfD;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,QAAgB;IAChD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe;YAClB,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC;AA6ED;;;;;;;;;;;;;;;;GAgBG;AACU,QAAA,oBAAoB,GAAG;IAClC,SAAS;IACT,kBAAkB;IAClB,eAAe;IACf,aAAa;CACL,CAAC"}

dist/index.d.ts

@@ -6,6 +6,6 @@ export { BudgetaryClient } from "./client.js";
 export type { BudgetaryNetworkErrorCode } from "./errors.js";
-export { normalizeScenario } from "./types.js";
-export type { Scenario, Distribution, EstimateContext, EstimateRequest, EstimateResponse, ActualsMetadata, ActualsTraceStep, ActualsRequest, ActualsResponse, PhaseSlice, Phases, AssessmentVerdict, EfficiencyLabel, Efficiency, Assessment, ConversionVerdict, LedgerConversion, ResolutionVerdict, LedgerResolution, LedgerAssessment, LedgerQuery, LedgerPage, LedgerEntry, LedgerActual, LedgerPredicted, } from "./types.js";
+export { normalizeScenario, CENSORING_CATEGORIES } from "./types.js";
+export type { Scenario, Distribution, EstimateContext, EstimateRequest, EstimateResponse, ActualsMetadata, ActualsTraceStep, ActualsRequest, ActualsResponse, CensoringCategory, PhaseSlice, Phases, AssessmentVerdict, EfficiencyLabel, Efficiency, Assessment, ConversionVerdict, LedgerConversion, ResolutionVerdict, LedgerResolution, LedgerAssessment, LedgerQuery, LedgerPage, LedgerEntry, LedgerActual, LedgerPredicted, } from "./types.js";
 export { DEFAULT_BASE_URL, budgetaryDir, configFilePath, resolveConfig, resolveConfigStatus, } from "./config.js";
 export type { ConfigStatus, ResolvedConfig } from "./config.js";
 //# sourceMappingURL=index.d.ts.map

dist/index.d.ts.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACV,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EACV,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AACrE,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

dist/index.js

 export { BudgetaryClient } from "./client.js";
 export { BudgetaryError, BudgetaryAuthError, BudgetaryPermissionError, BudgetaryRateLimitError, BudgetaryNotFoundError, BudgetaryValidationError, BudgetaryServerError, BudgetaryNetworkError, } from "./errors.js";
-export { normalizeScenario } from "./types.js";
+export { normalizeScenario, CENSORING_CATEGORIES } from "./types.js";
 export { DEFAULT_BASE_URL, budgetaryDir, configFilePath, resolveConfig, resolveConfigStatus, } from "./config.js";
 //# sourceMappingURL=index.js.map

dist/index.js.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO9C,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA6B/C,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAO9C,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA8BrE,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,MAAM,aAAa,CAAC"}

dist/types.d.ts

@@ -83,2 +83,22 @@ /**
 /**
+ * The closed run-termination vocabulary for {@link ActualsRequest.censoring}
+ * (contract §4.2) — **how the run ended**, as a category:
+ *
+ * - `natural` — the run ended on its own; no cap was reached.
+ * - `harness_watchdog` — a wall-clock watchdog in the calling harness killed it.
+ * - `operative_cap` — a cap inside the agent host fired (max turns, context
+ *   exhaustion, a declared token budget).
+ * - `kill_switch` — a human or an automation deliberately aborted it.
+ *
+ * The server matches these **exactly** — no case folding, no trimming, no
+ * aliasing — and drops anything else to `null` (unknown) without failing the
+ * call. A caller does the same: forward a value from this set verbatim, or omit
+ * the field entirely. **Never default to `natural`** — an unobserved ending
+ * recorded as a normal completion is an affirmative false claim, and an absent
+ * field is the honest record that nothing observed how the run ended.
+ */
+export declare const CENSORING_CATEGORIES: readonly ["natural", "harness_watchdog", "operative_cap", "kill_switch"];
+/** A member of the closed {@link CENSORING_CATEGORIES} vocabulary. */
+export type CensoringCategory = (typeof CENSORING_CATEGORIES)[number];
+/**
  * One measured step of a run's execution trace. The `tokens` count is realized
@@ -138,2 +158,15 @@ * usage on the same cache-read-excluded basis as {@link ActualsRequest.tokensIn}
     trace?: ActualsTraceStep[];
+    /**
+     * Optional run-termination category (contract §4.2): how the run **ended**,
+     * from the closed four-member {@link CENSORING_CATEGORIES} vocabulary. It is
+     * measured harness- or client-side — a host's or harness's own termination
+     * fact, the same class of measurement as the token counts — and **never
+     * model-supplied**: a model's account of its own truncation is not a
+     * measurement. Omit rather than guess: an absent field stores `null`
+     * (unknown), which is the honest record when nothing observed the ending;
+     * `natural` is an affirmative claim, never a default. ⚠️ The server stores
+     * only the **first** submission's value for an `estimate_id` — a replay's
+     * `censoring` is silently discarded — so it must ride the first submit.
+     */
+    censoring?: CensoringCategory;
     metadata?: ActualsMetadata;
@@ -140,0 +173,0 @@ }

dist/types.d.ts.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

dist/types.js

@@ -17,2 +17,25 @@ /**
 }
+/**
+ * The closed run-termination vocabulary for {@link ActualsRequest.censoring}
+ * (contract §4.2) — **how the run ended**, as a category:
+ *
+ * - `natural` — the run ended on its own; no cap was reached.
+ * - `harness_watchdog` — a wall-clock watchdog in the calling harness killed it.
+ * - `operative_cap` — a cap inside the agent host fired (max turns, context
+ *   exhaustion, a declared token budget).
+ * - `kill_switch` — a human or an automation deliberately aborted it.
+ *
+ * The server matches these **exactly** — no case folding, no trimming, no
+ * aliasing — and drops anything else to `null` (unknown) without failing the
+ * call. A caller does the same: forward a value from this set verbatim, or omit
+ * the field entirely. **Never default to `natural`** — an unobserved ending
+ * recorded as a normal completion is an affirmative false claim, and an absent
+ * field is the honest record that nothing observed how the run ended.
+ */
+export const CENSORING_CATEGORIES = [
+    "natural",
+    "harness_watchdog",
+    "operative_cap",
+    "kill_switch",
+];
 //# sourceMappingURL=types.js.map

dist/types.js.map

@@ -1,1 +0,1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe;YAClB,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAUA;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,WAAW,CAAC;QACjB,KAAK,iBAAiB,CAAC;QACvB,KAAK,eAAe;YAClB,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,WAAW,CAAC;IACvB,CAAC;AACH,CAAC;AA6ED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,SAAS;IACT,kBAAkB;IAClB,eAAe;IACf,aAAa;CACL,CAAC"}

package.json

 {
   "name": "@budgetary/sdk",
-  "version": "0.7.2",
+  "version": "0.8.0",
   "description": "TypeScript SDK for the Budgetary API.",
@@ -5,0 +5,0 @@ "license": "Apache-2.0",

New alerts

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Fixed alerts

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Improved metrics

Total package byte prevSize

239220

3.06%

Lines of code

3534

3.33%

No dependency changes