@atlanai/sdk 0.1.0

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

@@ -0,0 +1,197 @@
+/**
+ * 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 { AgentSessionToolCall } from './AgentSessionToolCall';
+import type { AgentMessageRole } from './AgentMessageRole';
+import type { AgentSessionUsage } from './AgentSessionUsage';
+/**
+ * The caller-writable surface of one recorded turn.
+ *
+ * `session_id` is not a body field — it comes from the path, since the routes are
+ * nested under the owning session. `is_subject_system` is absent: `create.pre` derives
+ * it from the parent session, and it is what the history delete guard reads.
+ * @export
+ * @interface AgentSessionMessageCreate
+ */
+export interface AgentSessionMessageCreate {
+    /**
+     * RFC 3339. The upstream's own creation time, never the commit time.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    sourceCreatedAt?: string;
+    /**
+     * The upstream author, git `Name <email>` form (distinct from the registry
+     * principal `created_by`). The first author; see `source_last_modified_by`
+     * for who changed it last.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    sourceCreatedBy?: string;
+    /**
+     * What the upstream calls this object. The reconciliation key for a re-sync,
+     * and the reason to prefer it over matching on `name`.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    sourceId?: string;
+    /**
+     * RFC 3339.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    sourceLastModifiedAt?: string;
+    /**
+     * The upstream author of the last change, git `Name <email>` form.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    sourceLastModifiedBy?: string;
+    /**
+     *
+     * @type {any}
+     * @memberof AgentSessionMessageCreate
+     */
+    sourceMetadata?: any | null;
+    /**
+     * RFC 3339. The time of the sync that produced this version.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    sourceSyncedAt?: string;
+    /**
+     * The content authority: `git`, `atlan`, `local`, or `external` for a
+     * customer's own system. Omitted, the registry defaults it.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    sourceType?: string;
+    /**
+     * Scheme-tagged origin — where the upstream object lives.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    sourceUri?: string;
+    /**
+     * The upstream revision (a commit hash or tag), distinct from `version_label`.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    sourceVersion?: string;
+    /**
+     * Human-readable description.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    description?: string;
+    /**
+     * Human-readable label. Omitted, the gateway defaults it to `name`.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    displayName?: string;
+    /**
+     * Stable machine handle ([AIP-122](https://google.aip.dev/122)) — short and
+     * identifier-shaped, kebab-case by convention. Not unique, and not identity:
+     * `id` is the only stable handle.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    name: string;
+    /**
+     * Optional canonical owner (`users.user_id`). Omitted, the gateway
+     * attributes the caller.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    ownerId?: string;
+    /**
+     * Optional `project_`-prefixed handle to group under. Must belong to
+     * `workspace_id` (else 422). An artifact with no project is valid but is not
+     * packaged into a Claude Code plugin.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    projectId?: string;
+    /**
+     * Optional `repo_`-prefixed source repository. No default — a repo is a
+     * factual claim about provenance, so it is never guessed.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    repoId?: string;
+    /**
+     * `workspace_`-prefixed handle to create in. **Required** — there is
+     * deliberately no default, because guessing a tenant's namespace is invisible
+     * until someone else reads the data.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    workspaceId: string;
+    /**
+     * Message text; omit for a tool-only assistant turn.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    content?: string | null;
+    /**
+     *
+     * @type {AgentMessageRole}
+     * @memberof AgentSessionMessageCreate
+     */
+    messageRole: AgentMessageRole;
+    /**
+     * The model that produced an assistant message.
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    modelId?: string | null;
+    /**
+     * Order within the session (0-based) — the stable sort key for playback, and
+     * the column `GET /sessions/{session_id}/events` orders by.
+     * @type {number}
+     * @memberof AgentSessionMessageCreate
+     */
+    sequenceNumber: number;
+    /**
+     * The tool call this message answers (message_role `tool`).
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    toolCallId?: string | null;
+    /**
+     * Requested tool calls on an assistant turn: `[{id, name, arguments}]` in the
+     * OpenAI shape, where `arguments` is a JSON-encoded string.
+     * @type {Array<AgentSessionToolCall>}
+     * @memberof AgentSessionMessageCreate
+     */
+    toolCalls?: Array<AgentSessionToolCall>;
+    /**
+     * The tool's name (message_role `tool`).
+     * @type {string}
+     * @memberof AgentSessionMessageCreate
+     */
+    toolName?: string | null;
+    /**
+     *
+     * @type {AgentSessionUsage}
+     * @memberof AgentSessionMessageCreate
+     */
+    usage?: AgentSessionUsage;
+}
+/**
+ * Check if a given object implements the AgentSessionMessageCreate interface.
+ */
+export declare function instanceOfAgentSessionMessageCreate(value: object): value is AgentSessionMessageCreate;
+export declare function AgentSessionMessageCreateFromJSON(json: any): AgentSessionMessageCreate;
+export declare function AgentSessionMessageCreateFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentSessionMessageCreate;
+export declare function AgentSessionMessageCreateToJSON(json: any): AgentSessionMessageCreate;
+export declare function AgentSessionMessageCreateToJSONTyped(value?: AgentSessionMessageCreate | null, ignoreDiscriminator?: boolean): any;

package/dist/raw/agent/models/AgentSessionMessageCreate.js

@@ -0,0 +1,107 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfAgentSessionMessageCreate = instanceOfAgentSessionMessageCreate;
+exports.AgentSessionMessageCreateFromJSON = AgentSessionMessageCreateFromJSON;
+exports.AgentSessionMessageCreateFromJSONTyped = AgentSessionMessageCreateFromJSONTyped;
+exports.AgentSessionMessageCreateToJSON = AgentSessionMessageCreateToJSON;
+exports.AgentSessionMessageCreateToJSONTyped = AgentSessionMessageCreateToJSONTyped;
+const AgentSessionToolCall_1 = require("./AgentSessionToolCall");
+const AgentMessageRole_1 = require("./AgentMessageRole");
+const AgentSessionUsage_1 = require("./AgentSessionUsage");
+/**
+ * Check if a given object implements the AgentSessionMessageCreate interface.
+ */
+function instanceOfAgentSessionMessageCreate(value) {
+    if (!('name' in value) || value['name'] === undefined)
+        return false;
+    if ((!('workspaceId' in value) && !('workspace_id' in value)) || (value['workspaceId'] === undefined && value['workspace_id'] === undefined))
+        return false;
+    if ((!('messageRole' in value) && !('message_role' in value)) || (value['messageRole'] === undefined && value['message_role'] === undefined))
+        return false;
+    if ((!('sequenceNumber' in value) && !('sequence_number' in value)) || (value['sequenceNumber'] === undefined && value['sequence_number'] === undefined))
+        return false;
+    return true;
+}
+function AgentSessionMessageCreateFromJSON(json) {
+    return AgentSessionMessageCreateFromJSONTyped(json, false);
+}
+function AgentSessionMessageCreateFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'sourceCreatedAt': json['source_created_at'] == null ? undefined : json['source_created_at'],
+        'sourceCreatedBy': json['source_created_by'] == null ? undefined : json['source_created_by'],
+        'sourceId': json['source_id'] == null ? undefined : json['source_id'],
+        'sourceLastModifiedAt': json['source_last_modified_at'] == null ? undefined : json['source_last_modified_at'],
+        'sourceLastModifiedBy': json['source_last_modified_by'] == null ? undefined : json['source_last_modified_by'],
+        'sourceMetadata': json['source_metadata'] === undefined ? undefined : json['source_metadata'] === null ? null : json['source_metadata'],
+        'sourceSyncedAt': json['source_synced_at'] == null ? undefined : json['source_synced_at'],
+        'sourceType': json['source_type'] == null ? undefined : json['source_type'],
+        'sourceUri': json['source_uri'] == null ? undefined : json['source_uri'],
+        'sourceVersion': json['source_version'] == null ? undefined : json['source_version'],
+        'description': json['description'] == null ? undefined : json['description'],
+        'displayName': json['display_name'] == null ? undefined : json['display_name'],
+        'name': json['name'],
+        'ownerId': json['owner_id'] == null ? undefined : json['owner_id'],
+        'projectId': json['project_id'] == null ? undefined : json['project_id'],
+        'repoId': json['repo_id'] == null ? undefined : json['repo_id'],
+        'workspaceId': json['workspace_id'],
+        'content': json['content'] === undefined ? undefined : json['content'] === null ? null : json['content'],
+        'messageRole': (0, AgentMessageRole_1.AgentMessageRoleFromJSON)(json['message_role']),
+        'modelId': json['model_id'] === undefined ? undefined : json['model_id'] === null ? null : json['model_id'],
+        'sequenceNumber': json['sequence_number'],
+        'toolCallId': json['tool_call_id'] === undefined ? undefined : json['tool_call_id'] === null ? null : json['tool_call_id'],
+        'toolCalls': json['tool_calls'] == null ? undefined : (json['tool_calls'].map(AgentSessionToolCall_1.AgentSessionToolCallFromJSON)),
+        'toolName': json['tool_name'] === undefined ? undefined : json['tool_name'] === null ? null : json['tool_name'],
+        'usage': json['usage'] == null ? undefined : (0, AgentSessionUsage_1.AgentSessionUsageFromJSON)(json['usage']),
+    };
+}
+function AgentSessionMessageCreateToJSON(json) {
+    return AgentSessionMessageCreateToJSONTyped(json, false);
+}
+function AgentSessionMessageCreateToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'source_created_at': value['sourceCreatedAt'],
+        'source_created_by': value['sourceCreatedBy'],
+        'source_id': value['sourceId'],
+        'source_last_modified_at': value['sourceLastModifiedAt'],
+        'source_last_modified_by': value['sourceLastModifiedBy'],
+        'source_metadata': value['sourceMetadata'],
+        'source_synced_at': value['sourceSyncedAt'],
+        'source_type': value['sourceType'],
+        'source_uri': value['sourceUri'],
+        'source_version': value['sourceVersion'],
+        'description': value['description'],
+        'display_name': value['displayName'],
+        'name': value['name'],
+        'owner_id': value['ownerId'],
+        'project_id': value['projectId'],
+        'repo_id': value['repoId'],
+        'workspace_id': value['workspaceId'],
+        'content': value['content'],
+        'message_role': (0, AgentMessageRole_1.AgentMessageRoleToJSON)(value['messageRole']),
+        'model_id': value['modelId'],
+        'sequence_number': value['sequenceNumber'],
+        'tool_call_id': value['toolCallId'],
+        'tool_calls': value['toolCalls'] == null ? undefined : (value['toolCalls'].map(AgentSessionToolCall_1.AgentSessionToolCallToJSON)),
+        'tool_name': value['toolName'],
+        'usage': (0, AgentSessionUsage_1.AgentSessionUsageToJSON)(value['usage']),
+    };
+}

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

@@ -0,0 +1,96 @@
+/**
+ * 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 { AgentSessionToolCall } from './AgentSessionToolCall';
+import type { AgentMessageRole } from './AgentMessageRole';
+import type { AgentSessionUsage } from './AgentSessionUsage';
+/**
+ * The `session_message` kind — one recorded conversation turn (child of a
+ * `session`). The bare-minimum content to render session history (distinct from
+ * OTel traces, which carry granular data and link to a session). Uploaded by the
+ * client through the generic artifact API as the run produces turns;
+ * `source_created_at` preserves each turn's original timestamp. Message time = its
+ * own `created_at` (live) or `source_created_at` (import).
+ * @export
+ * @interface AgentSessionMessageMeta
+ */
+export interface AgentSessionMessageMeta {
+    /**
+     * Message text; absent for a tool-only assistant turn.
+     * @type {string}
+     * @memberof AgentSessionMessageMeta
+     */
+    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 AgentSessionMessageMeta
+     */
+    isSubjectSystem?: boolean;
+    /**
+     *
+     * @type {AgentMessageRole}
+     * @memberof AgentSessionMessageMeta
+     */
+    messageRole: AgentMessageRole;
+    /**
+     * The model that produced an assistant message.
+     * @type {string}
+     * @memberof AgentSessionMessageMeta
+     */
+    modelId?: string | null;
+    /**
+     * Order within the session (0-based); the stable sort key for playback.
+     * @type {number}
+     * @memberof AgentSessionMessageMeta
+     */
+    sequenceNumber: number;
+    /**
+     * The owning `session` handle.
+     * @type {string}
+     * @memberof AgentSessionMessageMeta
+     */
+    sessionId: string;
+    /**
+     * The tool call this message answers (message_role `tool`).
+     * @type {string}
+     * @memberof AgentSessionMessageMeta
+     */
+    toolCallId?: string | null;
+    /**
+     * Requested tool calls on an assistant turn (OpenAI shape). Empty otherwise.
+     * @type {Array<AgentSessionToolCall>}
+     * @memberof AgentSessionMessageMeta
+     */
+    toolCalls?: Array<AgentSessionToolCall>;
+    /**
+     * The tool's name (message_role `tool`).
+     * @type {string}
+     * @memberof AgentSessionMessageMeta
+     */
+    toolName?: string | null;
+    /**
+     *
+     * @type {AgentSessionUsage}
+     * @memberof AgentSessionMessageMeta
+     */
+    usage?: AgentSessionUsage;
+}
+/**
+ * Check if a given object implements the AgentSessionMessageMeta interface.
+ */
+export declare function instanceOfAgentSessionMessageMeta(value: object): value is AgentSessionMessageMeta;
+export declare function AgentSessionMessageMetaFromJSON(json: any): AgentSessionMessageMeta;
+export declare function AgentSessionMessageMetaFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentSessionMessageMeta;
+export declare function AgentSessionMessageMetaToJSON(json: any): AgentSessionMessageMeta;
+export declare function AgentSessionMessageMetaToJSONTyped(value?: AgentSessionMessageMeta | null, ignoreDiscriminator?: boolean): any;

package/dist/raw/agent/models/AgentSessionMessageMeta.js

@@ -0,0 +1,75 @@
+"use strict";
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instanceOfAgentSessionMessageMeta = instanceOfAgentSessionMessageMeta;
+exports.AgentSessionMessageMetaFromJSON = AgentSessionMessageMetaFromJSON;
+exports.AgentSessionMessageMetaFromJSONTyped = AgentSessionMessageMetaFromJSONTyped;
+exports.AgentSessionMessageMetaToJSON = AgentSessionMessageMetaToJSON;
+exports.AgentSessionMessageMetaToJSONTyped = AgentSessionMessageMetaToJSONTyped;
+const AgentSessionToolCall_1 = require("./AgentSessionToolCall");
+const AgentMessageRole_1 = require("./AgentMessageRole");
+const AgentSessionUsage_1 = require("./AgentSessionUsage");
+/**
+ * Check if a given object implements the AgentSessionMessageMeta interface.
+ */
+function instanceOfAgentSessionMessageMeta(value) {
+    if ((!('messageRole' in value) && !('message_role' in value)) || (value['messageRole'] === undefined && value['message_role'] === undefined))
+        return false;
+    if ((!('sequenceNumber' in value) && !('sequence_number' in value)) || (value['sequenceNumber'] === undefined && value['sequence_number'] === undefined))
+        return false;
+    if ((!('sessionId' in value) && !('session_id' in value)) || (value['sessionId'] === undefined && value['session_id'] === undefined))
+        return false;
+    return true;
+}
+function AgentSessionMessageMetaFromJSON(json) {
+    return AgentSessionMessageMetaFromJSONTyped(json, false);
+}
+function AgentSessionMessageMetaFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'content': json['content'] === undefined ? undefined : json['content'] === null ? null : json['content'],
+        'isSubjectSystem': json['is_subject_system'] == null ? undefined : json['is_subject_system'],
+        'messageRole': (0, AgentMessageRole_1.AgentMessageRoleFromJSON)(json['message_role']),
+        'modelId': json['model_id'] === undefined ? undefined : json['model_id'] === null ? null : json['model_id'],
+        'sequenceNumber': json['sequence_number'],
+        'sessionId': json['session_id'],
+        'toolCallId': json['tool_call_id'] === undefined ? undefined : json['tool_call_id'] === null ? null : json['tool_call_id'],
+        'toolCalls': json['tool_calls'] == null ? undefined : (json['tool_calls'].map(AgentSessionToolCall_1.AgentSessionToolCallFromJSON)),
+        'toolName': json['tool_name'] === undefined ? undefined : json['tool_name'] === null ? null : json['tool_name'],
+        'usage': json['usage'] == null ? undefined : (0, AgentSessionUsage_1.AgentSessionUsageFromJSON)(json['usage']),
+    };
+}
+function AgentSessionMessageMetaToJSON(json) {
+    return AgentSessionMessageMetaToJSONTyped(json, false);
+}
+function AgentSessionMessageMetaToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'content': value['content'],
+        'is_subject_system': value['isSubjectSystem'],
+        'message_role': (0, AgentMessageRole_1.AgentMessageRoleToJSON)(value['messageRole']),
+        'model_id': value['modelId'],
+        'sequence_number': value['sequenceNumber'],
+        'session_id': value['sessionId'],
+        'tool_call_id': value['toolCallId'],
+        'tool_calls': value['toolCalls'] == null ? undefined : (value['toolCalls'].map(AgentSessionToolCall_1.AgentSessionToolCallToJSON)),
+        'tool_name': value['toolName'],
+        'usage': (0, AgentSessionUsage_1.AgentSessionUsageToJSON)(value['usage']),
+    };
+}

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

@@ -0,0 +1,195 @@
+/**
+ * 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 { AgentAgentProviderType } from './AgentAgentProviderType';
+import type { AgentSessionUsage } from './AgentSessionUsage';
+import type { AgentVisitorLinkStatus } from './AgentVisitorLinkStatus';
+import type { AgentSubjectKind } from './AgentSubjectKind';
+import type { AgentSessionStatus } from './AgentSessionStatus';
+import type { AgentVisitorType } from './AgentVisitorType';
+/**
+ * The `session` kind — the gateway-governed record of one run, hanging off
+ * *either* a `harness` or an `agent` through the polymorphic
+ * `subject_kind` + `subject_id` pair. The source of truth for the run's status
+ * and aggregate result; the transcript is the child `session_message` artifacts.
+ *
+ * A harness run happens on the customer's machine and the client uploads the
+ * session and its messages through the generic artifact API
+ * (`source_created_at` preserves original timestamps). An agent run on a
+ * provider is created by the run-trigger.
+ * @export
+ * @interface AgentSessionMeta
+ */
+export interface AgentSessionMeta {
+    /**
+     * The `agent_provider` this run ran on. Absent for a harness run and for an
+     * agent the customer runs on their own infrastructure.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    agentProviderId?: string | null;
+    /**
+     * Value of the `agent_provider_type` field.
+     * @type {AgentAgentProviderType}
+     * @memberof AgentSessionMeta
+     */
+    agentProviderType?: AgentAgentProviderType | null;
+    /**
+     * The `agent_environment` the remote run's sandbox was created from. Absent
+     * for an uploaded harness transcript.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    environmentId?: string | null;
+    /**
+     * The error string when the run failed; absent otherwise.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    error?: string | null;
+    /**
+     * The session UUID this run emitted on its OTel spans (the
+     * `atlan.session.id` / `session.id` span attribute). The join key for the
+     * session trace route: the uploader stamps it so
+     * `GET /sessions/{session_id}/traces` can resolve this session's traces.
+     * Optional when an imported run has no trace id.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    externalSessionId?: string | null;
+    /**
+     * Whether the subject is a gateway-owned system artifact, denormalized so
+     * the history guard needs no parent lookup. Server-owned: the create/update
+     * services always set it from the parent, so a caller cannot spoof it past
+     * the guard.
+     *
+     * A plain column, deliberately **not** `system_flag`: `is_system` is
+     * resolved from the service output and a `true` value over public HTTP is a
+     * hard 400, so flagging this would reject every public upload for a system
+     * subject.
+     * @type {boolean}
+     * @memberof AgentSessionMeta
+     */
+    isSubjectSystem?: boolean;
+    /**
+     * Number of `session_message` children recorded for this run.
+     * @type {number}
+     * @memberof AgentSessionMeta
+     */
+    messageCount?: number;
+    /**
+     * The model the run used.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    modelId?: string;
+    /**
+     *
+     * @type {AgentSessionStatus}
+     * @memberof AgentSessionMeta
+     */
+    sessionStatus: AgentSessionStatus;
+    /**
+     * Why the run stopped; absent while running.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    stopReason?: string | null;
+    /**
+     * The subject's artifact handle, resolved against `subject_kind`.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    subjectId: string;
+    /**
+     *
+     * @type {AgentSubjectKind}
+     * @memberof AgentSessionMeta
+     */
+    subjectKind: AgentSubjectKind;
+    /**
+     * A human label for the session (the truncated first user prompt).
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    title?: string | null;
+    /**
+     *
+     * @type {AgentSessionUsage}
+     * @memberof AgentSessionMeta
+     */
+    usage?: AgentSessionUsage;
+    /**
+     * The visitor's email, when the source system knows one. The key the service
+     * matches against this account's directory to derive `visitor_user_id`.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    visitorEmail?: string | null;
+    /**
+     * The visitor's identifier in the system the run came from — a support ticket
+     * requester, a chat user id, a calling agent's own handle. Indexed: "show me
+     * every session for this visitor" is the question this field exists to answer.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    visitorExternalId?: string | null;
+    /**
+     * The first-class visitor this run belongs to. The hook verifies that the
+     * visitor exists in the same workspace.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    visitorId?: string | null;
+    /**
+     * Namespace that owns `visitor_external_id`. Retained as immutable evidence
+     * for imported sessions and required whenever that external id is supplied.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    visitorIdentitySource?: string | null;
+    /**
+     *
+     * @type {AgentVisitorLinkStatus}
+     * @memberof AgentSessionMeta
+     */
+    visitorLinkStatus?: AgentVisitorLinkStatus;
+    /**
+     * The visitor's display name. Searchable rather than indexed — it is browsed,
+     * not joined on.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    visitorName?: string | null;
+    /**
+     * Value of the `visitor_type` field.
+     * @type {AgentVisitorType}
+     * @memberof AgentSessionMeta
+     */
+    visitorType?: AgentVisitorType | null;
+    /**
+     * The directory user this visitor resolved to, when their email matched one in
+     * this account. **Server-owned** — derived by the service from
+     * `visitor_email`, and re-derived on update, so an uploader cannot claim a run
+     * was for a colleague it was not for.
+     * @type {string}
+     * @memberof AgentSessionMeta
+     */
+    visitorUserId?: string | null;
+}
+/**
+ * Check if a given object implements the AgentSessionMeta interface.
+ */
+export declare function instanceOfAgentSessionMeta(value: object): value is AgentSessionMeta;
+export declare function AgentSessionMetaFromJSON(json: any): AgentSessionMeta;
+export declare function AgentSessionMetaFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentSessionMeta;
+export declare function AgentSessionMetaToJSON(json: any): AgentSessionMeta;
+export declare function AgentSessionMetaToJSONTyped(value?: AgentSessionMeta | null, ignoreDiscriminator?: boolean): any;