@atlanai/sdk 0.2.3 → 0.2.4

package/dist/index.d.ts

@@ -6,8 +6,8 @@ export type { ResourceMap, ResourceRoots } from "./resource-types";
 export { AtlanAPIError } from "./errors";
 export { operationManifest, operations } from "./operations";
 export type { Operation, OperationManifest, ServiceContract } from "./operations";
-export { CONTEXT_MANIFEST_SCHEMA, Eval, EvalRun, createContextManifest, resolveDataset, startExperiment, } from "./evals";
-export type { ContextItem, ContextManifest, ContextManifestItem, EvalCase, EvalCaseResult, EvalData, EvalHooks, EvalOptions, EvalResultWithSummary, EvalScorer, EvalScorerArgs, EvalScorerReturn, EvalSummary, EvalTraceLogger, EvalTraceSpan, Evaluator, ScoreValue, StartExperimentOptions, } from "./evals";
+export { CONTEXT_MANIFEST_SCHEMA, Eval, EvalRun, createContextManifest, experimentTraces, pushDataset, pushRecords, recordExperimentSession, recordName, resolveDataset, startExperiment, verifyExperiment, } from "./evals";
+export type { ContextItem, ContextManifest, ContextManifestItem, DatasetPush, EvalCase, EvalCaseResult, EvalData, EvalHooks, EvalOptions, EvalResultWithSummary, EvalScorer, EvalScorerArgs, EvalScorerReturn, EvalSummary, EvalTraceLogger, EvalTraceSpan, Evaluator, ExperimentTracesOptions, ExperimentVerification, RecordExperimentSessionOptions, RecordPush, ScoreValue, StartExperimentOptions, VerificationCheck, VerifyExperimentOptions, } from "./evals";
 export * as rawAgent from "./raw/agent/index";
 export * as rawAPI from "./raw/api/index";
 export * as rawEval from "./raw/eval/index";

package/dist/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.rawSkill = exports.rawSecret = exports.rawRegistry = exports.rawOTel = exports.rawModel = exports.rawMCP = exports.rawFile = exports.rawEval = exports.rawAPI = exports.rawAgent = exports.startExperiment = exports.resolveDataset = exports.createContextManifest = exports.EvalRun = exports.Eval = exports.CONTEXT_MANIFEST_SCHEMA = exports.operations = exports.operationManifest = exports.AtlanAPIError = exports.resourceMap = exports.buildResources = exports.createService = exports.ServiceNamespace = exports.AtlanClient = void 0;
+exports.rawSkill = exports.rawSecret = exports.rawRegistry = exports.rawOTel = exports.rawModel = exports.rawMCP = exports.rawFile = exports.rawEval = exports.rawAPI = exports.rawAgent = exports.verifyExperiment = exports.startExperiment = exports.resolveDataset = exports.recordName = exports.recordExperimentSession = exports.pushRecords = exports.pushDataset = exports.experimentTraces = exports.createContextManifest = exports.EvalRun = exports.Eval = exports.CONTEXT_MANIFEST_SCHEMA = exports.operations = exports.operationManifest = exports.AtlanAPIError = exports.resourceMap = exports.buildResources = exports.createService = exports.ServiceNamespace = exports.AtlanClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "AtlanClient", { enumerable: true, get: function () { return client_1.AtlanClient; } });
 Object.defineProperty(exports, "ServiceNamespace", { enumerable: true, get: function () { return client_1.ServiceNamespace; } });
@@ -51,8 +51,14 @@ Object.defineProperty(exports, "CONTEXT_MANIFEST_SCHEMA", { enumerable: true, ge
 Object.defineProperty(exports, "Eval", { enumerable: true, get: function () { return evals_1.Eval; } });
 Object.defineProperty(exports, "EvalRun", { enumerable: true, get: function () { return evals_1.EvalRun; } });
 Object.defineProperty(exports, "createContextManifest", { enumerable: true, get: function () { return evals_1.createContextManifest; } });
+Object.defineProperty(exports, "experimentTraces", { enumerable: true, get: function () { return evals_1.experimentTraces; } });
+Object.defineProperty(exports, "pushDataset", { enumerable: true, get: function () { return evals_1.pushDataset; } });
+Object.defineProperty(exports, "pushRecords", { enumerable: true, get: function () { return evals_1.pushRecords; } });
+Object.defineProperty(exports, "recordExperimentSession", { enumerable: true, get: function () { return evals_1.recordExperimentSession; } });
+Object.defineProperty(exports, "recordName", { enumerable: true, get: function () { return evals_1.recordName; } });
 Object.defineProperty(exports, "resolveDataset", { enumerable: true, get: function () { return evals_1.resolveDataset; } });
 Object.defineProperty(exports, "startExperiment", { enumerable: true, get: function () { return evals_1.startExperiment; } });
+Object.defineProperty(exports, "verifyExperiment", { enumerable: true, get: function () { return evals_1.verifyExperiment; } });
 exports.rawAgent = __importStar(require("./raw/agent/index"));
 exports.rawAPI = __importStar(require("./raw/api/index"));
 exports.rawEval = __importStar(require("./raw/eval/index"));

package/dist/resources.d.ts

@@ -60,6 +60,16 @@ export interface Resource {
     readonly operations: Readonly<Record<string, string>>;
     readonly [member: string]: ResourceOperation | Resource | string | Readonly<Record<string, string>>;
 }
+/**
+ * Refuse to return a bulk write that achieved nothing as a success.
+ *
+ * A bulk endpoint answers 207: each slot carries its own status, and partial
+ * success is the point, so one failed slot is the caller's business and is
+ * left alone. A batch where no slot succeeded is different. It changed
+ * nothing, it is never what the caller wanted, and returning it as an ordinary
+ * value is how a whole dataset ends up silently empty.
+ */
+export declare function raiseIfNothingSucceeded(result: unknown): void;
 /**
  * Build the top-level resources, nesting children under their parents.
  *

package/dist/resources.js

@@ -17,8 +17,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resourceMap = void 0;
+exports.raiseIfNothingSucceeded = raiseIfNothingSucceeded;
 exports.buildResources = buildResources;
 const resources_json_1 = __importDefault(require("./resources.json"));
+const errors_1 = require("./errors");
 const SCHEMA_VERSION = 1;
 exports.resourceMap = resources_json_1.default;
 if (exports.resourceMap.schema_version !== SCHEMA_VERSION) {
@@ -49,6 +51,53 @@ function isPlainObject(value) {
  * guessed: a lone object argument carrying any of the expected property names
  * is passed straight through.
  */
+/** The per-item status on a multi-status slot, if this is one. */
+function slotStatus(item) {
+    if (!isPlainObject(item))
+        return undefined;
+    const status = item.statusCode ?? item.status_code;
+    return typeof status === "number" ? status : undefined;
+}
+/**
+ * Refuse to return a bulk write that achieved nothing as a success.
+ *
+ * A bulk endpoint answers 207: each slot carries its own status, and partial
+ * success is the point, so one failed slot is the caller's business and is
+ * left alone. A batch where no slot succeeded is different. It changed
+ * nothing, it is never what the caller wanted, and returning it as an ordinary
+ * value is how a whole dataset ends up silently empty.
+ */
+function raiseIfNothingSucceeded(result) {
+    const items = isPlainObject(result) ? result.items : undefined;
+    if (!Array.isArray(items) || items.length === 0)
+        return;
+    const statuses = items.map(slotStatus);
+    // Only a multi-status envelope: every slot has to carry its own status.
+    if (statuses.some((status) => status === undefined))
+        return;
+    if (statuses.some((status) => status !== undefined && status >= 200 && status < 300))
+        return;
+    const codes = [...new Set(statuses.map(String))].sort();
+    const explanation = `none of the ${items.length} items in this batch was accepted ` +
+        `(per-item status: ${codes.join(", ")}); read items[].error for why`;
+    throw new errors_1.AtlanAPIError({
+        status: statuses[0] ?? 207,
+        code: "bulk_all_rejected",
+        title: "Every item in the batch was rejected",
+        detail: explanation,
+        // As a hint, not a detail: this text is client-authored, so the rule
+        // keeping server prose out of the message does not apply.
+        hint: explanation,
+    });
+}
+/** Wrap an operation so a batch that achieved nothing cannot return quietly. */
+function guarded(operation) {
+    return (async (...args) => {
+        const result = await operation(...args);
+        raiseIfNothingSucceeded(result);
+        return result;
+    });
+}
 function positionalCall(forwarded, detail, workspace) {
     const bodyKey = detail.typescript_body;
     const pathKeys = [...detail.route.matchAll(/\{(\w+)\}/g)].map((match) => camelCase(match[1]));
@@ -56,11 +105,12 @@ function positionalCall(forwarded, detail, workspace) {
     // alone let `get(agentId)` pass a bare string where the generated client
     // wanted an object: no error, and the wrong resource fetched.
     const workspaceKey = detail.workspace_parameter?.typescript;
-    if (bodyKey === undefined && pathKeys.length === 0 && workspaceKey === undefined)
-        return forwarded;
+    if (bodyKey === undefined && pathKeys.length === 0 && workspaceKey === undefined) {
+        return guarded(forwarded);
+    }
     const arity = pathKeys.length + (bodyKey === undefined ? 0 : 1);
     const expected = new Set(bodyKey === undefined ? pathKeys : [...pathKeys, bodyKey]);
-    return ((...args) => {
+    return guarded(((...args) => {
         const values = args;
         if (values.length === 1 && isPlainObject(values[0])) {
             const keys = Object.keys(values[0]);
@@ -81,7 +131,7 @@ function positionalCall(forwarded, detail, workspace) {
         if (workspaceKey !== undefined && workspace !== undefined)
             options[workspaceKey] = workspace;
         return forwarded(options);
-    });
+    }));
 }
 function buildResource(path, entry, service, children, workspace) {
     const operations = {};

package/dist/tracing/version.d.ts

@@ -1,4 +1,4 @@
 /** SDK identity (SPEC §2.2, §5.1). Kept in sync with package.json — the
  * version test fails the build on drift. */
 export declare const SDK_LANGUAGE = "typescript";
-export declare const SDK_VERSION = "0.2.3";
+export declare const SDK_VERSION = "0.2.4";

package/dist/tracing/version.js

@@ -4,4 +4,4 @@ exports.SDK_VERSION = exports.SDK_LANGUAGE = void 0;
 /** SDK identity (SPEC §2.2, §5.1). Kept in sync with package.json — the
  * version test fails the build on drift. */
 exports.SDK_LANGUAGE = "typescript";
-exports.SDK_VERSION = "0.2.3";
+exports.SDK_VERSION = "0.2.4";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlanai/sdk",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Atlan Agent Gateway management SDK",
   "type": "commonjs",
   "main": "./dist/index.js",