@opengeni/sdk 0.32.1 → 0.34.1

package/dist/types.d.ts

@@ -387,6 +387,29 @@ export type OAuthStartResponse = {
     authorizationUrl: string | null;
     expiresAt: string;
 };
+export type SocialProvider = "x" | "reddit" | "linkedin" | "instagram" | "facebook" | "tiktok" | "youtube" | "custom";
+export type SocialConnectionStatus = "connected" | "needs_reauth" | "disabled";
+export type SocialConnection = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    provider: SocialProvider;
+    accountHandle: string;
+    accountName: string | null;
+    externalAccountId: string | null;
+    status: SocialConnectionStatus;
+    scopes: string[];
+    credentialRef: string | null;
+    tokenMetadata: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+    createdAt: string;
+    updatedAt: string;
+};
+export type SocialOAuthStartRequest = {
+    provider: "x" | "reddit";
+    scopes?: string[] | undefined;
+    returnPath?: string | undefined;
+};
 /** The immutable principal whose authority accepted a session or turn. */
 export type TurnInitiator = {
     kind: "subject" | "service";
@@ -1312,14 +1335,14 @@ export type CreateSessionRequest = {
         groupId: string;
     } | undefined;
 };
-export declare const KNOWN_PERMISSIONS: readonly ["account:read", "account:admin", "members:manage", "workspace:create", "billing:read", "billing:manage", "workspace:read", "workspace:admin", "sessions:create", "sessions:read", "sessions:control", "stream:view", "stream:control", "stream:acknowledge", "files:upload", "files:read", "files:write", "terminal:attach", "documents:manage", "documents:search", "scheduled_tasks:manage", "scheduled_tasks:run", "github:manage", "github:use", "api_keys:manage", "connections:read", "connections:write", "environments:manage", "environments:use", "variable-sets:manage", "variable-sets:use", "mcp_servers:attach", "toolspace:call", "goals:manage", "enrollments:read", "enrollments:manage", "rigs:use", "rigs:manage"];
+export declare const KNOWN_PERMISSIONS: readonly ["account:read", "account:admin", "members:manage", "workspace:create", "billing:read", "billing:manage", "workspace:read", "workspace:admin", "sessions:create", "sessions:read", "sessions:control", "stream:view", "stream:control", "stream:acknowledge", "files:upload", "files:read", "files:write", "terminal:attach", "documents:manage", "documents:search", "scheduled_tasks:manage", "scheduled_tasks:run", "github:manage", "github:use", "api_keys:manage", "connections:read", "connections:write", "environments:manage", "environments:use", "variable-sets:manage", "variable-sets:use", "mcp_servers:attach", "toolspace:call", "goals:manage", "enrollments:read", "enrollments:manage", "rigs:use", "rigs:manage", "artifacts:read", "artifacts:publish"];
 export type KnownPermission = (typeof KNOWN_PERMISSIONS)[number];
 /**
  * Permissions the SDK knows about today, kept open so a newer OpenGeni server
  * can introduce permissions without breaking older SDK consumers.
  */
 export type Permission = KnownPermission | (string & {});
-export type FirstPartyMcpToolName = "set_session_title" | "goal_set" | "goal_update" | "goal_complete" | "goal_pause" | "memory_search" | "memory_save" | "memory_correct" | "preference_registry_summary" | "preference_registry_get" | "sandboxes_list" | "sandbox_attach" | "sandbox_swap" | "run_on" | "sandbox_provision" | "rig_list" | "rig_get" | "rig_propose_change" | "rig_verify" | "rig_promote" | "sessions_list" | "session_get" | "session_events" | "session_create" | "session_send_message" | "session_pause" | "session_resume" | "session_steer" | "set_other_session_title" | "variable_set_list" | "environment_list" | "variable_set_set_variable" | "environment_set_variable" | "github_connect_link" | "github_token" | "github_repositories_list" | "social_connections_list" | "social_posts_recent" | "social_daily_analysis_context" | "scheduled_tasks_list" | "scheduled_tasks_get" | "scheduled_tasks_create" | "scheduled_tasks_update" | "scheduled_tasks_pause" | "scheduled_tasks_resume" | "scheduled_tasks_trigger" | "scheduled_tasks_delete" | "scheduled_task_runs_list" | "slack_bot_list_channels" | "slack_bot_channel_history" | "slack_bot_thread_replies" | "slack_bot_list_users" | "slack_bot_list_files" | "slack_bot_file_info" | "slack_bot_file_content" | "slack_bot_post_message" | "slack_bot_delete_message";
+export type FirstPartyMcpToolName = "set_session_title" | "goal_set" | "goal_update" | "goal_complete" | "goal_pause" | "memory_search" | "memory_save" | "memory_correct" | "preference_registry_summary" | "preference_registry_get" | "sandboxes_list" | "sandbox_attach" | "sandbox_swap" | "run_on" | "sandbox_provision" | "rig_list" | "rig_get" | "rig_propose_change" | "rig_verify" | "rig_promote" | "sessions_list" | "session_get" | "session_events" | "session_create" | "session_send_message" | "session_pause" | "session_resume" | "session_steer" | "set_other_session_title" | "variable_set_list" | "environment_list" | "variable_set_set_variable" | "environment_set_variable" | "github_connect_link" | "github_token" | "github_repositories_list" | "social_connections_list" | "social_posts_recent" | "social_daily_analysis_context" | "social_search_live" | "social_mentions_live" | "social_thread_fetch" | "social_posts_sync" | "social_post_reply" | "scheduled_tasks_list" | "scheduled_tasks_get" | "scheduled_tasks_create" | "scheduled_tasks_update" | "scheduled_tasks_pause" | "scheduled_tasks_resume" | "scheduled_tasks_trigger" | "scheduled_tasks_delete" | "scheduled_task_runs_list" | "slack_bot_list_channels" | "slack_bot_channel_history" | "slack_bot_thread_replies" | "slack_bot_list_users" | "slack_bot_list_files" | "slack_bot_file_info" | "slack_bot_file_content" | "slack_bot_post_message" | "slack_bot_delete_message" | "artifacts_list" | "artifacts_get_source" | "artifacts_create" | "artifacts_publish" | "artifacts_rollback";
 export type ProductAccessMode = "local" | "configured" | "managed";
 export type ModelCapabilitySupportV1 = "supported" | "unsupported" | "unknown";
 export type ModelCapabilityStateV1 = {
@@ -1644,7 +1667,7 @@ export type ClientAuthConfig = {
     mode: "managedSession";
     session: "cookie";
 };
-export declare const OPENGENI_API_CONTRACT_REVISION: "2026-07-turn-instructions-v1";
+export declare const OPENGENI_API_CONTRACT_REVISION: "2026-07-workspace-artifacts-v1";
 export declare const OPENGENI_API_CONTRACT_HEADER: "x-opengeni-api-contract";
 /** Bounded request/response identifier shared by browser, ingress, and API diagnostics. */
 export declare const OPENGENI_CORRELATION_HEADER: "x-opengeni-correlation-id";
@@ -1676,6 +1699,21 @@ export type ClientConfig = {
     voiceInput?: ClientVoiceInputConfig | undefined;
     productAccessMode: ProductAccessMode;
     auth: ClientAuthConfig;
+    analytics: {
+        consentRequired: boolean;
+        providers: {
+            reo?: {
+                clientId: string;
+            } | undefined;
+            posthog?: {
+                projectKey: string;
+                host: string;
+            } | undefined;
+            ga4?: {
+                measurementId: string;
+            } | undefined;
+        };
+    };
     structuredServices: {
         fileSystem: boolean;
         git: boolean;

package/dist/workspace-artifacts.d.ts

@@ -0,0 +1,94 @@
+export type WorkspaceArtifactVersion = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    artifactId: string;
+    revision: number;
+    contentType: "text/html";
+    contentSha256: string;
+    sizeBytes: number;
+    sourceSessionId: string | null;
+    sourceTurnId: string | null;
+    sourceAttemptId: string | null;
+    sourceExecutionGeneration: number | null;
+    createdBySubjectId: string;
+    createdAt: string;
+};
+export type WorkspaceArtifact = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    slug: string;
+    title: string;
+    description: string | null;
+    status: "active" | "archived";
+    currentVersion: WorkspaceArtifactVersion | null;
+    createdBySubjectId: string;
+    createdAt: string;
+    updatedAt: string;
+};
+export type WorkspaceArtifactEvent = {
+    id: string;
+    accountId: string;
+    workspaceId: string;
+    artifactId: string;
+    type: "published" | "rolled_back";
+    fromVersionId: string | null;
+    toVersionId: string;
+    sourceSessionId: string | null;
+    sourceTurnId: string | null;
+    sourceAttemptId: string | null;
+    sourceExecutionGeneration: number | null;
+    actorSubjectId: string;
+    reason: string;
+    createdAt: string;
+};
+export type WorkspaceArtifactListOptions = {
+    limit?: number;
+    cursor?: string;
+};
+export type WorkspaceArtifactListResponse = {
+    artifacts: WorkspaceArtifact[];
+    nextCursor: string | null;
+    truncated: boolean;
+};
+export type WorkspaceArtifactDetailResponse = {
+    artifact: WorkspaceArtifact;
+    versions: WorkspaceArtifactVersion[];
+    events: WorkspaceArtifactEvent[];
+    versionsTruncated: boolean;
+    eventsTruncated: boolean;
+};
+export type WorkspaceArtifactContentResponse = {
+    artifactId: string;
+    versionId: string;
+    contentType: "text/html";
+    contentSha256: string;
+    html: string;
+};
+export type WorkspaceArtifactMutationResponse = {
+    artifact: WorkspaceArtifact;
+    version: WorkspaceArtifactVersion;
+    event: WorkspaceArtifactEvent;
+    replayed: boolean;
+};
+export type CreateWorkspaceArtifactRequest = {
+    slug?: string;
+    title: string;
+    description?: string | null;
+    html: string;
+    idempotencyKey: string;
+};
+export type PublishWorkspaceArtifactVersionRequest = {
+    title?: string;
+    description?: string | null;
+    html: string;
+    expectedCurrentVersionId: string;
+    idempotencyKey: string;
+};
+export type RollbackWorkspaceArtifactRequest = {
+    versionId: string;
+    expectedCurrentVersionId: string;
+    reason: string;
+    idempotencyKey: string;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/sdk",
-  "version": "0.32.1",
+  "version": "0.34.1",
   "description": "Framework-agnostic TypeScript SDK for the OpenGeni API: typed client, session lifecycle, SSE event streaming with reconnect + replay-by-sequence, and proxy re-streaming helpers.",
   "license": "Apache-2.0",
   "repository": {
@@ -21,6 +21,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.js"
     }
   },
   "publishConfig": {

package/src/artifact-client.ts

@@ -0,0 +1,85 @@
+import { OpenGeniClient as OpenGeniCoreClient } from "./client";
+import type {
+  CreateWorkspaceArtifactRequest,
+  PublishWorkspaceArtifactVersionRequest,
+  RollbackWorkspaceArtifactRequest,
+  WorkspaceArtifactContentResponse,
+  WorkspaceArtifactDetailResponse,
+  WorkspaceArtifactListOptions,
+  WorkspaceArtifactListResponse,
+  WorkspaceArtifactMutationResponse,
+} from "./workspace-artifacts";
+
+/** Public SDK client. Artifact operations stay out of the console's eager core graph. */
+export class OpenGeniClient extends OpenGeniCoreClient {
+  async listWorkspaceArtifacts(
+    workspaceId: string,
+    options: WorkspaceArtifactListOptions = {},
+  ): Promise<WorkspaceArtifactListResponse> {
+    const query = new URLSearchParams();
+    if (options.limit !== undefined) query.set("limit", String(options.limit));
+    if (options.cursor) query.set("cursor", options.cursor);
+    const suffix = query.size > 0 ? `?${query.toString()}` : "";
+    return await this.requestJson<WorkspaceArtifactListResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/published-artifacts${suffix}`,
+    );
+  }
+
+  async getWorkspaceArtifact(
+    workspaceId: string,
+    artifactId: string,
+  ): Promise<WorkspaceArtifactDetailResponse> {
+    return await this.requestJson<WorkspaceArtifactDetailResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/published-artifacts/${encodeURIComponent(artifactId)}`,
+    );
+  }
+
+  async getWorkspaceArtifactContent(
+    workspaceId: string,
+    artifactId: string,
+    versionId?: string,
+  ): Promise<WorkspaceArtifactContentResponse> {
+    const query = versionId ? `?versionId=${encodeURIComponent(versionId)}` : "";
+    return await this.requestJson<WorkspaceArtifactContentResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/published-artifacts/${encodeURIComponent(artifactId)}/content${query}`,
+    );
+  }
+
+  async createWorkspaceArtifact(
+    workspaceId: string,
+    request: CreateWorkspaceArtifactRequest,
+  ): Promise<WorkspaceArtifactMutationResponse> {
+    return await this.requestJson<WorkspaceArtifactMutationResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/published-artifacts`,
+      request,
+    );
+  }
+
+  async publishWorkspaceArtifactVersion(
+    workspaceId: string,
+    artifactId: string,
+    request: PublishWorkspaceArtifactVersionRequest,
+  ): Promise<WorkspaceArtifactMutationResponse> {
+    return await this.requestJson<WorkspaceArtifactMutationResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/published-artifacts/${encodeURIComponent(artifactId)}/versions`,
+      request,
+    );
+  }
+
+  async rollbackWorkspaceArtifact(
+    workspaceId: string,
+    artifactId: string,
+    request: RollbackWorkspaceArtifactRequest,
+  ): Promise<WorkspaceArtifactMutationResponse> {
+    return await this.requestJson<WorkspaceArtifactMutationResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/published-artifacts/${encodeURIComponent(artifactId)}/rollback`,
+      request,
+    );
+  }
+}

package/src/client.ts

@@ -201,6 +201,8 @@ import type {
   ConnectionResponse,
   OAuthStartRequest,
   OAuthStartResponse,
+  SocialConnection,
+  SocialOAuthStartRequest,
 } from "./types";
 import type {
   ActivateWorkspaceInstructionPolicyRequest,
@@ -2364,6 +2366,11 @@ export class OpenGeniClient {
     });
     const putResponse = await this.fetchImpl(upload.putUrl, {
       method: "PUT",
+      // Signed object-storage URLs carry their own short-lived authority.
+      // Browser cookies and HTTP auth must never accompany this cross-origin
+      // request: credentialed fetches are incompatible with wildcard CORS and
+      // can leak ambient credentials to a caller-selected storage endpoint.
+      credentials: "omit",
       // The backend's requiredHeaders already carry the canonical lowercase
       // `content-type` for every storage backend (Azure/S3/GCS). Do NOT also set
       // a `Content-Type` key here: WHATWG Headers treats the two casings as the
@@ -2862,6 +2869,41 @@ export class OpenGeniClient {
     );
   }
 
+  /**
+   * Start a first-party social OAuth flow (X / Reddit); redirect the user to
+   * the returned `authorizationUrl`. The completed connection lands in
+   * `listSocialConnections`.
+   */
+  async startSocialOAuth(
+    workspaceId: string,
+    request: SocialOAuthStartRequest,
+  ): Promise<OAuthStartResponse> {
+    return await this.requestJson<OAuthStartResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/social/oauth/start`,
+      request,
+    );
+  }
+
+  /** Connected social accounts (X / Reddit / pushed custom providers). */
+  async listSocialConnections(workspaceId: string): Promise<SocialConnection[]> {
+    return await this.requestJson<SocialConnection[]>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/social/connections`,
+    );
+  }
+
+  /** Drop the stored social OAuth credential and disable the connection. */
+  async disconnectSocialConnection(
+    workspaceId: string,
+    connectionId: string,
+  ): Promise<SocialConnection> {
+    return await this.requestJson<SocialConnection>(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/social/connections/${connectionId}`,
+    );
+  }
+
   /** Public, immutably-cached URL for a catalog item's logo, or null when the item has none. */
   catalogAssetUrl(logoAssetPath: string | null): string | null {
     return logoAssetPath ? `${this.baseUrl}/v1/${logoAssetPath}` : null;
@@ -3165,7 +3207,7 @@ export class OpenGeniClient {
     );
   }
 
-  private async requestJson<T>(
+  protected async requestJson<T>(
     method: string,
     path: string,
     body?: unknown,

package/src/core.ts

@@ -0,0 +1,19 @@
+export { OpenGeniClient as OpenGeniCoreClient } from "./client";
+export type {
+  FetchLike,
+  OpenGeniClientOptions,
+  OpenGeniRequestOptions,
+  SendMessageInput,
+  SteerMessageResult,
+  TranscribeAudioInput,
+  WorkspaceControlEventPage,
+} from "./client";
+export {
+  OpenGeniApiContractMismatchError,
+  OpenGeniApiError,
+  OpenGeniSessionListCursorError,
+  OpenGeniStreamError,
+  isRetryableStreamError,
+} from "./errors";
+export { resolveWorkspaceVoiceInputEnabled } from "./transcription";
+export { OPENGENI_API_CONTRACT_HEADER, OPENGENI_API_CONTRACT_REVISION } from "./types";

package/src/index.ts

@@ -1,4 +1,4 @@
-export { OpenGeniClient } from "./client";
+export { OpenGeniClient } from "./artifact-client";
 export type {
   FetchLike,
   OpenGeniClientOptions,
@@ -56,6 +56,19 @@ export type {
 } from "./stream";
 export { streamWorkspaceControlEvents } from "./workspace-control-stream";
 export type { WorkspaceControlStreamTransport } from "./workspace-control-stream";
+export type {
+  CreateWorkspaceArtifactRequest,
+  PublishWorkspaceArtifactVersionRequest,
+  RollbackWorkspaceArtifactRequest,
+  WorkspaceArtifact,
+  WorkspaceArtifactContentResponse,
+  WorkspaceArtifactDetailResponse,
+  WorkspaceArtifactEvent,
+  WorkspaceArtifactListOptions,
+  WorkspaceArtifactListResponse,
+  WorkspaceArtifactMutationResponse,
+  WorkspaceArtifactVersion,
+} from "./workspace-artifacts";
 export { normalizeWorkspaceInstructionPolicyRoleKey } from "./workspace-instruction-policies";
 export type {
   ActivateWorkspaceInstructionPolicyRequest,

package/src/types.ts

@@ -525,6 +525,41 @@ export type OAuthStartResponse = {
   expiresAt: string;
 };
 
+export type SocialProvider =
+  | "x"
+  | "reddit"
+  | "linkedin"
+  | "instagram"
+  | "facebook"
+  | "tiktok"
+  | "youtube"
+  | "custom";
+
+export type SocialConnectionStatus = "connected" | "needs_reauth" | "disabled";
+
+export type SocialConnection = {
+  id: string;
+  accountId: string;
+  workspaceId: string;
+  provider: SocialProvider;
+  accountHandle: string;
+  accountName: string | null;
+  externalAccountId: string | null;
+  status: SocialConnectionStatus;
+  scopes: string[];
+  credentialRef: string | null;
+  tokenMetadata: Record<string, unknown>;
+  metadata: Record<string, unknown>;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type SocialOAuthStartRequest = {
+  provider: "x" | "reddit";
+  scopes?: string[] | undefined;
+  returnPath?: string | undefined;
+};
+
 /** The immutable principal whose authority accepted a session or turn. */
 export type TurnInitiator = {
   kind: "subject" | "service";
@@ -1728,6 +1763,8 @@ export const KNOWN_PERMISSIONS = [
   "enrollments:manage",
   "rigs:use",
   "rigs:manage",
+  "artifacts:read",
+  "artifacts:publish",
 ] as const;
 
 export type KnownPermission = (typeof KNOWN_PERMISSIONS)[number];
@@ -1778,6 +1815,11 @@ export type FirstPartyMcpToolName =
   | "social_connections_list"
   | "social_posts_recent"
   | "social_daily_analysis_context"
+  | "social_search_live"
+  | "social_mentions_live"
+  | "social_thread_fetch"
+  | "social_posts_sync"
+  | "social_post_reply"
   | "scheduled_tasks_list"
   | "scheduled_tasks_get"
   | "scheduled_tasks_create"
@@ -1795,7 +1837,12 @@ export type FirstPartyMcpToolName =
   | "slack_bot_file_info"
   | "slack_bot_file_content"
   | "slack_bot_post_message"
-  | "slack_bot_delete_message";
+  | "slack_bot_delete_message"
+  | "artifacts_list"
+  | "artifacts_get_source"
+  | "artifacts_create"
+  | "artifacts_publish"
+  | "artifacts_rollback";
 
 export type ProductAccessMode = "local" | "configured" | "managed";
 
@@ -2160,7 +2207,7 @@ export type ClientAuthConfig =
 
 // Kept value-identical to @opengeni/contracts and pinned by the SDK contract
 // parity suite. The SDK has no runtime dependency on the Zod contracts package.
-export const OPENGENI_API_CONTRACT_REVISION = "2026-07-turn-instructions-v1" as const;
+export const OPENGENI_API_CONTRACT_REVISION = "2026-07-workspace-artifacts-v1" as const;
 export const OPENGENI_API_CONTRACT_HEADER = "x-opengeni-api-contract" as const;
 /** Bounded request/response identifier shared by browser, ingress, and API diagnostics. */
 export const OPENGENI_CORRELATION_HEADER = "x-opengeni-correlation-id" as const;
@@ -2187,6 +2234,14 @@ export type ClientConfig = {
   voiceInput?: ClientVoiceInputConfig | undefined;
   productAccessMode: ProductAccessMode;
   auth: ClientAuthConfig;
+  analytics: {
+    consentRequired: boolean;
+    providers: {
+      reo?: { clientId: string } | undefined;
+      posthog?: { projectKey: string; host: string } | undefined;
+      ga4?: { measurementId: string } | undefined;
+    };
+  };
   // Server-wide hint: does this deployment support Channel-A structured services
   // at all (P4.4). Per-session availability is negotiated on /stream-capabilities;
   // this is the coarse on/off the client uses to decide whether to even attempt

package/src/workspace-artifacts.ts

@@ -0,0 +1,94 @@
+export type WorkspaceArtifactVersion = {
+  id: string;
+  accountId: string;
+  workspaceId: string;
+  artifactId: string;
+  revision: number;
+  contentType: "text/html";
+  contentSha256: string;
+  sizeBytes: number;
+  sourceSessionId: string | null;
+  sourceTurnId: string | null;
+  sourceAttemptId: string | null;
+  sourceExecutionGeneration: number | null;
+  createdBySubjectId: string;
+  createdAt: string;
+};
+
+export type WorkspaceArtifact = {
+  id: string;
+  accountId: string;
+  workspaceId: string;
+  slug: string;
+  title: string;
+  description: string | null;
+  status: "active" | "archived";
+  currentVersion: WorkspaceArtifactVersion | null;
+  createdBySubjectId: string;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export type WorkspaceArtifactEvent = {
+  id: string;
+  accountId: string;
+  workspaceId: string;
+  artifactId: string;
+  type: "published" | "rolled_back";
+  fromVersionId: string | null;
+  toVersionId: string;
+  sourceSessionId: string | null;
+  sourceTurnId: string | null;
+  sourceAttemptId: string | null;
+  sourceExecutionGeneration: number | null;
+  actorSubjectId: string;
+  reason: string;
+  createdAt: string;
+};
+
+export type WorkspaceArtifactListOptions = { limit?: number; cursor?: string };
+export type WorkspaceArtifactListResponse = {
+  artifacts: WorkspaceArtifact[];
+  nextCursor: string | null;
+  truncated: boolean;
+};
+export type WorkspaceArtifactDetailResponse = {
+  artifact: WorkspaceArtifact;
+  versions: WorkspaceArtifactVersion[];
+  events: WorkspaceArtifactEvent[];
+  versionsTruncated: boolean;
+  eventsTruncated: boolean;
+};
+export type WorkspaceArtifactContentResponse = {
+  artifactId: string;
+  versionId: string;
+  contentType: "text/html";
+  contentSha256: string;
+  html: string;
+};
+export type WorkspaceArtifactMutationResponse = {
+  artifact: WorkspaceArtifact;
+  version: WorkspaceArtifactVersion;
+  event: WorkspaceArtifactEvent;
+  replayed: boolean;
+};
+export type CreateWorkspaceArtifactRequest = {
+  slug?: string;
+  title: string;
+  description?: string | null;
+  html: string;
+  idempotencyKey: string;
+};
+export type PublishWorkspaceArtifactVersionRequest = {
+  title?: string;
+  description?: string | null;
+  html: string;
+  expectedCurrentVersionId: string;
+  idempotencyKey: string;
+};
+export type RollbackWorkspaceArtifactRequest = {
+  versionId: string;
+  expectedCurrentVersionId: string;
+  reason: string;
+  idempotencyKey: string;
+};