@aui.io/aui-client 2.0.0 → 3.0.0

package/dist/cjs/api/types/AgentVersionCreateResponse.d.ts

@@ -0,0 +1,31 @@
+import type * as Apollo from "../index.js";
+/**
+ * Returns the created draft version.
+ */
+export interface AgentVersionCreateResponse {
+    /** Version id */
+    id: string;
+    /** Owning agent id */
+    agent_id: string;
+    version_number: number;
+    version_revision_number: number;
+    /** Canonical tag, e.g. 'v3.2' */
+    version_tag: string;
+    status: AgentVersionCreateResponse.Status;
+    /** Lineage: cloned from */
+    parent_version_id?: string;
+    label?: string;
+    tags?: string[];
+    notes?: string;
+    stats?: Apollo.VersionStats;
+    created_at: string;
+    published_at?: string;
+}
+export declare namespace AgentVersionCreateResponse {
+    const Status: {
+        readonly Draft: "draft";
+        readonly Published: "published";
+        readonly Archived: "archived";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/cjs/api/types/AgentVersionCreateResponse.js

@@ -0,0 +1,12 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentVersionCreateResponse = void 0;
+var AgentVersionCreateResponse;
+(function (AgentVersionCreateResponse) {
+    AgentVersionCreateResponse.Status = {
+        Draft: "draft",
+        Published: "published",
+        Archived: "archived",
+    };
+})(AgentVersionCreateResponse || (exports.AgentVersionCreateResponse = AgentVersionCreateResponse = {}));

package/dist/cjs/api/types/AgentVersionListFilters.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Query filters for listing an agent's versions (sort/pagination come from
+ * the shared page-query dependency, not from here).
+ */
+export interface AgentVersionListFilters {
+    status?: AgentVersionListFilters.Status.Item[];
+    /** Filter by tag (partial match) */
+    tag?: string;
+    /** Filter by version number (exact match) */
+    version_number?: number;
+    /** Filter by label (partial match) */
+    label?: string;
+    /** If true, only return base versions (revision 0) */
+    exclude_revisions?: boolean;
+}
+export declare namespace AgentVersionListFilters {
+    type Status = Status.Item[];
+    namespace Status {
+        const Item: {
+            readonly Draft: "draft";
+            readonly Published: "published";
+            readonly Archived: "archived";
+        };
+        type Item = (typeof Item)[keyof typeof Item];
+    }
+}

package/dist/cjs/api/types/AgentVersionListFilters.js

@@ -0,0 +1,15 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentVersionListFilters = void 0;
+var AgentVersionListFilters;
+(function (AgentVersionListFilters) {
+    let Status;
+    (function (Status) {
+        Status.Item = {
+            Draft: "draft",
+            Published: "published",
+            Archived: "archived",
+        };
+    })(Status = AgentVersionListFilters.Status || (AgentVersionListFilters.Status = {}));
+})(AgentVersionListFilters || (exports.AgentVersionListFilters = AgentVersionListFilters = {}));

package/dist/cjs/api/types/AgentVersionPublishResponse.d.ts

@@ -0,0 +1,35 @@
+import type * as Apollo from "../index.js";
+/**
+ * Returns the now-live (published) version.
+ *
+ * ``publish`` is the single verb that makes a version the agent's live one:
+ * it freezes a draft first, or just re-activates an already-published version
+ * (roll back / switch).
+ */
+export interface AgentVersionPublishResponse {
+    /** Version id */
+    id: string;
+    /** Owning agent id */
+    agent_id: string;
+    version_number: number;
+    version_revision_number: number;
+    /** Canonical tag, e.g. 'v3.2' */
+    version_tag: string;
+    status: AgentVersionPublishResponse.Status;
+    /** Lineage: cloned from */
+    parent_version_id?: string;
+    label?: string;
+    tags?: string[];
+    notes?: string;
+    stats?: Apollo.VersionStats;
+    created_at: string;
+    published_at?: string;
+}
+export declare namespace AgentVersionPublishResponse {
+    const Status: {
+        readonly Draft: "draft";
+        readonly Published: "published";
+        readonly Archived: "archived";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/cjs/api/types/AgentVersionPublishResponse.js

@@ -0,0 +1,12 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentVersionPublishResponse = void 0;
+var AgentVersionPublishResponse;
+(function (AgentVersionPublishResponse) {
+    AgentVersionPublishResponse.Status = {
+        Draft: "draft",
+        Published: "published",
+        Archived: "archived",
+    };
+})(AgentVersionPublishResponse || (exports.AgentVersionPublishResponse = AgentVersionPublishResponse = {}));

package/dist/cjs/api/types/AgentVersionPullResponse.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A version's config bundle — full parity with agent-settings, clients
+ * already know this shape (per the original push/pull design).
+ */
+export interface AgentVersionPullResponse {
+    return_type?: string;
+    agent_id: string;
+    version_id: string;
+    version_tag: string;
+    /** Parsed agent-settings bundle */
+    bundle: Record<string, unknown>;
+    /** Cache-metadata expiry for this payload */
+    expires_at: string;
+}

package/dist/cjs/api/types/AgentVersionPushResponse.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Result of a push. ``gcs_key`` (raw storage path) is not exposed.
+ */
+export interface AgentVersionPushResponse {
+    agent_id: string;
+    version_id: string;
+    new_version_revision_number: number;
+    new_version_tag: string;
+    /** Id of the newly committed revision */
+    revision_id: string;
+    /** Hex-encoded SHA-256 of the canonical bundle bytes */
+    sha256: string;
+    size: number;
+    created_at: string;
+    commit_message?: string;
+}

package/dist/cjs/api/types/AgentVersionUpdateResponse.d.ts

@@ -0,0 +1,31 @@
+import type * as Apollo from "../index.js";
+/**
+ * Returns the updated version.
+ */
+export interface AgentVersionUpdateResponse {
+    /** Version id */
+    id: string;
+    /** Owning agent id */
+    agent_id: string;
+    version_number: number;
+    version_revision_number: number;
+    /** Canonical tag, e.g. 'v3.2' */
+    version_tag: string;
+    status: AgentVersionUpdateResponse.Status;
+    /** Lineage: cloned from */
+    parent_version_id?: string;
+    label?: string;
+    tags?: string[];
+    notes?: string;
+    stats?: Apollo.VersionStats;
+    created_at: string;
+    published_at?: string;
+}
+export declare namespace AgentVersionUpdateResponse {
+    const Status: {
+        readonly Draft: "draft";
+        readonly Published: "published";
+        readonly Archived: "archived";
+    };
+    type Status = (typeof Status)[keyof typeof Status];
+}

package/dist/cjs/api/types/AgentVersionUpdateResponse.js

@@ -0,0 +1,12 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentVersionUpdateResponse = void 0;
+var AgentVersionUpdateResponse;
+(function (AgentVersionUpdateResponse) {
+    AgentVersionUpdateResponse.Status = {
+        Draft: "draft",
+        Published: "published",
+        Archived: "archived",
+    };
+})(AgentVersionUpdateResponse || (exports.AgentVersionUpdateResponse = AgentVersionUpdateResponse = {}));

package/dist/cjs/api/types/ErrorBody.d.ts

@@ -0,0 +1,18 @@
+import type * as Apollo from "../index.js";
+/**
+ * The error body an end user receives when interacting with Apollo.
+ *
+ * ``code`` is the stable, machine-readable branch point clients switch on.
+ * ``message`` is human-readable and explicitly NOT part of the contract --
+ * it may change at any time and must never be parsed.
+ */
+export interface ErrorBody {
+    /** Stable, namespaced machine code clients branch on (e.g. "not_found" or "agents.not_found"). THE branch point -- open/extensible, append-only. */
+    code: string;
+    /** Human-readable explanation. NOT part of the contract; may change anytime. Clients must never parse or branch on this. */
+    message: string;
+    /** Trace id for support correlation. */
+    request_id?: string;
+    /** Optional structured sub-errors (e.g. per-field validation failures). */
+    details?: Apollo.ErrorDetail[];
+}

package/dist/cjs/api/types/ErrorDetail.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A single structured sub-error (e.g. one field's validation failure).
+ */
+export interface ErrorDetail {
+    field?: string;
+    message: string;
+}

package/dist/cjs/api/types/ErrorEnvelope.d.ts

@@ -0,0 +1,25 @@
+/**
+ * type=error — either a locally-generated error (seq -1) or a forwarded IA error.
+ */
+export interface ErrorEnvelope {
+    type?: "error";
+    data?: ErrorEnvelope.Data;
+    /** Monotonic sequence for gap detection / replay. Locally-generated errors use -1. */
+    seq: number;
+}
+export declare namespace ErrorEnvelope {
+    type Data = 
+    /**
+     * Locally generated (bad frame, wallet-gate denial, relay loss). */
+    {
+        error: string;
+        code?: number | undefined;
+    }
+    /**
+     * Forwarded IA error payload. */
+     | {
+        message?: string | undefined;
+        status_code?: number | undefined;
+        error_code?: string | undefined;
+    };
+}

package/dist/cjs/api/types/ErrorResponse.d.ts

@@ -0,0 +1,7 @@
+import type * as Apollo from "../index.js";
+/**
+ * The single envelope every Apollo error response conforms to.
+ */
+export interface ErrorResponse {
+    error: Apollo.ErrorBody;
+}

package/dist/cjs/api/types/ErrorStreamEvent.d.ts

@@ -0,0 +1,9 @@
+/**
+ * A recoverable error raised while processing the turn.
+ */
+export interface ErrorStreamEvent {
+    /** Monotonic sequence number; echo the last seen value via Last-Event-ID to resume. */
+    seq: number;
+    /** Error payload (message and, when available, a status code). */
+    data: Record<string, unknown>;
+}

package/dist/cjs/api/types/EventEnvelope.d.ts

@@ -0,0 +1,10 @@
+import type * as Apollo from "../index.js";
+/**
+ * type=event — a raw IA event forwarded per the allow-list.
+ */
+export interface EventEnvelope {
+    type?: "event";
+    data?: Apollo.IaEvent;
+    /** Monotonic sequence for gap detection / replay. Locally-generated errors use -1. */
+    seq: number;
+}

package/dist/cjs/api/types/EventEnvelopeBase.d.ts

@@ -0,0 +1,15 @@
+export interface EventEnvelopeBase {
+    /** Monotonic sequence for gap detection / replay. Locally-generated errors use -1. */
+    seq: number;
+    type: EventEnvelopeBase.Type;
+    data?: unknown;
+}
+export declare namespace EventEnvelopeBase {
+    const Type: {
+        readonly Thread: "thread";
+        readonly Message: "message";
+        readonly Event: "event";
+        readonly Error: "error";
+    };
+    type Type = (typeof Type)[keyof typeof Type];
+}

package/dist/cjs/api/types/EventEnvelopeBase.js

@@ -0,0 +1,13 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventEnvelopeBase = void 0;
+var EventEnvelopeBase;
+(function (EventEnvelopeBase) {
+    EventEnvelopeBase.Type = {
+        Thread: "thread",
+        Message: "message",
+        Event: "event",
+        Error: "error",
+    };
+})(EventEnvelopeBase || (exports.EventEnvelopeBase = EventEnvelopeBase = {}));

package/dist/cjs/api/types/ExternalAgent.d.ts

@@ -0,0 +1,17 @@
+/**
+ * The published Agent shape.
+ */
+export interface ExternalAgent {
+    /** Agent id */
+    id: string;
+    /** Owning project id */
+    project_id: string;
+    /** Agent name */
+    name: string;
+    /** Tag of the currently deployed version; None until deployed */
+    live_version_id?: string;
+    /** Creation timestamp */
+    created_at: string;
+    /** Last update timestamp */
+    updated_at: string;
+}

package/dist/cjs/api/types/ExternalAgentCreateResponse.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Returns the created agent.
+ */
+export interface ExternalAgentCreateResponse {
+    /** Agent id */
+    id: string;
+    /** Owning project id */
+    project_id: string;
+    /** Agent name */
+    name: string;
+    /** Tag of the currently deployed version; None until deployed */
+    live_version_id?: string;
+    /** Creation timestamp */
+    created_at: string;
+    /** Last update timestamp */
+    updated_at: string;
+}

package/dist/cjs/api/types/ExternalAgentListFilters.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Query filters for listing agents in a project.
+ */
+export interface ExternalAgentListFilters {
+    /** Case-insensitive substring match on name */
+    name?: string;
+}

package/dist/cjs/api/types/ExternalAgentUpdateResponse.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Returns the updated agent.
+ */
+export interface ExternalAgentUpdateResponse {
+    /** Agent id */
+    id: string;
+    /** Owning project id */
+    project_id: string;
+    /** Agent name */
+    name: string;
+    /** Tag of the currently deployed version; None until deployed */
+    live_version_id?: string;
+    /** Creation timestamp */
+    created_at: string;
+    /** Last update timestamp */
+    updated_at: string;
+}

package/dist/cjs/api/types/ExternalPageAgentVersion.d.ts

@@ -0,0 +1,6 @@
+import type * as Apollo from "../index.js";
+export interface ExternalPageAgentVersion {
+    results: Apollo.AgentVersion[];
+    meta: Apollo.ExternalPageMeta;
+    links: Apollo.ExternalPageLinks;
+}

package/dist/cjs/api/types/ExternalPageExternalAgent.d.ts

@@ -0,0 +1,6 @@
+import type * as Apollo from "../index.js";
+export interface ExternalPageExternalAgent {
+    results: Apollo.ExternalAgent[];
+    meta: Apollo.ExternalPageMeta;
+    links: Apollo.ExternalPageLinks;
+}

package/dist/cjs/api/types/ExternalPageLinks.d.ts

@@ -0,0 +1,4 @@
+export interface ExternalPageLinks {
+    next?: string;
+    prev?: string;
+}

package/dist/cjs/api/types/ExternalPageMeta.d.ts

@@ -0,0 +1,5 @@
+export interface ExternalPageMeta {
+    has_more: boolean;
+    after_cursor?: string;
+    before_cursor?: string;
+}

package/dist/cjs/api/types/ExternalPageProject.d.ts

@@ -0,0 +1,6 @@
+import type * as Apollo from "../index.js";
+export interface ExternalPageProject {
+    results: Apollo.Project[];
+    meta: Apollo.ExternalPageMeta;
+    links: Apollo.ExternalPageLinks;
+}

package/dist/cjs/api/types/ExternalPageThreadListItem.d.ts

@@ -0,0 +1,6 @@
+import type * as Apollo from "../index.js";
+export interface ExternalPageThreadListItem {
+    results: Apollo.ThreadListItem[];
+    meta: Apollo.ExternalPageMeta;
+    links: Apollo.ExternalPageLinks;
+}

package/dist/cjs/api/types/GatewayHeaders.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Gateway-enriched upgrade-request headers.
+ */
+export interface GatewayHeaders {
+    /** Tenant scope. Absence closes the socket with 1008. */
+    "x-aui-organization-id": string;
+    /** Billing task-origin hint (e.g. playground / production). */
+    "x-aui-source"?: string;
+    /** Acting (logged-in) user; attributes an auto-created thread. */
+    "x-aui-user-id"?: string;
+    /** Shared gateway↔apollo service key (infra contract; not set by end clients). */
+    "x-api-key"?: string;
+}

package/dist/cjs/api/types/HttpValidationError.d.ts

@@ -1,4 +1,4 @@
 import type * as Apollo from "../index.js";
 export interface HttpValidationError {
-    errors?: Apollo.ValidationError[];
+    detail?: Apollo.ValidationError[];
 }

package/dist/cjs/api/types/IaEvent.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Raw IA event. Forwarded only when channel.event_name is in the active allow-list.
+ */
+export interface IaEvent {
+    channel?: IaEvent.Channel;
+    scope?: Record<string, unknown>;
+    /** Event-specific payload. */
+    data?: unknown;
+    /** Accepts any additional properties */
+    [key: string]: any;
+}
+export declare namespace IaEvent {
+    interface Channel {
+        /** Default stream: thread-message-text-content-updated (token delta), thread-message-text-content-completed. Simulator adds user-message-text-content-completed and simulation-request-*. ?events=all|verbose adds the full pillar/workflow set. */
+        event_name?: string;
+    }
+}

package/dist/cjs/api/types/InitiateThreadResponse.d.ts

@@ -0,0 +1,6 @@
+export interface InitiateThreadResponse {
+    /** Thread the opener landed on (new or continued). */
+    thread_id: string;
+    /** Provider message id for the sent opener. */
+    message_sid: string;
+}

package/dist/cjs/api/types/Message.d.ts

@@ -1,14 +1,19 @@
 import type * as Apollo from "../index.js";
+/**
+ * One message in a thread transcript (the published, scrubbed shape).
+ */
 export interface Message {
+    /** Interaction id (or message id for interaction-less messages). */
     id: string;
-    created_at: string;
-    text: string;
-    sender: Apollo.MessageContactParty;
-    receiver: Apollo.MessageContactParty;
-    cards: Apollo.Card[];
+    /** ISO-8601. */
+    created_at?: string;
+    text?: string;
+    sender?: Apollo.MessageParty;
+    receiver?: Apollo.MessageParty;
+    cards?: Apollo.MessageCard[];
     welcome_message?: string;
-    followup_suggestions: string[];
-    executed_workflows?: string[];
+    followup_suggestions?: string[];
     url?: string;
-    trace_info?: Apollo.TraceInfo;
+    input_tokens?: number;
+    output_tokens?: number;
 }

package/dist/cjs/api/types/MessageCard.d.ts

@@ -0,0 +1,7 @@
+export interface MessageCard {
+    name?: string;
+    category?: string;
+    rendered_jsx?: string;
+    is_recommended?: boolean;
+    index?: number;
+}

package/dist/cjs/api/types/MessageEnvelope.d.ts

@@ -0,0 +1,15 @@
+import type * as Apollo from "../index.js";
+/**
+ * type=message — the terminal agent reply (external Message + optional trace_info).
+ */
+export interface MessageEnvelope {
+    type?: "message";
+    data?: MessageEnvelope.Data;
+    /** Monotonic sequence for gap detection / replay. Locally-generated errors use -1. */
+    seq: number;
+}
+export declare namespace MessageEnvelope {
+    interface Data extends Apollo.Message {
+        trace_info?: Apollo.Trace;
+    }
+}

package/dist/cjs/api/types/MessageParty.d.ts

@@ -0,0 +1,4 @@
+export interface MessageParty {
+    id?: string;
+    type?: string;
+}

package/dist/cjs/api/types/MessageStreamEvent.d.ts

@@ -0,0 +1,9 @@
+import type * as Apollo from "../index.js";
+/**
+ * Terminal event of a turn: the completed agent reply.
+ */
+export interface MessageStreamEvent {
+    /** Monotonic sequence number; echo the last seen value via Last-Event-ID to resume. */
+    seq: number;
+    data: Apollo.Message;
+}

package/dist/cjs/api/types/Project.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The published Project shape (SDK entity: ``Project``).
+ */
+export interface Project {
+    /** Project id */
+    id: string;
+    /** Project name */
+    name: string;
+    /** Creation timestamp */
+    created_at: string;
+    /** Last update timestamp */
+    updated_at: string;
+}

package/dist/cjs/api/types/ResumeRequest.d.ts

@@ -0,0 +1,5 @@
+export interface ResumeRequest {
+    type: "resume";
+    /** Replay buffered envelopes with seq > resume_after for the active thread. */
+    resume_after: number;
+}

package/dist/cjs/api/types/SendMessageRequest.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Send-message contract. ``agent_id`` is required; org comes from the gateway
+ * header, not the body. ``thread_id`` is optional: present -> append to that
+ * thread; absent -> a new thread is auto-created and its id returned.
+ */
+export interface SendMessageRequest {
+    agent_id: string;
+    text: string;
+    user_id: string;
+    thread_id?: string;
+    /** Signed image URL for vision input; forwarded to IA as body.image.signed_url. */
+    image_url?: string;
+}

package/dist/cjs/api/types/SendMessageResponse.d.ts

@@ -0,0 +1,10 @@
+import type * as Apollo from "../index.js";
+/**
+ * Send/rerun reply plus the resolved thread id — the one the interaction landed
+ * on (newly created when the request omitted ``thread_id``).
+ */
+export interface SendMessageResponse {
+    /** Thread the interaction belongs to */
+    thread_id: string;
+    message: Apollo.Message;
+}

package/dist/cjs/api/types/SimulatorCommand.d.ts

@@ -0,0 +1,21 @@
+export interface SimulatorCommand {
+    type: SimulatorCommand.Type;
+    /** IA SimulationRequest payload, relayed verbatim. For `start`, must carry `task_id` (used for the wallet gate, replay buffer, and billing). */
+    data?: SimulatorCommand.Data;
+}
+export declare namespace SimulatorCommand {
+    const Type: {
+        readonly Start: "start";
+        readonly Cancel: "cancel";
+        readonly ForceCancel: "force-cancel";
+    };
+    type Type = (typeof Type)[keyof typeof Type];
+    /**
+     * IA SimulationRequest payload, relayed verbatim. For `start`, must carry `task_id` (used for the wallet gate, replay buffer, and billing).
+     */
+    interface Data {
+        task_id?: string;
+        /** Accepts any additional properties */
+        [key: string]: any;
+    }
+}

package/dist/cjs/api/types/SimulatorCommand.js

@@ -0,0 +1,12 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimulatorCommand = void 0;
+var SimulatorCommand;
+(function (SimulatorCommand) {
+    SimulatorCommand.Type = {
+        Start: "start",
+        Cancel: "cancel",
+        ForceCancel: "force-cancel",
+    };
+})(SimulatorCommand || (exports.SimulatorCommand = SimulatorCommand = {}));