@atlanai/sdk 0.2.4 → 0.3.1

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

@@ -14,19 +14,37 @@ import type { AgentOutputMode } from './AgentOutputMode';
 import type { AgentSubjectKind } from './AgentSubjectKind';
 import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
 /**
- * Published representation of OutputArtifact.
+ *
  * @export
  * @interface AgentOutputArtifactView
  */
 export interface AgentOutputArtifactView {
     /**
-     * Value of the `app` field.
+     * The extension that registered the kind.
+     *
+     * `#[serde(default)]` because the registry's **L1** view omits it: `registry_http::artifact`
+     * serves `l1_view` — deliberately kind-polymorphic, deliberately without an extension name —
+     * from ranked search and from archive. Without the default, `flatten` being a whitelist made
+     * the absence a hard decode failure, so *every* extension-scoped `POST …/search` and
+     * `POST …/{id}/archive` answered `500 unexpected registry response shape` the moment a row came
+     * back. Empty result sets decoded fine, which is why it read as working.
+     *
+     * The archive case was the worse of the two: the write had already committed, so the caller saw
+     * a 500 for a request that succeeded.
+     *
+     * Serialization skips it when empty rather than emitting `""`, so a typed view built from an L1
+     * row **omits** the field exactly as the registry's own L1 row does. A client that needs it for
+     * a search hit resolves it from `kind` through `GET /kinds`, which is the same lookup the
+     * registry would do.
+     *
+     * Named `extension` until `apps-2026-09-15-the-extension-tables-are-dropped`; renamed with no
+     * alias, matching the registry's own `ArtifactView`.
      * @type {string}
      * @memberof AgentOutputArtifactView
      */
     app?: string;
     /**
-     * Value of the `artifact_status` field.
+     *
      * @type {string}
      * @memberof AgentOutputArtifactView
      */
@@ -38,31 +56,57 @@ export interface AgentOutputArtifactView {
      */
     commitTs: string;
     /**
-     * Value of the `content_hash_hex` field.
+     * BLAKE3 (hex) of the canonicalised per-kind properties — the artifact's `ETag`, and the
+     * `If-Match` precondition's subject. Named `_hex` for the shipped contract's sake.
+     *
+     * `#[serde(default)]` for the same reason `extension` above has one, and this is the second
+     * time that reason has cost every extension its read surface. The registry types the field
+     * `Option<String>` and **omits** it when the row's `content_hash` is NULL
+     * (`registry_http::ArtifactView`), populating it straight from the nullable column; `flatten`
+     * is a whitelist, so a bare `String` here made that omission a hard decode failure — every
+     * `skill`, `mcp` and `agent` read answered `500 unexpected registry response shape` for a
+     * request the registry had served correctly, while the registry's own `/artifacts` surface
+     * kept working and made it read as an extension bug.
+     *
+     * The absence is legitimate, which is why the fix is here and not a backfill: no write path
+     * leaves the column NULL, but the spanner→postgres mover deliberately **invalidates** every
+     * migrated hash — Spanner hashed `sha256(jcs(metadata))` and this stack hashes
+     * `blake3(write_canonical(metadata))`, so a carried-over digest could never match a
+     * recomputation. A migrated artifact has no hash until its next property write recomputes
+     * one, so a caller that wants a conditional write against it sends `*` or no `If-Match`.
+     *
+     * Skipped on the way out rather than serialized as `null`, so a typed per-kind view renders
+     * exactly the shape the registry served.
      * @type {string}
      * @memberof AgentOutputArtifactView
      */
     contentHashHex?: string;
     /**
-     * Value of the `created_at` field.
+     *
      * @type {string}
      * @memberof AgentOutputArtifactView
      */
     createdAt: string;
     /**
-     * Value of the `created_by` field.
+     *
      * @type {string}
      * @memberof AgentOutputArtifactView
      */
     createdBy: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof AgentOutputArtifactView
      */
     description?: string;
     /**
-     * Human-readable name.
+     * Human-readable label. The registry defaults it to `name` when a create
+     * body omits it, so it is always present on read and never null. Edit it
+     * freely without moving `name`.
+     *
+     * `#[serde(default)]` because `flatten` is a whitelist: without it, a view
+     * deserialized from a registry that predates this field would fail rather
+     * than fall back.
      * @type {string}
      * @memberof AgentOutputArtifactView
      */
@@ -74,7 +118,7 @@ export interface AgentOutputArtifactView {
      */
     id: string;
     /**
-     * Value of the `identity` field.
+     *
      * @type {GatewayArtifactIdentityRevealView}
      * @memberof AgentOutputArtifactView
      */
@@ -86,7 +130,7 @@ export interface AgentOutputArtifactView {
      */
     isLatest: boolean;
     /**
-     * Domain discriminator for this resource.
+     *
      * @type {string}
      * @memberof AgentOutputArtifactView
      */
@@ -222,13 +266,13 @@ export interface AgentOutputArtifactView {
      */
     sourceVersion?: string;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof AgentOutputArtifactView
      */
     updatedAt: string;
     /**
-     * Value of the `updated_by` field.
+     *
      * @type {string}
      * @memberof AgentOutputArtifactView
      */
@@ -313,13 +357,22 @@ export interface AgentOutputArtifactView {
      */
     subjectId?: string | null;
     /**
-     * Value of the `subject_kind` field.
+     *
      * @type {AgentSubjectKind}
      * @memberof AgentOutputArtifactView
      */
     subjectKind?: AgentSubjectKind | null;
     /**
-     * Value of the `permissions` field.
+     * The caller's advisory `can_*` capability matrix on a resource.
+     *
+     * Advisory only: it reflects what the caller may do, and is for a UI to gate
+     * controls on. It never authorizes a request — the platform decides that
+     * independently on every call.
+     *
+     * Deliberately an open map rather than a typed struct. The authoritative
+     * permission tables are internal to the platform core, and lifting them into the
+     * SDK would put an authorization decision surface into every extension. An
+     * extension reads this matrix; it never derives one.
      * @type {{ [key: string]: boolean; }}
      * @memberof AgentOutputArtifactView
      */
@@ -327,7 +380,7 @@ export interface AgentOutputArtifactView {
         [key: string]: boolean;
     } | null;
     /**
-     * Value of the `relationships` field.
+     *
      * @type {RegistryRelationshipsView}
      * @memberof AgentOutputArtifactView
      */

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

@@ -91,7 +91,7 @@ export interface AgentOutputCreate {
      */
     sourceVersion?: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof AgentOutputCreate
      */
@@ -181,7 +181,7 @@ export interface AgentOutputCreate {
      */
     subjectId?: string | null;
     /**
-     * Value of the `subject_kind` field.
+     *
      * @type {AgentSubjectKind}
      * @memberof AgentOutputCreate
      */

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

@@ -97,7 +97,7 @@ export interface AgentOutputMeta {
      */
     subjectId?: string | null;
     /**
-     * Value of the `subject_kind` field.
+     *
      * @type {AgentSubjectKind}
      * @memberof AgentOutputMeta
      */

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

@@ -34,13 +34,13 @@ export interface AgentOutputPatch {
      */
     description?: string | null;
     /**
-     * Human-readable name.
+     *
      * @type {string}
      * @memberof AgentOutputPatch
      */
     displayName?: string | null;
     /**
-     * Stable machine-readable name.
+     *
      * @type {string}
      * @memberof AgentOutputPatch
      */
@@ -52,13 +52,13 @@ export interface AgentOutputPatch {
      */
     sessionId?: string | null;
     /**
-     * Stable identifier of the related subject resource.
+     *
      * @type {string}
      * @memberof AgentOutputPatch
      */
     subjectId?: string | null;
     /**
-     * Value of the `subject_kind` field.
+     *
      * @type {AgentSubjectKind}
      * @memberof AgentOutputPatch
      */

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

@@ -23,19 +23,19 @@ import type { AgentSubjectKind } from './AgentSubjectKind';
  */
 export interface AgentOutputVersionCreate {
     /**
-     * Value of the `external_url` field.
+     *
      * @type {string}
      * @memberof AgentOutputVersionCreate
      */
     externalUrl?: string | null;
     /**
-     * Stable identifier of the related file artifact resource.
+     *
      * @type {string}
      * @memberof AgentOutputVersionCreate
      */
     fileArtifactId?: string | null;
     /**
-     * Value of the `file_version_ordinal` field.
+     *
      * @type {number}
      * @memberof AgentOutputVersionCreate
      */
@@ -47,19 +47,19 @@ export interface AgentOutputVersionCreate {
      */
     mode: AgentOutputMode;
     /**
-     * Stable identifier of the related session resource.
+     *
      * @type {string}
      * @memberof AgentOutputVersionCreate
      */
     sessionId?: string | null;
     /**
-     * Stable identifier of the related subject resource.
+     *
      * @type {string}
      * @memberof AgentOutputVersionCreate
      */
     subjectId?: string | null;
     /**
-     * Value of the `subject_kind` field.
+     *
      * @type {AgentSubjectKind}
      * @memberof AgentOutputVersionCreate
      */

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

@@ -19,7 +19,7 @@ import type { GatewayPageMeta } from './GatewayPageMeta';
  */
 export interface AgentPageAgentArtifactView {
     /**
-     * Items in this result.
+     *
      * @type {Array<AgentAgentArtifactView>}
      * @memberof AgentPageAgentArtifactView
      */

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

@@ -19,7 +19,7 @@ import type { GatewayPageMeta } from './GatewayPageMeta';
  */
 export interface AgentPageSessionEventView {
     /**
-     * Items in this result.
+     *
      * @type {Array<AgentSessionEventView>}
      * @memberof AgentPageSessionEventView
      */

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

@@ -22,25 +22,25 @@ export interface AgentPatchAgentFramework412Response {
      */
     code: AgentPatchAgentFramework412ResponseCodeEnum;
     /**
-     * Value of the `detail` field.
+     *
      * @type {string}
      * @memberof AgentPatchAgentFramework412Response
      */
     detail: string;
     /**
-     * Current lifecycle state.
+     *
      * @type {number}
      * @memberof AgentPatchAgentFramework412Response
      */
     status: number;
     /**
-     * Value of the `title` field.
+     *
      * @type {string}
      * @memberof AgentPatchAgentFramework412Response
      */
     title: string;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof AgentPatchAgentFramework412Response
      */

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

@@ -22,25 +22,25 @@ export interface AgentQueryAgentTraceStats400Response {
      */
     code: AgentQueryAgentTraceStats400ResponseCodeEnum;
     /**
-     * Value of the `detail` field.
+     *
      * @type {string}
      * @memberof AgentQueryAgentTraceStats400Response
      */
     detail: string;
     /**
-     * Current lifecycle state.
+     *
      * @type {number}
      * @memberof AgentQueryAgentTraceStats400Response
      */
     status: number;
     /**
-     * Value of the `title` field.
+     *
      * @type {string}
      * @memberof AgentQueryAgentTraceStats400Response
      */
     title: string;
     /**
-     * Stable identifier of the related trace resource.
+     *
      * @type {string}
      * @memberof AgentQueryAgentTraceStats400Response
      */

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

@@ -18,19 +18,37 @@ import type { AgentSessionStatus } from './AgentSessionStatus';
 import type { AgentVisitorType } from './AgentVisitorType';
 import type { RegistryRelationshipsView } from './RegistryRelationshipsView';
 /**
- * Published representation of SessionArtifact.
+ *
  * @export
  * @interface AgentSessionArtifactView
  */
 export interface AgentSessionArtifactView {
     /**
-     * Value of the `app` field.
+     * The extension that registered the kind.
+     *
+     * `#[serde(default)]` because the registry's **L1** view omits it: `registry_http::artifact`
+     * serves `l1_view` — deliberately kind-polymorphic, deliberately without an extension name —
+     * from ranked search and from archive. Without the default, `flatten` being a whitelist made
+     * the absence a hard decode failure, so *every* extension-scoped `POST …/search` and
+     * `POST …/{id}/archive` answered `500 unexpected registry response shape` the moment a row came
+     * back. Empty result sets decoded fine, which is why it read as working.
+     *
+     * The archive case was the worse of the two: the write had already committed, so the caller saw
+     * a 500 for a request that succeeded.
+     *
+     * Serialization skips it when empty rather than emitting `""`, so a typed view built from an L1
+     * row **omits** the field exactly as the registry's own L1 row does. A client that needs it for
+     * a search hit resolves it from `kind` through `GET /kinds`, which is the same lookup the
+     * registry would do.
+     *
+     * Named `extension` until `apps-2026-09-15-the-extension-tables-are-dropped`; renamed with no
+     * alias, matching the registry's own `ArtifactView`.
      * @type {string}
      * @memberof AgentSessionArtifactView
      */
     app?: string;
     /**
-     * Value of the `artifact_status` field.
+     *
      * @type {string}
      * @memberof AgentSessionArtifactView
      */
@@ -42,31 +60,57 @@ export interface AgentSessionArtifactView {
      */
     commitTs: string;
     /**
-     * Value of the `content_hash_hex` field.
+     * BLAKE3 (hex) of the canonicalised per-kind properties — the artifact's `ETag`, and the
+     * `If-Match` precondition's subject. Named `_hex` for the shipped contract's sake.
+     *
+     * `#[serde(default)]` for the same reason `extension` above has one, and this is the second
+     * time that reason has cost every extension its read surface. The registry types the field
+     * `Option<String>` and **omits** it when the row's `content_hash` is NULL
+     * (`registry_http::ArtifactView`), populating it straight from the nullable column; `flatten`
+     * is a whitelist, so a bare `String` here made that omission a hard decode failure — every
+     * `skill`, `mcp` and `agent` read answered `500 unexpected registry response shape` for a
+     * request the registry had served correctly, while the registry's own `/artifacts` surface
+     * kept working and made it read as an extension bug.
+     *
+     * The absence is legitimate, which is why the fix is here and not a backfill: no write path
+     * leaves the column NULL, but the spanner→postgres mover deliberately **invalidates** every
+     * migrated hash — Spanner hashed `sha256(jcs(metadata))` and this stack hashes
+     * `blake3(write_canonical(metadata))`, so a carried-over digest could never match a
+     * recomputation. A migrated artifact has no hash until its next property write recomputes
+     * one, so a caller that wants a conditional write against it sends `*` or no `If-Match`.
+     *
+     * Skipped on the way out rather than serialized as `null`, so a typed per-kind view renders
+     * exactly the shape the registry served.
      * @type {string}
      * @memberof AgentSessionArtifactView
      */
     contentHashHex?: string;
     /**
-     * Value of the `created_at` field.
+     *
      * @type {string}
      * @memberof AgentSessionArtifactView
      */
     createdAt: string;
     /**
-     * Value of the `created_by` field.
+     *
      * @type {string}
      * @memberof AgentSessionArtifactView
      */
     createdBy: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof AgentSessionArtifactView
      */
     description?: string;
     /**
-     * Human-readable name.
+     * Human-readable label. The registry defaults it to `name` when a create
+     * body omits it, so it is always present on read and never null. Edit it
+     * freely without moving `name`.
+     *
+     * `#[serde(default)]` because `flatten` is a whitelist: without it, a view
+     * deserialized from a registry that predates this field would fail rather
+     * than fall back.
      * @type {string}
      * @memberof AgentSessionArtifactView
      */
@@ -78,7 +122,7 @@ export interface AgentSessionArtifactView {
      */
     id: string;
     /**
-     * Value of the `identity` field.
+     *
      * @type {GatewayArtifactIdentityRevealView}
      * @memberof AgentSessionArtifactView
      */
@@ -90,7 +134,7 @@ export interface AgentSessionArtifactView {
      */
     isLatest: boolean;
     /**
-     * Domain discriminator for this resource.
+     *
      * @type {string}
      * @memberof AgentSessionArtifactView
      */
@@ -226,13 +270,13 @@ export interface AgentSessionArtifactView {
      */
     sourceVersion?: string;
     /**
-     * Value of the `updated_at` field.
+     *
      * @type {string}
      * @memberof AgentSessionArtifactView
      */
     updatedAt: string;
     /**
-     * Value of the `updated_by` field.
+     *
      * @type {string}
      * @memberof AgentSessionArtifactView
      */
@@ -266,7 +310,7 @@ export interface AgentSessionArtifactView {
      */
     agentProviderId?: string | null;
     /**
-     * Value of the `agent_provider_type` field.
+     *
      * @type {AgentAgentProviderType}
      * @memberof AgentSessionArtifactView
      */
@@ -424,7 +468,7 @@ export interface AgentSessionArtifactView {
      */
     visitorName?: string | null;
     /**
-     * Value of the `visitor_type` field.
+     *
      * @type {AgentVisitorType}
      * @memberof AgentSessionArtifactView
      */
@@ -439,7 +483,16 @@ export interface AgentSessionArtifactView {
      */
     visitorUserId?: string | null;
     /**
-     * Value of the `permissions` field.
+     * The caller's advisory `can_*` capability matrix on a resource.
+     *
+     * Advisory only: it reflects what the caller may do, and is for a UI to gate
+     * controls on. It never authorizes a request — the platform decides that
+     * independently on every call.
+     *
+     * Deliberately an open map rather than a typed struct. The authoritative
+     * permission tables are internal to the platform core, and lifting them into the
+     * SDK would put an authorization decision surface into every extension. An
+     * extension reads this matrix; it never derives one.
      * @type {{ [key: string]: boolean; }}
      * @memberof AgentSessionArtifactView
      */
@@ -447,7 +500,7 @@ export interface AgentSessionArtifactView {
         [key: string]: boolean;
     } | null;
     /**
-     * Value of the `relationships` field.
+     *
      * @type {RegistryRelationshipsView}
      * @memberof AgentSessionArtifactView
      */

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

@@ -94,7 +94,7 @@ export interface AgentSessionCreate {
      */
     sourceVersion?: string;
     /**
-     * Human-readable description.
+     *
      * @type {string}
      * @memberof AgentSessionCreate
      */
@@ -260,7 +260,7 @@ export interface AgentSessionCreate {
      */
     visitorName?: string | null;
     /**
-     * Value of the `visitor_type` field.
+     *
      * @type {AgentVisitorType}
      * @memberof AgentSessionCreate
      */

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

@@ -0,0 +1,38 @@
+/**
+ * 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.
+ */
+/**
+ * Acknowledgement of a relayed session event.
+ * @export
+ * @interface AgentSessionEventAck
+ */
+export interface AgentSessionEventAck {
+    /**
+     * Always `true` — the provider accepted the event.
+     * @type {boolean}
+     * @memberof AgentSessionEventAck
+     */
+    queued: boolean;
+    /**
+     * The event type queued, echoed from the request.
+     * @type {string}
+     * @memberof AgentSessionEventAck
+     */
+    type: string;
+}
+/**
+ * Check if a given object implements the AgentSessionEventAck interface.
+ */
+export declare function instanceOfAgentSessionEventAck(value: object): value is AgentSessionEventAck;
+export declare function AgentSessionEventAckFromJSON(json: any): AgentSessionEventAck;
+export declare function AgentSessionEventAckFromJSONTyped(json: any, ignoreDiscriminator: boolean): AgentSessionEventAck;
+export declare function AgentSessionEventAckToJSON(json: any): AgentSessionEventAck;
+export declare function AgentSessionEventAckToJSONTyped(value?: AgentSessionEventAck | null, ignoreDiscriminator?: boolean): any;

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

@@ -0,0 +1,54 @@
+"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.instanceOfAgentSessionEventAck = instanceOfAgentSessionEventAck;
+exports.AgentSessionEventAckFromJSON = AgentSessionEventAckFromJSON;
+exports.AgentSessionEventAckFromJSONTyped = AgentSessionEventAckFromJSONTyped;
+exports.AgentSessionEventAckToJSON = AgentSessionEventAckToJSON;
+exports.AgentSessionEventAckToJSONTyped = AgentSessionEventAckToJSONTyped;
+/**
+ * Check if a given object implements the AgentSessionEventAck interface.
+ */
+function instanceOfAgentSessionEventAck(value) {
+    if (!('queued' in value) || value['queued'] === undefined)
+        return false;
+    if (!('type' in value) || value['type'] === undefined)
+        return false;
+    return true;
+}
+function AgentSessionEventAckFromJSON(json) {
+    return AgentSessionEventAckFromJSONTyped(json, false);
+}
+function AgentSessionEventAckFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'queued': json['queued'],
+        'type': json['type'],
+    };
+}
+function AgentSessionEventAckToJSON(json) {
+    return AgentSessionEventAckToJSONTyped(json, false);
+}
+function AgentSessionEventAckToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'queued': value['queued'],
+        'type': value['type'],
+    };
+}