@atlanai/sdk 0.2.2 → 0.2.4

package/dist/index.d.ts

@@ -2,11 +2,12 @@ export { AtlanClient, ServiceNamespace, createService } from "./client";
 export type { AtlanClientOptions, ForwardedOperation, Service } from "./client";
 export { buildResources, resourceMap } from "./resources";
 export type { Resource, ResourceOperation } from "./resources";
+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/manifest.json

@@ -599,9 +599,18 @@
                     "stability": "stable",
                     "summary": "Set a workspace's release policy for a channel",
                     "visibility": "public"
+                },
+                {
+                    "error_contract": "native",
+                    "method": "PATCH",
+                    "operation_id": "registry.setWorkspaceVisibility",
+                    "path": "/workspaces/{workspace_id}/visibility",
+                    "stability": "stable",
+                    "summary": "Change a workspace's visibility",
+                    "visibility": "public"
                 }
             ],
-            "spec_sha256": "ec592109728b0e7c55eef4e8a0241a93590c739058d532990a31295ea2c8e993"
+            "spec_sha256": "d290102ee63724bda78bbb7138ba9072db9aa4d01bdae3a106acd727b971b612"
         },
         {
             "api_version": "v1",
@@ -762,7 +771,7 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "ce96938bf73abd861c01a4fd915a8830cd59a9302c23e8b8288b4bade0b8b7c9"
+            "spec_sha256": "744f5927f216bc3ed7da2fa43f06c97f8197b72d77c24ac8ef97598582d6e8e5"
         },
         {
             "api_version": "v1",
@@ -815,7 +824,7 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "d9cbe63b373ce00f518301fb3d9f926198c374a427eae2d826c03d4ffbba1980"
+            "spec_sha256": "e715f2be247e7209d78401d2d15602c081adc94a7194bfefc6a60020cf4d3287"
         },
         {
             "api_version": "v1",
@@ -1002,6 +1011,15 @@
                     "summary": "List an agent's sessions",
                     "visibility": "public"
                 },
+                {
+                    "error_contract": "native",
+                    "method": "POST",
+                    "operation_id": "agent.createSession",
+                    "path": "/agents/{agent_id}/sessions",
+                    "stability": "stable",
+                    "summary": "Trigger an agent run",
+                    "visibility": "public"
+                },
                 {
                     "error_contract": "native",
                     "method": "GET",
@@ -1534,7 +1552,7 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "35902315dbbf7b5be8fb0aa05b27c20d279ad1f6b45b069be19a54180c51808c"
+            "spec_sha256": "826ed751c40e27f9039f58a42d6955eb44613fc7f20f4a629c7cfbcb31aec9af"
         },
         {
             "api_version": "v1",
@@ -1632,14 +1650,69 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "5dccf52e16c7fa3f5d13305deae794123b640a7a47e79b7df2fa7864df706e4b"
+            "spec_sha256": "afc3aff4ae51935c22f0edba307ffeb0ccd8f4553d0a65e4a203d5ed731126bf"
         },
         {
             "api_version": "v1",
             "base_path": "/secret/v1",
             "name": "secret",
-            "operations": [],
-            "spec_sha256": "56a8707eee26044f33ce1a42775824866c6925af7f110b0ebfb29c6b52645b05"
+            "operations": [
+                {
+                    "error_contract": "native",
+                    "method": "GET",
+                    "operation_id": "secret.oauthCallback",
+                    "path": "/oauth/callback/{provider}",
+                    "stability": "stable",
+                    "summary": "`GET /<ext>/v1/oauth/callback/{provider}` — the provider's redirect target.",
+                    "visibility": "public"
+                },
+                {
+                    "error_contract": "native",
+                    "method": "POST",
+                    "operation_id": "secret.completeOauth",
+                    "path": "/oauth/complete",
+                    "stability": "stable",
+                    "summary": "`POST /<ext>/v1/oauth/complete` — polled until it answers `connected`.",
+                    "visibility": "public"
+                },
+                {
+                    "error_contract": "native",
+                    "method": "GET",
+                    "operation_id": "secret.listOauthConnections",
+                    "path": "/oauth/connections",
+                    "stability": "stable",
+                    "summary": "`GET /<ext>/v1/oauth/connections`.",
+                    "visibility": "public"
+                },
+                {
+                    "error_contract": "native",
+                    "method": "DELETE",
+                    "operation_id": "secret.disconnectOauth",
+                    "path": "/oauth/connections/{secret_id}",
+                    "stability": "stable",
+                    "summary": "`DELETE /<ext>/v1/oauth/connections/{secret_id}`.",
+                    "visibility": "public"
+                },
+                {
+                    "error_contract": "native",
+                    "method": "GET",
+                    "operation_id": "secret.listOauthProviders",
+                    "path": "/oauth/providers",
+                    "stability": "stable",
+                    "summary": "`GET /<ext>/v1/oauth/providers` — what can be connected, and the callback URL\nto register for each.",
+                    "visibility": "public"
+                },
+                {
+                    "error_contract": "native",
+                    "method": "POST",
+                    "operation_id": "secret.startOauth",
+                    "path": "/oauth/start",
+                    "stability": "stable",
+                    "summary": "`POST /<ext>/v1/oauth/start`.",
+                    "visibility": "public"
+                }
+            ],
+            "spec_sha256": "c855f6078dfc25e600930a9d5a9be59db749a65cf8e7b746251fd21fd99604b3"
         },
         {
             "api_version": "v1",
@@ -1692,7 +1765,7 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "ff80d12748878815053947ed431ab3711ca76aaf6464c01a87bcbf37b730e2c7"
+            "spec_sha256": "aff59c7f80ccdbbcaf50ca49dc7a8df37bcf3758212d6006befd4caf29693b41"
         },
         {
             "api_version": "v1",
@@ -2039,12 +2112,12 @@
                     "visibility": "public"
                 }
             ],
-            "spec_sha256": "db382cd7f3bc5e25aebe6b2ad1943a119a56b3800dc6547ab17e1f9a3a99d694"
+            "spec_sha256": "bd475939af81ccbc86afeb3946826aad6f293fc48c67d771d04a9fa549da6fd8"
         }
     ],
     "source": {
-        "fetched_at": "2026-09-15T10:30:09Z",
+        "fetched_at": "2026-09-17T12:52:47Z",
         "kind": "deployment",
-        "origin": "https://agentgateway.atlan.engineering"
+        "origin": "https://api.atlan.com"
     }
 }

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

@@ -20,6 +20,8 @@ import { type AgentArtifactAggregateResponse } from '../models/AgentArtifactAggr
 import { type AgentArtifactSearchRequest } from '../models/AgentArtifactSearchRequest';
 import { type AgentPageAgentArtifactView } from '../models/AgentPageAgentArtifactView';
 import { type AgentPageSessionArtifactView } from '../models/AgentPageSessionArtifactView';
+import { type AgentSessionArtifactView } from '../models/AgentSessionArtifactView';
+import { type TriggerBody } from '../models/TriggerBody';
 export interface AgentAggregateAgentsRequest {
     agentArtifactAggregateRequest: AgentArtifactAggregateRequest;
     contentEncoding?: AgentAggregateAgentsContentEncodingEnum;
@@ -31,6 +33,11 @@ export interface AgentCreateAgentRequest {
     agentAgentCreate: AgentAgentCreate;
     contentEncoding?: AgentCreateAgentContentEncodingEnum;
 }
+export interface AgentCreateSessionRequest {
+    agentId: string;
+    triggerBody: TriggerBody;
+    contentEncoding?: AgentCreateSessionContentEncodingEnum;
+}
 export interface AgentDeleteAgentProfileImageRequest {
     agentId: string;
 }
@@ -120,6 +127,20 @@ export declare class AgentsApi extends runtime.BaseAPI {
      * Create an agent
      */
     agentCreateAgent(requestParameters: AgentCreateAgentRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentAgentArtifactView>;
+    /**
+     * Creates request options for agentCreateSession without sending the request
+     */
+    agentCreateSessionRequestOpts(requestParameters: AgentCreateSessionRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Create a remote session for this agent on the named `agent_provider`, which must be `claude_managed` — the gateway executes nothing itself and dials no other provider type. Pushes the agent\'s spec (reusing the last pushed version when it is unchanged), ensures the agent\'s credential vault and sandbox environment exist, creates the remote session pinned to that version, queues the opening `user.message`, and records a governed `session` artifact carrying the remote handle. Returns that artifact.   There is no harness equivalent — a harness runs on the customer\'s machine and its transcript is uploaded.
+     * Trigger an agent run
+     */
+    agentCreateSessionRaw(requestParameters: AgentCreateSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentSessionArtifactView>>;
+    /**
+     * Create a remote session for this agent on the named `agent_provider`, which must be `claude_managed` — the gateway executes nothing itself and dials no other provider type. Pushes the agent\'s spec (reusing the last pushed version when it is unchanged), ensures the agent\'s credential vault and sandbox environment exist, creates the remote session pinned to that version, queues the opening `user.message`, and records a governed `session` artifact carrying the remote handle. Returns that artifact.   There is no harness equivalent — a harness runs on the customer\'s machine and its transcript is uploaded.
+     * Trigger an agent run
+     */
+    agentCreateSession(requestParameters: AgentCreateSessionRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentSessionArtifactView>;
     /**
      * Creates request options for agentDeleteAgentProfileImage without sending the request
      */
@@ -277,6 +298,14 @@ export declare enum AgentCreateAgentContentEncodingEnum {
     Base64 = "base64",
     GzipBase64 = "gzip, base64"
 }
+/**
+  * @export
+  * @enum {string}
+  */
+export declare enum AgentCreateSessionContentEncodingEnum {
+    Base64 = "base64",
+    GzipBase64 = "gzip, base64"
+}
 /**
   * @export
   * @enum {string}

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

@@ -46,7 +46,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AgentUploadAgentProfileImageContentEncodingEnum = exports.AgentSearchAgentsContentEncodingEnum = exports.AgentPatchAgentContentEncodingEnum = exports.AgentCreateAgentContentEncodingEnum = exports.AgentAggregateAgentsContentEncodingEnum = exports.AgentsApi = void 0;
+exports.AgentUploadAgentProfileImageContentEncodingEnum = exports.AgentSearchAgentsContentEncodingEnum = exports.AgentPatchAgentContentEncodingEnum = exports.AgentCreateSessionContentEncodingEnum = exports.AgentCreateAgentContentEncodingEnum = exports.AgentAggregateAgentsContentEncodingEnum = exports.AgentsApi = void 0;
 const runtime = __importStar(require("../runtime"));
 const AgentAgentArtifactView_1 = require("../models/AgentAgentArtifactView");
 const AgentAgentCreate_1 = require("../models/AgentAgentCreate");
@@ -58,6 +58,8 @@ const AgentArtifactAggregateResponse_1 = require("../models/AgentArtifactAggrega
 const AgentArtifactSearchRequest_1 = require("../models/AgentArtifactSearchRequest");
 const AgentPageAgentArtifactView_1 = require("../models/AgentPageAgentArtifactView");
 const AgentPageSessionArtifactView_1 = require("../models/AgentPageSessionArtifactView");
+const AgentSessionArtifactView_1 = require("../models/AgentSessionArtifactView");
+const TriggerBody_1 = require("../models/TriggerBody");
 /**
  *
  */
@@ -196,6 +198,56 @@ class AgentsApi extends runtime.BaseAPI {
         const response = await this.agentCreateAgentRaw(requestParameters, initOverrides);
         return await response.value();
     }
+    /**
+     * Creates request options for agentCreateSession without sending the request
+     */
+    async agentCreateSessionRequestOpts(requestParameters) {
+        if (requestParameters['agentId'] == null) {
+            throw new runtime.RequiredError('agentId', 'Required parameter "agentId" was null or undefined when calling agentCreateSession().');
+        }
+        if (requestParameters['triggerBody'] == null) {
+            throw new runtime.RequiredError('triggerBody', 'Required parameter "triggerBody" was null or undefined when calling agentCreateSession().');
+        }
+        const queryParameters = {};
+        const headerParameters = {};
+        headerParameters['Content-Type'] = 'application/json';
+        if (requestParameters['contentEncoding'] != null) {
+            headerParameters['Content-Encoding'] = String(requestParameters['contentEncoding']);
+        }
+        if (this.configuration && this.configuration.accessToken) {
+            const token = this.configuration.accessToken;
+            const tokenString = await token("bearer", []);
+            if (tokenString) {
+                headerParameters["Authorization"] = `Bearer ${tokenString}`;
+            }
+        }
+        let urlPath = `/agents/{agent_id}/sessions`;
+        urlPath = urlPath.replace('{agent_id}', encodeURIComponent(String(requestParameters['agentId'])));
+        return {
+            path: urlPath,
+            method: 'POST',
+            headers: headerParameters,
+            query: queryParameters,
+            body: (0, TriggerBody_1.TriggerBodyToJSON)(requestParameters['triggerBody']),
+        };
+    }
+    /**
+     * Create a remote session for this agent on the named `agent_provider`, which must be `claude_managed` — the gateway executes nothing itself and dials no other provider type. Pushes the agent\'s spec (reusing the last pushed version when it is unchanged), ensures the agent\'s credential vault and sandbox environment exist, creates the remote session pinned to that version, queues the opening `user.message`, and records a governed `session` artifact carrying the remote handle. Returns that artifact.   There is no harness equivalent — a harness runs on the customer\'s machine and its transcript is uploaded.
+     * Trigger an agent run
+     */
+    async agentCreateSessionRaw(requestParameters, initOverrides) {
+        const requestOptions = await this.agentCreateSessionRequestOpts(requestParameters);
+        const response = await this.request(requestOptions, initOverrides);
+        return new runtime.JSONApiResponse(response, (jsonValue) => (0, AgentSessionArtifactView_1.AgentSessionArtifactViewFromJSON)(jsonValue));
+    }
+    /**
+     * Create a remote session for this agent on the named `agent_provider`, which must be `claude_managed` — the gateway executes nothing itself and dials no other provider type. Pushes the agent\'s spec (reusing the last pushed version when it is unchanged), ensures the agent\'s credential vault and sandbox environment exist, creates the remote session pinned to that version, queues the opening `user.message`, and records a governed `session` artifact carrying the remote handle. Returns that artifact.   There is no harness equivalent — a harness runs on the customer\'s machine and its transcript is uploaded.
+     * Trigger an agent run
+     */
+    async agentCreateSession(requestParameters, initOverrides) {
+        const response = await this.agentCreateSessionRaw(requestParameters, initOverrides);
+        return await response.value();
+    }
     /**
      * Creates request options for agentDeleteAgentProfileImage without sending the request
      */
@@ -679,6 +731,15 @@ var AgentCreateAgentContentEncodingEnum;
     AgentCreateAgentContentEncodingEnum["Base64"] = "base64";
     AgentCreateAgentContentEncodingEnum["GzipBase64"] = "gzip, base64";
 })(AgentCreateAgentContentEncodingEnum || (exports.AgentCreateAgentContentEncodingEnum = AgentCreateAgentContentEncodingEnum = {}));
+/**
+  * @export
+  * @enum {string}
+  */
+var AgentCreateSessionContentEncodingEnum;
+(function (AgentCreateSessionContentEncodingEnum) {
+    AgentCreateSessionContentEncodingEnum["Base64"] = "base64";
+    AgentCreateSessionContentEncodingEnum["GzipBase64"] = "gzip, base64";
+})(AgentCreateSessionContentEncodingEnum || (exports.AgentCreateSessionContentEncodingEnum = AgentCreateSessionContentEncodingEnum = {}));
 /**
   * @export
   * @enum {string}

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

@@ -210,12 +210,12 @@ export declare class SessionsApi extends runtime.BaseAPI {
      */
     agentStreamEventsRequestOpts(requestParameters: AgentStreamEventsRequest): Promise<runtime.RequestOpts>;
     /**
-     * Tail the session\'s turns as Server-Sent Events until it reaches a terminal status. Each `data:` line is one JSON frame: an uploaded turn\'s metadata object, or — for an agent run on a `claude_managed` provider — a provider-native event, since the upstream SSE has no replay so the gateway polls the persisted history by watermark instead. A final `{\"type\":\"completed\"|\"failed\"}` frame closes the stream.   The stream also closes without a terminal frame if the tail exceeds its poll ceiling (~6 minutes), which bounds an orphaned connection — treat an absent terminal frame as \"still running\" and re-open.
+     * Tail the session\'s turns as Server-Sent Events until it reaches a terminal status. Each `data:` line is one JSON frame: an uploaded turn\'s metadata object, or — for an agent run on a `claude_managed` provider — a provider-native event, since the upstream SSE has no replay so the gateway polls the persisted history by watermark instead. A final `{\"type\":\"completed\"|\"failed\"}` frame closes the stream. Failures after headers carry a generic `error` in the failed terminal frame.   The stream also closes without a terminal frame if the tail exceeds its poll ceiling (~6 minutes), which bounds an orphaned connection — treat an absent terminal frame as \"still running\" and re-open.
      * Stream session turns over SSE
      */
     agentStreamEventsRaw(requestParameters: AgentStreamEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<AgentSessionStreamFrame>>;
     /**
-     * Tail the session\'s turns as Server-Sent Events until it reaches a terminal status. Each `data:` line is one JSON frame: an uploaded turn\'s metadata object, or — for an agent run on a `claude_managed` provider — a provider-native event, since the upstream SSE has no replay so the gateway polls the persisted history by watermark instead. A final `{\"type\":\"completed\"|\"failed\"}` frame closes the stream.   The stream also closes without a terminal frame if the tail exceeds its poll ceiling (~6 minutes), which bounds an orphaned connection — treat an absent terminal frame as \"still running\" and re-open.
+     * Tail the session\'s turns as Server-Sent Events until it reaches a terminal status. Each `data:` line is one JSON frame: an uploaded turn\'s metadata object, or — for an agent run on a `claude_managed` provider — a provider-native event, since the upstream SSE has no replay so the gateway polls the persisted history by watermark instead. A final `{\"type\":\"completed\"|\"failed\"}` frame closes the stream. Failures after headers carry a generic `error` in the failed terminal frame.   The stream also closes without a terminal frame if the tail exceeds its poll ceiling (~6 minutes), which bounds an orphaned connection — treat an absent terminal frame as \"still running\" and re-open.
      * Stream session turns over SSE
      */
     agentStreamEvents(requestParameters: AgentStreamEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<AgentSessionStreamFrame>;

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

@@ -532,7 +532,7 @@ class SessionsApi extends runtime.BaseAPI {
         };
     }
     /**
-     * Tail the session\'s turns as Server-Sent Events until it reaches a terminal status. Each `data:` line is one JSON frame: an uploaded turn\'s metadata object, or — for an agent run on a `claude_managed` provider — a provider-native event, since the upstream SSE has no replay so the gateway polls the persisted history by watermark instead. A final `{\"type\":\"completed\"|\"failed\"}` frame closes the stream.   The stream also closes without a terminal frame if the tail exceeds its poll ceiling (~6 minutes), which bounds an orphaned connection — treat an absent terminal frame as \"still running\" and re-open.
+     * Tail the session\'s turns as Server-Sent Events until it reaches a terminal status. Each `data:` line is one JSON frame: an uploaded turn\'s metadata object, or — for an agent run on a `claude_managed` provider — a provider-native event, since the upstream SSE has no replay so the gateway polls the persisted history by watermark instead. A final `{\"type\":\"completed\"|\"failed\"}` frame closes the stream. Failures after headers carry a generic `error` in the failed terminal frame.   The stream also closes without a terminal frame if the tail exceeds its poll ceiling (~6 minutes), which bounds an orphaned connection — treat an absent terminal frame as \"still running\" and re-open.
      * Stream session turns over SSE
      */
     async agentStreamEventsRaw(requestParameters, initOverrides) {
@@ -541,7 +541,7 @@ class SessionsApi extends runtime.BaseAPI {
         return new runtime.JSONApiResponse(response, (jsonValue) => (0, AgentSessionStreamFrame_1.AgentSessionStreamFrameFromJSON)(jsonValue));
     }
     /**
-     * Tail the session\'s turns as Server-Sent Events until it reaches a terminal status. Each `data:` line is one JSON frame: an uploaded turn\'s metadata object, or — for an agent run on a `claude_managed` provider — a provider-native event, since the upstream SSE has no replay so the gateway polls the persisted history by watermark instead. A final `{\"type\":\"completed\"|\"failed\"}` frame closes the stream.   The stream also closes without a terminal frame if the tail exceeds its poll ceiling (~6 minutes), which bounds an orphaned connection — treat an absent terminal frame as \"still running\" and re-open.
+     * Tail the session\'s turns as Server-Sent Events until it reaches a terminal status. Each `data:` line is one JSON frame: an uploaded turn\'s metadata object, or — for an agent run on a `claude_managed` provider — a provider-native event, since the upstream SSE has no replay so the gateway polls the persisted history by watermark instead. A final `{\"type\":\"completed\"|\"failed\"}` frame closes the stream. Failures after headers carry a generic `error` in the failed terminal frame.   The stream also closes without a terminal frame if the tail exceeds its poll ceiling (~6 minutes), which bounds an orphaned connection — treat an absent terminal frame as \"still running\" and re-open.
      * Stream session turns over SSE
      */
     async agentStreamEvents(requestParameters, initOverrides) {

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

@@ -12,6 +12,7 @@
 import type { GatewayArtifactIdentityRevealView } from './GatewayArtifactIdentityRevealView';
 import type { GatewayToolRef } from './GatewayToolRef';
 import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
+import type { AgentSyncState } from './AgentSyncState';
 /**
  * An `agent` artifact: the shared artifact fields, its typed metadata, and the
  * derived address of its profile image.
@@ -340,6 +341,53 @@ export interface AgentAgentArtifactView {
      * @memberof AgentAgentArtifactView
      */
     publicUrl?: string | null;
+    /**
+     * The provider's remote agent id this row is synced to. Hook-owned.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    remoteAgentId?: string | null;
+    /**
+     * The remote vault holding this agent's gateway credential, provisioned
+     * lazily at the first run-trigger. Hook-owned.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    remoteVaultId?: string | null;
+    /**
+     * The immutable remote agent version the last push minted. Hook-owned.
+     *
+     * Gateway versions map 1:1 onto the provider's immutable agent versions, and
+     * a session pins `{id, version}` — so a spec edit after a run cannot
+     * retroactively change what that run executed.
+     * @type {number}
+     * @memberof AgentAgentArtifactView
+     */
+    remoteVersionOrdinal?: number | null;
+    /**
+     * The last remote-sync failure's bounded gateway code, so a failed push is
+     * visible on a `GET` without persisting the provider's response text.
+     * Hook-owned.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    syncError?: string | null;
+    /**
+     * Value of the `sync_state` field.
+     * @type {AgentSyncState}
+     * @memberof AgentAgentArtifactView
+     */
+    syncState?: AgentSyncState | null;
+    /**
+     * A hash of the spec fields that map onto the remote agent config
+     * (`instructions`, `model_id`, `tools`, `max_step_count`). A re-trigger reuses
+     * the pushed version when it matches and pushes a new one when it does not,
+     * so repeated runs of an unchanged agent do not mint a version each time.
+     * Hook-owned.
+     * @type {string}
+     * @memberof AgentAgentArtifactView
+     */
+    syncedSpecHash?: string | null;
     /**
      * Declarative tool references the agent may call.
      * @type {Array<GatewayToolRef>}

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

@@ -21,6 +21,7 @@ exports.AgentAgentArtifactViewToJSONTyped = AgentAgentArtifactViewToJSONTyped;
 const GatewayArtifactIdentityRevealView_1 = require("./GatewayArtifactIdentityRevealView");
 const GatewayToolRef_1 = require("./GatewayToolRef");
 const RegistryRelationshipsView_1 = require("./RegistryRelationshipsView");
+const AgentSyncState_1 = require("./AgentSyncState");
 /**
  * Check if a given object implements the AgentAgentArtifactView interface.
  */
@@ -101,6 +102,12 @@ function AgentAgentArtifactViewFromJSONTyped(json, ignoreDiscriminator) {
         'maxStepCount': json['max_step_count'] == null ? undefined : json['max_step_count'],
         'modelId': json['model_id'] === undefined ? undefined : json['model_id'] === null ? null : json['model_id'],
         'publicUrl': json['public_url'] === undefined ? undefined : json['public_url'] === null ? null : json['public_url'],
+        'remoteAgentId': json['remote_agent_id'] === undefined ? undefined : json['remote_agent_id'] === null ? null : json['remote_agent_id'],
+        'remoteVaultId': json['remote_vault_id'] === undefined ? undefined : json['remote_vault_id'] === null ? null : json['remote_vault_id'],
+        'remoteVersionOrdinal': json['remote_version_ordinal'] === undefined ? undefined : json['remote_version_ordinal'] === null ? null : json['remote_version_ordinal'],
+        'syncError': json['sync_error'] === undefined ? undefined : json['sync_error'] === null ? null : json['sync_error'],
+        'syncState': json['sync_state'] === undefined ? undefined : json['sync_state'] === null ? null : (0, AgentSyncState_1.AgentSyncStateFromJSON)(json['sync_state']),
+        'syncedSpecHash': json['synced_spec_hash'] === undefined ? undefined : json['synced_spec_hash'] === null ? null : json['synced_spec_hash'],
         'tools': json['tools'] == null ? undefined : (json['tools'].map(GatewayToolRef_1.GatewayToolRefFromJSON)),
         'permissions': json['permissions'] === undefined ? undefined : json['permissions'] === null ? null : json['permissions'],
         'profileImageUrl': json['profile_image_url'] === undefined ? undefined : json['profile_image_url'] === null ? null : json['profile_image_url'],
@@ -155,6 +162,12 @@ function AgentAgentArtifactViewToJSONTyped(value, ignoreDiscriminator = false) {
         'max_step_count': value['maxStepCount'],
         'model_id': value['modelId'],
         'public_url': value['publicUrl'],
+        'remote_agent_id': value['remoteAgentId'],
+        'remote_vault_id': value['remoteVaultId'],
+        'remote_version_ordinal': value['remoteVersionOrdinal'],
+        'sync_error': value['syncError'],
+        'sync_state': (0, AgentSyncState_1.AgentSyncStateToJSON)(value['syncState']),
+        'synced_spec_hash': value['syncedSpecHash'],
         'tools': value['tools'] == null ? undefined : (value['tools'].map(GatewayToolRef_1.GatewayToolRefToJSON)),
         'permissions': value['permissions'],
         'profile_image_url': value['profileImageUrl'],

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

@@ -304,6 +304,18 @@ export interface AgentAgentEnvironmentArtifactView {
      * @memberof AgentAgentEnvironmentArtifactView
      */
     packages?: AgentEnvironmentPackages;
+    /**
+     * The provider's id for the sandbox template this row was pushed to.
+     * Hook-owned, and set only once a run on a delegating provider has pushed it.
+     *
+     * Environments are **unversioned** on the provider, so there is nothing to
+     * optimistic-lock against: a config change archives the pushed template and
+     * clears this, and the next trigger re-creates one. That is why the column is
+     * nullable rather than a permanent handle.
+     * @type {string}
+     * @memberof AgentAgentEnvironmentArtifactView
+     */
+    remoteEnvironmentId?: string | null;
     /**
      * Value of the `permissions` field.
      * @type {{ [key: string]: boolean; }}

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

@@ -104,6 +104,7 @@ function AgentAgentEnvironmentArtifactViewFromJSONTyped(json, ignoreDiscriminato
         'isSystem': json['is_system'] == null ? undefined : json['is_system'],
         'networkMode': json['network_mode'] == null ? undefined : (0, AgentNetworkMode_1.AgentNetworkModeFromJSON)(json['network_mode']),
         'packages': json['packages'] == null ? undefined : (0, AgentEnvironmentPackages_1.AgentEnvironmentPackagesFromJSON)(json['packages']),
+        'remoteEnvironmentId': json['remote_environment_id'] === undefined ? undefined : json['remote_environment_id'] === null ? null : json['remote_environment_id'],
         'permissions': json['permissions'] === undefined ? undefined : json['permissions'] === null ? null : json['permissions'],
         'relationships': json['relationships'] === undefined ? undefined : json['relationships'] === null ? null : (0, RegistryRelationshipsView_1.RegistryRelationshipsViewFromJSON)(json['relationships']),
     };
@@ -157,6 +158,7 @@ function AgentAgentEnvironmentArtifactViewToJSONTyped(value, ignoreDiscriminator
         'is_system': value['isSystem'],
         'network_mode': (0, AgentNetworkMode_1.AgentNetworkModeToJSON)(value['networkMode']),
         'packages': (0, AgentEnvironmentPackages_1.AgentEnvironmentPackagesToJSON)(value['packages']),
+        'remote_environment_id': value['remoteEnvironmentId'],
         'permissions': value['permissions'],
         'relationships': (0, RegistryRelationshipsView_1.RegistryRelationshipsViewToJSON)(value['relationships']),
     };

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

@@ -70,6 +70,18 @@ export interface AgentAgentEnvironmentMeta {
      * @memberof AgentAgentEnvironmentMeta
      */
     packages?: AgentEnvironmentPackages;
+    /**
+     * The provider's id for the sandbox template this row was pushed to.
+     * Hook-owned, and set only once a run on a delegating provider has pushed it.
+     *
+     * Environments are **unversioned** on the provider, so there is nothing to
+     * optimistic-lock against: a config change archives the pushed template and
+     * clears this, and the next trigger re-creates one. That is why the column is
+     * nullable rather than a permanent handle.
+     * @type {string}
+     * @memberof AgentAgentEnvironmentMeta
+     */
+    remoteEnvironmentId?: string | null;
 }
 /**
  * Check if a given object implements the AgentAgentEnvironmentMeta interface.

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

@@ -47,6 +47,7 @@ function AgentAgentEnvironmentMetaFromJSONTyped(json, ignoreDiscriminator) {
         'isSystem': json['is_system'] == null ? undefined : json['is_system'],
         'networkMode': (0, AgentNetworkMode_1.AgentNetworkModeFromJSON)(json['network_mode']),
         'packages': json['packages'] == null ? undefined : (0, AgentEnvironmentPackages_1.AgentEnvironmentPackagesFromJSON)(json['packages']),
+        'remoteEnvironmentId': json['remote_environment_id'] === undefined ? undefined : json['remote_environment_id'] === null ? null : json['remote_environment_id'],
     };
 }
 function AgentAgentEnvironmentMetaToJSON(json) {
@@ -65,5 +66,6 @@ function AgentAgentEnvironmentMetaToJSONTyped(value, ignoreDiscriminator = false
         'is_system': value['isSystem'],
         'network_mode': (0, AgentNetworkMode_1.AgentNetworkModeToJSON)(value['networkMode']),
         'packages': (0, AgentEnvironmentPackages_1.AgentEnvironmentPackagesToJSON)(value['packages']),
+        'remote_environment_id': value['remoteEnvironmentId'],
     };
 }

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

@@ -10,6 +10,7 @@
  * Do not edit the class manually.
  */
 import type { GatewayToolRef } from './GatewayToolRef';
+import type { AgentSyncState } from './AgentSyncState';
 /**
  * The `agent` artifact kind: something that runs autonomously somewhere, as
  * opposed to a [`HarnessMeta`], which is a tool a human drives.
@@ -114,6 +115,53 @@ export interface AgentAgentMeta {
      * @memberof AgentAgentMeta
      */
     publicUrl?: string | null;
+    /**
+     * The provider's remote agent id this row is synced to. Hook-owned.
+     * @type {string}
+     * @memberof AgentAgentMeta
+     */
+    remoteAgentId?: string | null;
+    /**
+     * The remote vault holding this agent's gateway credential, provisioned
+     * lazily at the first run-trigger. Hook-owned.
+     * @type {string}
+     * @memberof AgentAgentMeta
+     */
+    remoteVaultId?: string | null;
+    /**
+     * The immutable remote agent version the last push minted. Hook-owned.
+     *
+     * Gateway versions map 1:1 onto the provider's immutable agent versions, and
+     * a session pins `{id, version}` — so a spec edit after a run cannot
+     * retroactively change what that run executed.
+     * @type {number}
+     * @memberof AgentAgentMeta
+     */
+    remoteVersionOrdinal?: number | null;
+    /**
+     * The last remote-sync failure's bounded gateway code, so a failed push is
+     * visible on a `GET` without persisting the provider's response text.
+     * Hook-owned.
+     * @type {string}
+     * @memberof AgentAgentMeta
+     */
+    syncError?: string | null;
+    /**
+     * Value of the `sync_state` field.
+     * @type {AgentSyncState}
+     * @memberof AgentAgentMeta
+     */
+    syncState?: AgentSyncState | null;
+    /**
+     * A hash of the spec fields that map onto the remote agent config
+     * (`instructions`, `model_id`, `tools`, `max_step_count`). A re-trigger reuses
+     * the pushed version when it matches and pushes a new one when it does not,
+     * so repeated runs of an unchanged agent do not mint a version each time.
+     * Hook-owned.
+     * @type {string}
+     * @memberof AgentAgentMeta
+     */
+    syncedSpecHash?: string | null;
     /**
      * Declarative tool references the agent may call.
      * @type {Array<GatewayToolRef>}