@atlanai/sdk 0.1.0

package/dist/raw/agent/apis/VisitorsApi.js

@@ -0,0 +1,101 @@
+"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.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VisitorsApi = void 0;
+const runtime = __importStar(require("../runtime"));
+const AgentVisitorArtifactView_1 = require("../models/AgentVisitorArtifactView");
+const AgentVisitorIdentifyRequest_1 = require("../models/AgentVisitorIdentifyRequest");
+/**
+ *
+ */
+class VisitorsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for agentIdentifyVisitor without sending the request
+     */
+    async agentIdentifyVisitorRequestOpts(requestParameters) {
+        if (requestParameters['agentVisitorIdentifyRequest'] == null) {
+            throw new runtime.RequiredError('agentVisitorIdentifyRequest', 'Required parameter "agentVisitorIdentifyRequest" was null or undefined when calling agentIdentifyVisitor().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/visitors/identify`;
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, AgentVisitorIdentifyRequest_1.AgentVisitorIdentifyRequestToJSON)(requestParameters['agentVisitorIdentifyRequest']),
+        };
+    }
+    /**
+     * Create or update one workspace-scoped visitor by stable identity_source and external_id. Omitted profile fields remain unchanged; attributes shallow-merge and null removes a key. Requires workspace create permission, which editors and admins hold.  An identity whose visitor was archived is reactivated and updated, not refused: coming back is the event that reverses an archive.
+     * Identify a visitor
+     */
+    async agentIdentifyVisitorRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.agentIdentifyVisitorRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, AgentVisitorArtifactView_1.AgentVisitorArtifactViewFromJSON)(jsonValue));
+    }
+    /**
+     * Create or update one workspace-scoped visitor by stable identity_source and external_id. Omitted profile fields remain unchanged; attributes shallow-merge and null removes a key. Requires workspace create permission, which editors and admins hold.  An identity whose visitor was archived is reactivated and updated, not refused: coming back is the event that reverses an archive.
+     * Identify a visitor
+     */
+    async agentIdentifyVisitor(requestParameters, initOverrides) {
+        const response = await this.agentIdentifyVisitorRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
+}
+exports.VisitorsApi = VisitorsApi;

package/dist/raw/agent/apis/index.d.ts

@@ -0,0 +1,10 @@
+export * from './AgentEnvironmentsApi';
+export * from './AgentFrameworksApi';
+export * from './AgentProvidersApi';
+export * from './AgentsApi';
+export * from './HarnessVendorsApi';
+export * from './HarnessesApi';
+export * from './OutputsApi';
+export * from './SessionsApi';
+export * from './TracesApi';
+export * from './VisitorsApi';

package/dist/raw/agent/apis/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* tslint:disable */
+/* eslint-disable */
+__exportStar(require("./AgentEnvironmentsApi"), exports);
+__exportStar(require("./AgentFrameworksApi"), exports);
+__exportStar(require("./AgentProvidersApi"), exports);
+__exportStar(require("./AgentsApi"), exports);
+__exportStar(require("./HarnessVendorsApi"), exports);
+__exportStar(require("./HarnessesApi"), exports);
+__exportStar(require("./OutputsApi"), exports);
+__exportStar(require("./SessionsApi"), exports);
+__exportStar(require("./TracesApi"), exports);
+__exportStar(require("./VisitorsApi"), exports);

package/dist/raw/agent/index.d.ts

@@ -0,0 +1,3 @@
+export * from './runtime';
+export * from './apis/index';
+export * from './models/index';

package/dist/raw/agent/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* tslint:disable */
+/* eslint-disable */
+__exportStar(require("./runtime"), exports);
+__exportStar(require("./apis/index"), exports);
+__exportStar(require("./models/index"), exports);

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

@@ -0,0 +1,57 @@
+/**
+ * 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.
+ */
+/**
+ * Advisory access block for UI banners — never an enforcement signal (the
+ * gateway already enforced access before the results were shaped).
+ * @export
+ * @interface AccessView
+ */
+export interface AccessView {
+    /**
+     * Whether the caller may filter by an explicit `user_id`.
+     * @type {boolean}
+     * @memberof AccessView
+     */
+    allowUserFilter: boolean;
+    /**
+     * `own` or `all` — whose traces are in scope.
+     * @type {string}
+     * @memberof AccessView
+     */
+    audience: string;
+    /**
+     * `member` / `creator` / `admin` — why the caller has access.
+     * @type {string}
+     * @memberof AccessView
+     */
+    basis: string;
+    /**
+     * `raw` or `aggregate_only` — whether raw trace rows are readable at all.
+     * @type {string}
+     * @memberof AccessView
+     */
+    detail?: string;
+    /**
+     * `full` or `skill_turn` — how much of a cross-user trace is visible.
+     * @type {string}
+     * @memberof AccessView
+     */
+    slice: string;
+}
+/**
+ * Check if a given object implements the AccessView interface.
+ */
+export declare function instanceOfAccessView(value: object): value is AccessView;
+export declare function AccessViewFromJSON(json: any): AccessView;
+export declare function AccessViewFromJSONTyped(json: any, ignoreDiscriminator: boolean): AccessView;
+export declare function AccessViewToJSON(json: any): AccessView;
+export declare function AccessViewToJSONTyped(value?: AccessView | null, ignoreDiscriminator?: boolean): any;

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

@@ -0,0 +1,64 @@
+"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.instanceOfAccessView = instanceOfAccessView;
+exports.AccessViewFromJSON = AccessViewFromJSON;
+exports.AccessViewFromJSONTyped = AccessViewFromJSONTyped;
+exports.AccessViewToJSON = AccessViewToJSON;
+exports.AccessViewToJSONTyped = AccessViewToJSONTyped;
+/**
+ * Check if a given object implements the AccessView interface.
+ */
+function instanceOfAccessView(value) {
+    if ((!('allowUserFilter' in value) && !('allow_user_filter' in value)) || (value['allowUserFilter'] === undefined && value['allow_user_filter'] === undefined))
+        return false;
+    if (!('audience' in value) || value['audience'] === undefined)
+        return false;
+    if (!('basis' in value) || value['basis'] === undefined)
+        return false;
+    if (!('slice' in value) || value['slice'] === undefined)
+        return false;
+    return true;
+}
+function AccessViewFromJSON(json) {
+    return AccessViewFromJSONTyped(json, false);
+}
+function AccessViewFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'allowUserFilter': json['allow_user_filter'],
+        'audience': json['audience'],
+        'basis': json['basis'],
+        'detail': json['detail'] == null ? undefined : json['detail'],
+        'slice': json['slice'],
+    };
+}
+function AccessViewToJSON(json) {
+    return AccessViewToJSONTyped(json, false);
+}
+function AccessViewToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'allow_user_filter': value['allowUserFilter'],
+        'audience': value['audience'],
+        'basis': value['basis'],
+        'detail': value['detail'],
+        'slice': value['slice'],
+    };
+}

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

@@ -0,0 +1,374 @@
+/**
+ * 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 { GatewayToolRef } from './GatewayToolRef';
+import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
+/**
+ * An `agent` artifact: the shared artifact fields, its typed metadata, and the
+ * derived address of its profile image.
+ * @export
+ * @interface AgentAgentArtifactView
+ */
+export interface AgentAgentArtifactView {
+    /**
+     * Value of the `artifact_status` field.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    artifactStatus: string;
+    /**
+     * RFC 3339 commit timestamp (the cross-table monotonic cursor).
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    commitTs: string;
+    /**
+     * Value of the `content_hash_hex` field.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    contentHashHex?: string;
+    /**
+     * Value of the `created_at` field.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    createdAt: string;
+    /**
+     * Value of the `created_by` field.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    createdBy: string;
+    /**
+     * Human-readable description.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    description?: string;
+    /**
+     * Human-readable name.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    displayName?: string;
+    /**
+     * Value of the `extension` field.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    extension?: string;
+    /**
+     * Kind-prefixed Crockford-base32 handle (`<kind>_<base32>`).
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    id: string;
+    /**
+     * Value of the `identity` field.
+     * @type {GatewayArtifactIdentityRevealView}
+     * @memberof AgentAgentArtifactView
+     */
+    identity?: GatewayArtifactIdentityRevealView;
+    /**
+     * Whether this is the head (latest) version of its line.
+     * @type {boolean}
+     * @memberof AgentAgentArtifactView
+     */
+    isLatest: boolean;
+    /**
+     * Domain discriminator for this resource.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    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 AgentAgentArtifactView
+     */
+    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 AgentAgentArtifactView
+     */
+    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 AgentAgentArtifactView
+     */
+    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 AgentAgentArtifactView
+     */
+    projectId?: string;
+    /**
+     * The source repository this artifact came from, as a `repo_`-prefixed
+     * handle. Absent when the artifact has no repo.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    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 AgentAgentArtifactView
+     */
+    sourceCreatedAt?: string;
+    /**
+     * Advisory upstream author (git `Name <email>`) of the first version
+     * upstream; absent when unset.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    sourceCreatedBy?: string;
+    /**
+     * sha256 of the materialized content; absent when unset.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    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 AgentAgentArtifactView
+     */
+    sourceId?: string;
+    /**
+     * Advisory upstream last-modified timestamp (RFC 3339); absent when unset.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    sourceLastModifiedAt?: string;
+    /**
+     * Advisory upstream author (git `Name <email>`) of the last change; absent
+     * when unset.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    sourceLastModifiedBy?: string;
+    /**
+     *
+     * @type {any}
+     * @memberof AgentAgentArtifactView
+     */
+    sourceMetadata?: any | null;
+    /**
+     * Advisory timestamp (RFC 3339) of the last sync that produced a version.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    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 AgentAgentArtifactView
+     */
+    sourceType: string;
+    /**
+     * Scheme-tagged origin; absent for a service-managed (`atlan`) line.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    sourceUri?: string;
+    /**
+     * Advisory upstream version id (git commit hash / tag); distinct from
+     * `version_label`. Absent when unset.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    sourceVersion?: string;
+    /**
+     * Value of the `updated_at` field.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    updatedAt: string;
+    /**
+     * Value of the `updated_by` field.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    updatedBy: string;
+    /**
+     * Optional human version selector (semver); absent when unset.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    versionLabel?: string;
+    /**
+     * Monotonic version coordinate within the artifact line.
+     * @type {number}
+     * @memberof AgentAgentArtifactView
+     */
+    versionOrdinal: number;
+    /**
+     * `workspace_`-prefixed handle.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    workspaceId: string;
+    /**
+     * The [`AgentFrameworkMeta`] this agent is built with. Absent when the
+     * framework is unknown, or when it lives in the customer's own system.
+     *
+     * A reference rather than the free-text label this was: a bare string is not
+     * something a console can render as a dropdown, and it let `langgraph`,
+     * `LangGraph` and `lang-graph` coexist as three different answers. Indexed,
+     * so `agent_framework.archive.pre` can refuse while still referenced —
+     * the same shape as `agent_provider_id` below.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    agentFrameworkId?: string | null;
+    /**
+     * The `agent_provider` naming where this agent runs. Absent when the
+     * execution home is simply unknown. Indexed so `agent_provider.archive.pre`
+     * can refuse while still referenced.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    agentProviderId?: string | null;
+    /**
+     * System prompt — the agent's standing instructions, when the gateway holds
+     * them rather than the customer's own system.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    instructions?: string | null;
+    /**
+     * Gateway-owned, non-deletable system agent (seeded on install).
+     * @type {boolean}
+     * @memberof AgentAgentArtifactView
+     */
+    isSystem?: boolean;
+    /**
+     * Hard cap on LLM round-trips per run.
+     * @type {number}
+     * @memberof AgentAgentArtifactView
+     */
+    maxStepCount?: number;
+    /**
+     * Model id the agent runs against, when it is fixed. Absent for an agent
+     * whose orchestrator picks the model per run.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    modelId?: string | null;
+    /**
+     * Where this agent is **reachable** once the customer has deployed it — the
+     * URL their platform handed back. Absent when the agent is not deployed, or
+     * when its address lives in the customer's own system.
+     *
+     * **Reference only. The gateway never dereferences this**, so it offers no
+     * reachability, health, or staleness signal: a dead URL and a live one are
+     * indistinguishable here. The value is a claim the customer maintains, the
+     * same footing `instructions` and `model_id` have under
+     * [agent-2026-08-06-optional-agent-spec].
+     *
+     * `create.pre` / `update.pre` enforce an `http(s)` scheme and nothing more —
+     * deliberately **not** an SSRF check, unlike `mcp_server.endpoint_url` which
+     * the gateway dials. An agent deployed inside the customer's own network is a
+     * correct value here, so rejecting internal addresses would refuse valid rows;
+     * and tightening this later would start 400ing the PATCH of every customer
+     * whose stored URL points inward, which is why the policy is settled now
+     * rather than discovered later.
+     *
+     * **Dialing it needs an ADR.** Invoking the agent, pushing it skills, or
+     * driving a benchmark through this URL all require superseding
+     * [agent-2026-08-06-customer-owned-providers] — which removed that whole path
+     * and states the gateway dials nothing — plus call-time SSRF re-validation
+     * (`extension_sdk::ssrf`) and a credential reference. Do not wire an outbound
+     * call to this column without it.
+     *
+     * Consumers render it as an outbound link and must set
+     * `rel="noopener noreferrer"`; the scheme check is what keeps
+     * `javascript:`/`data:` out of that anchor.
+     *
+     * Unbounded `text`, for the reconciler reason every other string column on
+     * this kind is: a `maxLength` renders `varchar(n)` against a column the
+     * reconciler sees as unbounded and reads that narrowing as destructive drift.
+     *
+     * See [agent-2026-08-23-agent-public-url].
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    publicUrl?: string | null;
+    /**
+     * Declarative tool references the agent may call.
+     * @type {Array<GatewayToolRef>}
+     * @memberof AgentAgentArtifactView
+     */
+    tools?: Array<GatewayToolRef>;
+    /**
+     * Value of the `permissions` field.
+     * @type {{ [key: string]: boolean; }}
+     * @memberof AgentAgentArtifactView
+     */
+    permissions?: {
+        [key: string]: boolean;
+    } | null;
+    /**
+     * Where to fetch this agent's profile image, when it has one — the path
+     * `GET /agent/v1/agents/{agent_id}/profile-image` is served at.
+     *
+     * **Derived, never stored.** The kind records only an internal object address,
+     * which never reaches the wire; this is the route that serves those bytes.
+     * Present exactly when an image exists, so one read tells a client both whether
+     * to draw an avatar and where to get it — no `404` probe per row.
+     *
+     * Root-relative, because the gateway does not reliably know its own public base
+     * URL: resolve it against the origin you reached this API on.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    profileImageUrl?: string | null;
+    /**
+     * Value of the `relationships` field.
+     * @type {RegistryRelationshipsView}
+     * @memberof AgentAgentArtifactView
+     */
+    relationships?: RegistryRelationshipsView | null;
+}
+/**
+ * Check if a given object implements the AgentAgentArtifactView interface.
+ */
+export declare function instanceOfAgentAgentArtifactView(value: object): value is AgentAgentArtifactView;
+export declare function AgentAgentArtifactViewFromJSON(json: any): AgentAgentArtifactView;
+export declare function AgentAgentArtifactViewFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentAgentArtifactView;
+export declare function AgentAgentArtifactViewToJSON(json: any): AgentAgentArtifactView;
+export declare function AgentAgentArtifactViewToJSONTyped(value?: AgentAgentArtifactView | null, ignoreDiscriminator?: boolean): any;