@atlanai/sdk 0.2.1 → 0.2.3

package/dist/tracing/integrations.js

@@ -0,0 +1,95 @@
+"use strict";
+/** Framework integration helpers that reuse the Atlan OpenTelemetry pipeline. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aiTelemetry = aiTelemetry;
+exports.wrapAISDK = wrapAISDK;
+const compat_js_1 = require("./compat.js");
+const client_js_1 = require("./client.js");
+/**
+ * Build the native `experimental_telemetry` value used by Vercel AI SDK v3-v6.
+ * No Vercel dependency or vendor wrapper is required.
+ */
+function aiTelemetry(options = {}) {
+    const client = options.logger?.client ?? (0, compat_js_1.currentLogger)()?.client ?? (0, client_js_1.getClient)();
+    return {
+        isEnabled: true,
+        tracer: client.tracerProvider?.getTracer("ai") ?? client.getTracer(),
+        ...(options.functionId === undefined ? {} : { functionId: options.functionId }),
+        ...(options.metadata === undefined ? {} : { metadata: options.metadata }),
+        ...(options.recordInputs === undefined ? {} : { recordInputs: options.recordInputs }),
+        ...(options.recordOutputs === undefined ? {} : { recordOutputs: options.recordOutputs }),
+    };
+}
+const AI_SDK_CALLS = new Set([
+    "embed",
+    "embedMany",
+    "generateObject",
+    "generateText",
+    "rerank",
+    "streamObject",
+    "streamText",
+]);
+const AI_SDK_AGENTS = new Set(["Agent", "Experimental_Agent", "ToolLoopAgent"]);
+function withTelemetry(input, options) {
+    const call = typeof input === "object" && input !== null && !Array.isArray(input)
+        ? input
+        : {};
+    const existing = typeof call.experimental_telemetry === "object" && call.experimental_telemetry !== null
+        ? call.experimental_telemetry
+        : {};
+    const generated = aiTelemetry(options);
+    const existingMetadata = typeof existing.metadata === "object" && existing.metadata !== null
+        ? existing.metadata
+        : {};
+    const metadata = { ...(options.metadata ?? {}), ...existingMetadata };
+    const tracer = options.replaceTracer === true || existing.tracer === undefined
+        ? generated.tracer
+        : existing.tracer;
+    return {
+        ...call,
+        experimental_telemetry: {
+            ...generated,
+            ...existing,
+            tracer,
+            ...(Object.keys(metadata).length === 0 ? {} : { metadata }),
+            isEnabled: true,
+        },
+    };
+}
+/**
+ * Braintrust-shaped Vercel AI SDK wrapper.
+ *
+ * Known generation/embedding functions and agent constructors receive native
+ * `experimental_telemetry`; all other exports pass through untouched. The
+ * returned proxy preserves the original namespace's types and lazy getters.
+ */
+function wrapAISDK(sdk, options = {}) {
+    const wrapped = new Map();
+    return new Proxy(sdk, {
+        get(target, property, receiver) {
+            const value = Reflect.get(target, property, receiver);
+            if (typeof property !== "string" ||
+                typeof value !== "function" ||
+                (!AI_SDK_CALLS.has(property) && !AI_SDK_AGENTS.has(property))) {
+                return value;
+            }
+            const cached = wrapped.get(property);
+            if (cached !== undefined)
+                return cached;
+            const proxy = new Proxy(value, {
+                apply(callable, thisArg, argumentsList) {
+                    const args = [...argumentsList];
+                    args[0] = withTelemetry(args[0], options);
+                    return Reflect.apply(callable, thisArg, args);
+                },
+                construct(callable, argumentsList, newTarget) {
+                    const args = [...argumentsList];
+                    args[0] = withTelemetry(args[0], options);
+                    return Reflect.construct(callable, args, newTarget);
+                },
+            });
+            wrapped.set(property, proxy);
+            return proxy;
+        },
+    });
+}

package/dist/tracing/propagation.d.ts

@@ -18,6 +18,8 @@ export interface PropagateAttributesOptions {
     userId?: string;
     visitorId?: string;
     experimentId?: string;
+    caseId?: string;
+    datasetRecordId?: string;
     tags?: readonly string[];
     metadata?: Record<string, unknown>;
     traceName?: string;

package/dist/tracing/propagation.js

@@ -57,6 +57,8 @@ const SESSION_ID_KEY = (0, api_1.createContextKey)("atlan.propagated.session_id"
 const USER_ID_KEY = (0, api_1.createContextKey)("atlan.propagated.user_id");
 const VISITOR_ID_KEY = (0, api_1.createContextKey)("atlan.propagated.visitor_id");
 const EXPERIMENT_ID_KEY = (0, api_1.createContextKey)("atlan.propagated.experiment_id");
+const EVAL_CASE_ID_KEY = (0, api_1.createContextKey)("atlan.propagated.eval_case_id");
+const DATASET_RECORD_ID_KEY = (0, api_1.createContextKey)("atlan.propagated.dataset_record_id");
 const TAGS_KEY = (0, api_1.createContextKey)("atlan.propagated.tags");
 const METADATA_KEY = (0, api_1.createContextKey)("atlan.propagated.metadata");
 const TRACE_NAME_KEY = (0, api_1.createContextKey)("atlan.propagated.trace_name");
@@ -127,6 +129,13 @@ function propagatedAttributesFromContext(context, includeContent = true) {
     const experimentId = context.getValue(EXPERIMENT_ID_KEY);
     if (typeof experimentId === "string")
         attributes[sc.ATLAN_EVAL_EXPERIMENT_ID] = experimentId;
+    const caseId = context.getValue(EVAL_CASE_ID_KEY);
+    if (typeof caseId === "string")
+        attributes[sc.ATLAN_EVAL_CASE_ID] = caseId;
+    const datasetRecordId = context.getValue(DATASET_RECORD_ID_KEY);
+    if (typeof datasetRecordId === "string") {
+        attributes[sc.ATLAN_EVAL_DATASET_RECORD_ID] = datasetRecordId;
+    }
     const tags = context.getValue(TAGS_KEY);
     if (Array.isArray(tags) && tags.length > 0)
         attributes[sc.ATLAN_TAGS] = [...tags];
@@ -156,6 +165,13 @@ function propagateAttributes(options, fn) {
     const experimentId = validShortString("experimentId", options.experimentId);
     if (experimentId !== undefined)
         context = context.setValue(EXPERIMENT_ID_KEY, experimentId);
+    const caseId = validShortString("caseId", options.caseId);
+    if (caseId !== undefined)
+        context = context.setValue(EVAL_CASE_ID_KEY, caseId);
+    const datasetRecordId = validShortString("datasetRecordId", options.datasetRecordId);
+    if (datasetRecordId !== undefined) {
+        context = context.setValue(DATASET_RECORD_ID_KEY, datasetRecordId);
+    }
     const newTags = validTags(options.tags);
     if (newTags.length > 0) {
         const existing = context.getValue(TAGS_KEY);

package/dist/tracing/semconv.d.ts

@@ -9,6 +9,10 @@ export type ScoreDataType = (typeof SCORE_DATA_TYPES)[number];
 export declare const ATLAN_COMPLETION_START_TIME = "atlan.completion_start_time";
 export declare const ATLAN_CONSENT_STORE_CONTENT = "atlan.consent.store_content";
 export declare const ATLAN_ENVIRONMENT = "atlan.environment";
+export declare const ATLAN_EVAL_CASE_ID = "atlan.eval.case_id";
+export declare const ATLAN_EVAL_DATASET_RECORD_ID = "atlan.eval.dataset_record_id";
+export declare const ATLAN_EVAL_EVIDENCE_COMPLETE = "atlan.eval.evidence_complete";
+export declare const ATLAN_EVAL_EVIDENCE_TRUNCATED = "atlan.eval.evidence_truncated";
 export declare const ATLAN_EVAL_EXPERIMENT_ID = "atlan.eval.experiment_id";
 export declare const ATLAN_INPUT = "atlan.input";
 export declare const ATLAN_INTERNAL_AS_ROOT = "atlan.internal.as_root";

package/dist/tracing/semconv.js

@@ -3,8 +3,8 @@
 // Regenerate (from the atlanai-sdk-python repo):
 //   python scripts/gen_semconv.py --lang ts --out <path-to>/src/semconv.ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SERVICE_NAME = exports.ORG_NAME = exports.GEN_AI_USAGE_TOTAL_TOKENS = exports.GEN_AI_USAGE_OUTPUT_TOKENS = exports.GEN_AI_USAGE_OUTPUT_COST = exports.GEN_AI_USAGE_INPUT_TOKENS = exports.GEN_AI_USAGE_INPUT_COST = exports.GEN_AI_USAGE_COST = exports.GEN_AI_USAGE_CACHE_READ_INPUT_TOKENS = exports.GEN_AI_USAGE_CACHE_CREATION_INPUT_TOKENS = exports.GEN_AI_TOOL_TYPE = exports.GEN_AI_TOOL_NAME = exports.GEN_AI_TOOL_CALL_RESULT = exports.GEN_AI_TOOL_CALL_ID = exports.GEN_AI_TOOL_CALL_ARGUMENTS = exports.GEN_AI_SYSTEM_INSTRUCTIONS = exports.GEN_AI_RESPONSE_MODEL = exports.GEN_AI_RESPONSE_ID = exports.GEN_AI_REQUEST_MODEL = exports.GEN_AI_PROVIDER_NAME = exports.GEN_AI_OUTPUT_MESSAGES = exports.GEN_AI_INPUT_MESSAGES = exports.ATLAN_VISITOR_ID = exports.ATLAN_TRACE_NAME = exports.ATLAN_TAGS = exports.ATLAN_SPAN_TYPE = exports.ATLAN_SDK_VERSION = exports.ATLAN_SDK_SCHEMA_VERSION = exports.ATLAN_SDK_LANGUAGE = exports.ATLAN_SCORE_VALUE = exports.ATLAN_SCORE_STRING_VALUE = exports.ATLAN_SCORE_SCORER_VERSION = exports.ATLAN_SCORE_SCORER_ID = exports.ATLAN_SCORE_NAME = exports.ATLAN_SCORE_DATA_TYPE = exports.ATLAN_SCORE_COMMENT = exports.ATLAN_OUTPUT = exports.ATLAN_OBSERVATION_STATUS_MESSAGE = exports.ATLAN_OBSERVATION_LEVEL = exports.ATLAN_INTERNAL_AS_ROOT = exports.ATLAN_INPUT = exports.ATLAN_EVAL_EXPERIMENT_ID = exports.ATLAN_ENVIRONMENT = exports.ATLAN_CONSENT_STORE_CONTENT = exports.ATLAN_COMPLETION_START_TIME = exports.SCORE_DATA_TYPES = exports.OBSERVATION_LEVELS = exports.SPAN_TYPE_ALIASES = exports.SPAN_TYPES = exports.SCHEMA_VERSION = void 0;
-exports.GATEWAY_OWNED_RESOURCE_ATTRIBUTES = exports.EVENT_ATTRIBUTE_TYPES = exports.ATLAN_METADATA_PREFIX = exports.PREFIX_ATTRIBUTE_TYPES = exports.CONTENT_ATTRIBUTES = exports.SPAN_ATTRIBUTE_OWNERS = exports.SPAN_ATTRIBUTE_TYPES = exports.RESOURCE_ATTRIBUTE_OWNERS = exports.RESOURCE_ATTRIBUTE_TYPES = exports.USER_ID = exports.USER_EMAIL = exports.SESSION_ID = void 0;
+exports.GEN_AI_USAGE_OUTPUT_COST = exports.GEN_AI_USAGE_INPUT_TOKENS = exports.GEN_AI_USAGE_INPUT_COST = exports.GEN_AI_USAGE_COST = exports.GEN_AI_USAGE_CACHE_READ_INPUT_TOKENS = exports.GEN_AI_USAGE_CACHE_CREATION_INPUT_TOKENS = exports.GEN_AI_TOOL_TYPE = exports.GEN_AI_TOOL_NAME = exports.GEN_AI_TOOL_CALL_RESULT = exports.GEN_AI_TOOL_CALL_ID = exports.GEN_AI_TOOL_CALL_ARGUMENTS = exports.GEN_AI_SYSTEM_INSTRUCTIONS = exports.GEN_AI_RESPONSE_MODEL = exports.GEN_AI_RESPONSE_ID = exports.GEN_AI_REQUEST_MODEL = exports.GEN_AI_PROVIDER_NAME = exports.GEN_AI_OUTPUT_MESSAGES = exports.GEN_AI_INPUT_MESSAGES = exports.ATLAN_VISITOR_ID = exports.ATLAN_TRACE_NAME = exports.ATLAN_TAGS = exports.ATLAN_SPAN_TYPE = exports.ATLAN_SDK_VERSION = exports.ATLAN_SDK_SCHEMA_VERSION = exports.ATLAN_SDK_LANGUAGE = exports.ATLAN_SCORE_VALUE = exports.ATLAN_SCORE_STRING_VALUE = exports.ATLAN_SCORE_SCORER_VERSION = exports.ATLAN_SCORE_SCORER_ID = exports.ATLAN_SCORE_NAME = exports.ATLAN_SCORE_DATA_TYPE = exports.ATLAN_SCORE_COMMENT = exports.ATLAN_OUTPUT = exports.ATLAN_OBSERVATION_STATUS_MESSAGE = exports.ATLAN_OBSERVATION_LEVEL = exports.ATLAN_INTERNAL_AS_ROOT = exports.ATLAN_INPUT = exports.ATLAN_EVAL_EXPERIMENT_ID = exports.ATLAN_EVAL_EVIDENCE_TRUNCATED = exports.ATLAN_EVAL_EVIDENCE_COMPLETE = exports.ATLAN_EVAL_DATASET_RECORD_ID = exports.ATLAN_EVAL_CASE_ID = exports.ATLAN_ENVIRONMENT = exports.ATLAN_CONSENT_STORE_CONTENT = exports.ATLAN_COMPLETION_START_TIME = exports.SCORE_DATA_TYPES = exports.OBSERVATION_LEVELS = exports.SPAN_TYPE_ALIASES = exports.SPAN_TYPES = exports.SCHEMA_VERSION = void 0;
+exports.GATEWAY_OWNED_RESOURCE_ATTRIBUTES = exports.EVENT_ATTRIBUTE_TYPES = exports.ATLAN_METADATA_PREFIX = exports.PREFIX_ATTRIBUTE_TYPES = exports.CONTENT_ATTRIBUTES = exports.SPAN_ATTRIBUTE_OWNERS = exports.SPAN_ATTRIBUTE_TYPES = exports.RESOURCE_ATTRIBUTE_OWNERS = exports.RESOURCE_ATTRIBUTE_TYPES = exports.USER_ID = exports.USER_EMAIL = exports.SESSION_ID = exports.SERVICE_NAME = exports.ORG_NAME = exports.GEN_AI_USAGE_TOTAL_TOKENS = exports.GEN_AI_USAGE_OUTPUT_TOKENS = void 0;
 exports.SCHEMA_VERSION = "agent-sdk.v1";
 exports.SPAN_TYPES = ["task", "llm", "tool", "function", "score", "session", "turn"];
 exports.SPAN_TYPE_ALIASES = {
@@ -17,6 +17,10 @@ exports.SCORE_DATA_TYPES = ["NUMERIC", "CATEGORICAL", "BOOLEAN"];
 exports.ATLAN_COMPLETION_START_TIME = "atlan.completion_start_time";
 exports.ATLAN_CONSENT_STORE_CONTENT = "atlan.consent.store_content";
 exports.ATLAN_ENVIRONMENT = "atlan.environment";
+exports.ATLAN_EVAL_CASE_ID = "atlan.eval.case_id";
+exports.ATLAN_EVAL_DATASET_RECORD_ID = "atlan.eval.dataset_record_id";
+exports.ATLAN_EVAL_EVIDENCE_COMPLETE = "atlan.eval.evidence_complete";
+exports.ATLAN_EVAL_EVIDENCE_TRUNCATED = "atlan.eval.evidence_truncated";
 exports.ATLAN_EVAL_EXPERIMENT_ID = "atlan.eval.experiment_id";
 exports.ATLAN_INPUT = "atlan.input";
 exports.ATLAN_INTERNAL_AS_ROOT = "atlan.internal.as_root";
@@ -95,6 +99,10 @@ exports.SPAN_ATTRIBUTE_TYPES = {
     "user.id": "string",
     "atlan.visitor.id": "string",
     "atlan.eval.experiment_id": "string",
+    "atlan.eval.case_id": "string",
+    "atlan.eval.dataset_record_id": "string",
+    "atlan.eval.evidence_complete": "bool",
+    "atlan.eval.evidence_truncated": "bool",
     "atlan.score.name": "string",
     "atlan.score.value": "double",
     "atlan.score.data_type": "string",
@@ -137,6 +145,10 @@ exports.SPAN_ATTRIBUTE_OWNERS = {
     "user.id": "app",
     "atlan.visitor.id": "app",
     "atlan.eval.experiment_id": "app",
+    "atlan.eval.case_id": "app",
+    "atlan.eval.dataset_record_id": "app",
+    "atlan.eval.evidence_complete": "sdk",
+    "atlan.eval.evidence_truncated": "sdk",
     "atlan.score.name": "app",
     "atlan.score.value": "app",
     "atlan.score.data_type": "app",

package/dist/tracing/spans.d.ts

@@ -54,7 +54,11 @@ export declare class AtlanSpan {
     /** @internal */
     _initialize(asType: string, asRoot: boolean): void;
     private serialize;
+    /** Mark a case root after all task and scorer work has ended. */
+    markEvidenceComplete(): this;
     update(fields: UpdateFields): this;
+    /** Braintrust-compatible spelling for incrementally adding span fields. */
+    log(fields: UpdateFields): this;
     /**
      * Emit a dedicated score child span (SPEC §9.4).
      *
@@ -71,5 +75,7 @@ export declare class AtlanSpan {
     /** Record an exception and mark the span ERROR (SPEC §9.2). */
     recordFailure(error: unknown): void;
     end(endTime?: TimeInput): void;
+    /** Braintrust-compatible spelling for ending a manually managed span. */
+    close(endTime?: TimeInput): void;
 }
 export declare function noopSpan(config: ResolvedConfig): AtlanSpan;

package/dist/tracing/spans.js

@@ -117,7 +117,18 @@ class AtlanSpan {
             this.otel.setAttribute(sc.ATLAN_INTERNAL_AS_ROOT, true);
     }
     serialize(value) {
-        return (0, serialize_js_1.serializePayload)(value, this.config.maxPayloadBytes);
+        const encoded = (0, serialize_js_1.serializePayload)(value, this.config.maxPayloadBytes);
+        if (encoded.endsWith(serialize_js_1.TRUNCATION_SUFFIX) && this.otel.isRecording()) {
+            this.otel.setAttribute(sc.ATLAN_EVAL_EVIDENCE_TRUNCATED, true);
+        }
+        return encoded;
+    }
+    /** Mark a case root after all task and scorer work has ended. */
+    markEvidenceComplete() {
+        if (this.otel.isRecording()) {
+            this.otel.setAttribute(sc.ATLAN_EVAL_EVIDENCE_COMPLETE, true);
+        }
+        return this;
     }
     update(fields) {
         const span = this.otel;
@@ -214,6 +225,10 @@ class AtlanSpan {
         }
         return this;
     }
+    /** Braintrust-compatible spelling for incrementally adding span fields. */
+    log(fields) {
+        return this.update(fields);
+    }
     /**
      * Emit a dedicated score child span (SPEC §9.4).
      *
@@ -314,6 +329,10 @@ class AtlanSpan {
     end(endTime) {
         this.otel.end(endTime);
     }
+    /** Braintrust-compatible spelling for ending a manually managed span. */
+    close(endTime) {
+        this.end(endTime);
+    }
 }
 exports.AtlanSpan = AtlanSpan;
 function noopSpan(config) {

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.1";
+export declare const SDK_VERSION = "0.2.3";

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.1";
+exports.SDK_VERSION = "0.2.3";

package/package.json

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

package/dist/raw/agent/models/Box.d.ts

@@ -1,330 +0,0 @@
-/**
- * Harness and agent catalog
- * A `harness` is a tool a human drives; an `agent` is built with an `agent_framework` and run on an `agent_provider`. The gateway executes neither. This surface is the typed catalog for both — plus the `agent_framework` and `harness_vendor` catalogs, the `agent_provider` substrate, the `agent_environment` sandbox, and the `session`/`session_message` run history — the one agent run-trigger, live session reads (poll + SSE), and the access-controlled trace facade.
- *
- * The version of the OpenAPI document: 0.1.0
- *
- *
- * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
- * https://openapi-generator.tech
- * Do not edit the class manually.
- */
-import type { GatewayArtifactIdentityRevealView } from './GatewayArtifactIdentityRevealView';
-import type { AgentSessionToolCall } from './AgentSessionToolCall';
-import type { AgentMessageRole } from './AgentMessageRole';
-import type { AgentSessionUsage } from './AgentSessionUsage';
-import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
-/**
- * Published representation of Box.
- * @export
- * @interface Box
- */
-export interface Box {
-    /**
-     * Value of the `artifact_status` field.
-     * @type {string}
-     * @memberof Box
-     */
-    artifactStatus: string;
-    /**
-     * RFC 3339 commit timestamp (the cross-table monotonic cursor).
-     * @type {string}
-     * @memberof Box
-     */
-    commitTs: string;
-    /**
-     * Value of the `content_hash_hex` field.
-     * @type {string}
-     * @memberof Box
-     */
-    contentHashHex?: string;
-    /**
-     * Value of the `created_at` field.
-     * @type {string}
-     * @memberof Box
-     */
-    createdAt: string;
-    /**
-     * Value of the `created_by` field.
-     * @type {string}
-     * @memberof Box
-     */
-    createdBy: string;
-    /**
-     * Human-readable description.
-     * @type {string}
-     * @memberof Box
-     */
-    description?: string;
-    /**
-     * Human-readable name.
-     * @type {string}
-     * @memberof Box
-     */
-    displayName?: string;
-    /**
-     * Value of the `extension` field.
-     * @type {string}
-     * @memberof Box
-     */
-    extension?: string;
-    /**
-     * Kind-prefixed Crockford-base32 handle (`<kind>_<base32>`).
-     * @type {string}
-     * @memberof Box
-     */
-    id: string;
-    /**
-     * Value of the `identity` field.
-     * @type {GatewayArtifactIdentityRevealView}
-     * @memberof Box
-     */
-    identity?: GatewayArtifactIdentityRevealView;
-    /**
-     * Whether this is the head (latest) version of its line.
-     * @type {boolean}
-     * @memberof Box
-     */
-    isLatest: boolean;
-    /**
-     * Domain discriminator for this resource.
-     * @type {string}
-     * @memberof Box
-     */
-    kind: string;
-    /**
-     * Stable machine handle ([AIP-122](https://google.aip.dev/122)): a short,
-     * identifier-shaped label (kebab-case by convention) meant for references,
-     * paths and code. **Not unique**, and not the artifact's identity — `id` is
-     * the only stable handle. Not format-validated today, so existing rows may
-     * hold prose.
-     * @type {string}
-     * @memberof Box
-     */
-    name: string;
-    /**
-     * The Control-Plane OIDC client id this artifact authenticates as
-     * (`x-gateway-identity` kinds); absent for every other kind.
-     *
-     * **Derived, not stored.** The registry resolves it from the artifact's
-     * `service_principals` row rather than keeping a second copy on the artifact,
-     * so it appears on the create response and on the single-artifact read — the
-     * two paths that make that lookup — and **not** on list, search, or a `PATCH`
-     * response, none of which do a per-row identity read. It is the public half of
-     * the credential pair and is not secret.
-     * @type {string}
-     * @memberof Box
-     */
-    oidcClientId?: string;
-    /**
-     * Canonical owner: the `users.user_id` this artifact belongs to, FK-backed.
-     * Absent when unset (legacy rows / system-plane creates).
-     * @type {string}
-     * @memberof Box
-     */
-    ownerId?: string;
-    /**
-     * `project_`-prefixed handle of the project grouping this artifact, when it has
-     * one. Absent for an artifact that lives directly in its workspace — which also
-     * means it is not packaged into any Claude Code plugin, since packaging is
-     * per-project (project-2026-07-30-first-class-project-table).
-     * @type {string}
-     * @memberof Box
-     */
-    projectId?: string;
-    /**
-     * The source repository this artifact came from, as a `repo_`-prefixed
-     * handle. Absent when the artifact has no repo.
-     * @type {string}
-     * @memberof Box
-     */
-    repoId?: string;
-    /**
-     * Advisory origin timestamp for imported artifacts (RFC 3339); absent for
-     * natively-created artifacts. Distinct from `created_at` (the commit time).
-     * @type {string}
-     * @memberof Box
-     */
-    sourceCreatedAt?: string;
-    /**
-     * Advisory upstream author (git `Name <email>`) of the first version
-     * upstream; absent when unset.
-     * @type {string}
-     * @memberof Box
-     */
-    sourceCreatedBy?: string;
-    /**
-     * sha256 of the materialized content; absent when unset.
-     * @type {string}
-     * @memberof Box
-     */
-    sourceDigest?: string;
-    /**
-     * The artifact's identifier in the system it came from — what the upstream
-     * calls it, as opposed to `source_uri`'s where-it-lives. Filterable and
-     * sortable, so a re-sync reconciles on this rather than on `name`; absent
-     * when unset.
-     * @type {string}
-     * @memberof Box
-     */
-    sourceId?: string;
-    /**
-     * Advisory upstream last-modified timestamp (RFC 3339); absent when unset.
-     * @type {string}
-     * @memberof Box
-     */
-    sourceLastModifiedAt?: string;
-    /**
-     * Advisory upstream author (git `Name <email>`) of the last change; absent
-     * when unset.
-     * @type {string}
-     * @memberof Box
-     */
-    sourceLastModifiedBy?: string;
-    /**
-     *
-     * @type {any}
-     * @memberof Box
-     */
-    sourceMetadata?: any | null;
-    /**
-     * Advisory timestamp (RFC 3339) of the last sync that produced a version.
-     * @type {string}
-     * @memberof Box
-     */
-    sourceSyncedAt?: string;
-    /**
-     * Content authority for the line: `git`, `atlan`, `local`, or `external`
-     * for a system the gateway does not know (a customer's own runner or catalog).
-     * @type {string}
-     * @memberof Box
-     */
-    sourceType: string;
-    /**
-     * Scheme-tagged origin; absent for a service-managed (`atlan`) line.
-     * @type {string}
-     * @memberof Box
-     */
-    sourceUri?: string;
-    /**
-     * Advisory upstream version id (git commit hash / tag); distinct from
-     * `version_label`. Absent when unset.
-     * @type {string}
-     * @memberof Box
-     */
-    sourceVersion?: string;
-    /**
-     * Value of the `updated_at` field.
-     * @type {string}
-     * @memberof Box
-     */
-    updatedAt: string;
-    /**
-     * Value of the `updated_by` field.
-     * @type {string}
-     * @memberof Box
-     */
-    updatedBy: string;
-    /**
-     * Optional human version selector (semver); absent when unset.
-     * @type {string}
-     * @memberof Box
-     */
-    versionLabel?: string;
-    /**
-     * Monotonic version coordinate within the artifact line.
-     * @type {number}
-     * @memberof Box
-     */
-    versionOrdinal: number;
-    /**
-     * `workspace_`-prefixed handle.
-     * @type {string}
-     * @memberof Box
-     */
-    workspaceId: string;
-    /**
-     * Message text; absent for a tool-only assistant turn.
-     * @type {string}
-     * @memberof Box
-     */
-    content?: string | null;
-    /**
-     * Whether the owning session's subject is a gateway-owned system artifact,
-     * denormalized for the history guard (no lookup). Server-owned: the
-     * create/update services always set it from the parent session.
-     * @type {boolean}
-     * @memberof Box
-     */
-    isSubjectSystem?: boolean;
-    /**
-     *
-     * @type {AgentMessageRole}
-     * @memberof Box
-     */
-    messageRole?: AgentMessageRole;
-    /**
-     * The model that produced an assistant message.
-     * @type {string}
-     * @memberof Box
-     */
-    modelId?: string | null;
-    /**
-     * Order within the session (0-based); the stable sort key for playback.
-     * @type {number}
-     * @memberof Box
-     */
-    sequenceNumber?: number;
-    /**
-     * The owning `session` handle.
-     * @type {string}
-     * @memberof Box
-     */
-    sessionId?: string;
-    /**
-     * The tool call this message answers (message_role `tool`).
-     * @type {string}
-     * @memberof Box
-     */
-    toolCallId?: string | null;
-    /**
-     * Requested tool calls on an assistant turn (OpenAI shape). Empty otherwise.
-     * @type {Array<AgentSessionToolCall>}
-     * @memberof Box
-     */
-    toolCalls?: Array<AgentSessionToolCall>;
-    /**
-     * The tool's name (message_role `tool`).
-     * @type {string}
-     * @memberof Box
-     */
-    toolName?: string | null;
-    /**
-     *
-     * @type {AgentSessionUsage}
-     * @memberof Box
-     */
-    usage?: AgentSessionUsage;
-    /**
-     * Value of the `permissions` field.
-     * @type {{ [key: string]: boolean; }}
-     * @memberof Box
-     */
-    permissions?: {
-        [key: string]: boolean;
-    } | null;
-    /**
-     * Value of the `relationships` field.
-     * @type {RegistryRelationshipsView}
-     * @memberof Box
-     */
-    relationships?: RegistryRelationshipsView | null;
-}
-/**
- * Check if a given object implements the Box interface.
- */
-export declare function instanceOfBox(value: object): value is Box;
-export declare function BoxFromJSON(json: any): Box;
-export declare function BoxFromJSONTyped(json: any, ignoreDiscriminator: boolean): Box;
-export declare function BoxToJSON(json: any): Box;
-export declare function BoxToJSONTyped(value?: Box | null, ignoreDiscriminator?: boolean): any;