@opengeni/sdk 0.32.1 → 0.33.1

package/dist/types.d.ts

@@ -1312,14 +1312,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" | "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 +1644,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";

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.33.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

@@ -3165,7 +3165,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

@@ -1728,6 +1728,8 @@ export const KNOWN_PERMISSIONS = [
   "enrollments:manage",
   "rigs:use",
   "rigs:manage",
+  "artifacts:read",
+  "artifacts:publish",
 ] as const;
 
 export type KnownPermission = (typeof KNOWN_PERMISSIONS)[number];
@@ -1795,7 +1797,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 +2167,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;

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;
+};