@opengeni/sdk 0.48.0 → 0.57.0

package/dist/workspace-control-stream.d.ts

@@ -1,5 +1,5 @@
-import { type StreamSessionEventsOptions } from "./stream";
-import type { WorkspaceControlEvent } from "./types";
+import { type StreamSessionEventsOptions } from "./stream.js";
+import type { WorkspaceControlEvent } from "./types.js";
 export type WorkspaceControlStreamTransport = {
     /** The server replays every durable event after the cursor before going live. */
     openStream: (after: number, signal: AbortSignal | undefined) => Promise<ReadableStream<Uint8Array>>;

package/dist/workspace-live-stream.d.ts

@@ -0,0 +1,14 @@
+import type { WorkspaceInteractionRevisionEvent } from "./interaction.js";
+import { type StreamSessionEventsOptions } from "./stream.js";
+import type { WorkspaceControlEvent } from "./types.js";
+export type WorkspaceLiveEvent = WorkspaceControlEvent | WorkspaceInteractionRevisionEvent;
+export type WorkspaceLiveStreamOptions = Omit<StreamSessionEventsOptions, "after"> & {
+    controlAfter?: number;
+    interactionAfter?: number;
+};
+export type WorkspaceLiveStreamTransport = {
+    openStream: (controlAfter: number, interactionAfter: number, signal: AbortSignal | undefined) => Promise<ReadableStream<Uint8Array>>;
+};
+/** One reconnecting SSE connection with independent durable cursors. */
+export declare function streamWorkspaceLiveEvents(transport: WorkspaceLiveStreamTransport, options?: WorkspaceLiveStreamOptions): AsyncGenerator<WorkspaceLiveEvent, void, void>;
+export declare function parseWorkspaceLiveEvent(data: string): WorkspaceLiveEvent | null;

package/dist/workspace-state.d.ts

@@ -1,4 +1,4 @@
-import type { WorkspaceInstructionPolicyKind, WorkspaceInstructionPolicyProvenanceSource, WorkspaceInstructionPolicyScope } from "./workspace-instruction-policies";
+import type { WorkspaceInstructionPolicyKind, WorkspaceInstructionPolicyProvenanceSource, WorkspaceInstructionPolicyScope } from "./workspace-instruction-policies.js";
 export type WorkspaceStateDocumentStatusCounts = {
     queued: number;
     indexing: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/sdk",
-  "version": "0.48.0",
+  "version": "0.57.0",
   "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": {
@@ -13,7 +13,11 @@
     "src"
   ],
   "type": "module",
-  "sideEffects": false,
+  "sideEffects": [
+    "./src/editable-artifacts-worker.ts",
+    "./src/editable-artifacts/worker/browser-entry.ts",
+    "./dist/editable-artifacts-worker.js"
+  ],
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -26,10 +30,30 @@
       "types": "./dist/core.d.ts",
       "import": "./dist/core.js"
     },
+    "./artifacts": {
+      "types": "./dist/artifacts.d.ts",
+      "import": "./dist/artifacts.js"
+    },
+    "./memory-slack": {
+      "types": "./dist/memory-slack.d.ts",
+      "import": "./dist/memory-slack.js"
+    },
     "./realtime": {
       "types": "./dist/realtime.d.ts",
       "import": "./dist/realtime.js"
     },
+    "./editable-artifacts": {
+      "types": "./dist/editable-artifacts.d.ts",
+      "import": "./dist/editable-artifacts.js"
+    },
+    "./editable-artifacts/worker": {
+      "types": "./dist/editable-artifacts-worker.d.ts",
+      "import": "./dist/editable-artifacts-worker.js"
+    },
+    "./interaction": {
+      "types": "./dist/interaction.d.ts",
+      "import": "./dist/interaction.js"
+    },
     "./codex-realtime-controller": {
       "types": "./dist/codex-realtime-controller.d.ts",
       "import": "./dist/codex-realtime-controller.js"
@@ -48,7 +72,9 @@
     "build": "bun ../../scripts/build-typescript-package.ts",
     "prepublishOnly": "bash ../../scripts/prepublish-guard"
   },
-  "dependencies": {},
+  "dependencies": {
+    "@opengeni/contracts": "^0.50.0"
+  },
   "engines": {
     "node": ">=18"
   }

package/src/artifact-client.ts

@@ -1,4 +1,17 @@
 import { OpenGeniClient as OpenGeniCoreClient } from "./client";
+import type {
+  CreateEditableArtifactMaterializationRequest,
+  CreateEditableArtifactResourceRequest,
+  EditableArtifactListResource,
+  EditableArtifactMaterializationJobResource,
+  EditableArtifactPinnedVersionResource,
+  EditableArtifactResource,
+  ImportEditableArtifactResourceRequest,
+  ListSessionEditableArtifactResourcesOptions,
+  PinEditableArtifactVersionRequest,
+  ReadEditableArtifactMaterializationOptions,
+  ReadEditableArtifactResourceOptions,
+} from "./editable-artifact-resources";
 import type {
   CreateWorkspaceArtifactRequest,
   PublishWorkspaceArtifactVersionRequest,
@@ -12,6 +25,122 @@ import type {
 
 /** Public SDK client. Artifact operations stay out of the console's eager core graph. */
 export class OpenGeniClient extends OpenGeniCoreClient {
+  async createEditableArtifact(
+    workspaceId: string,
+    request: CreateEditableArtifactResourceRequest,
+    options: Readonly<{ signal?: AbortSignal | undefined }> = {},
+  ): Promise<EditableArtifactResource> {
+    return await this.requestJson<EditableArtifactResource>(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/editable-artifacts`,
+      request,
+      {},
+      options,
+    );
+  }
+
+  async importEditableArtifact(
+    workspaceId: string,
+    request: ImportEditableArtifactResourceRequest,
+    options: Readonly<{ signal?: AbortSignal | undefined }> = {},
+  ): Promise<EditableArtifactResource> {
+    return await this.requestJson<EditableArtifactResource>(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/editable-artifacts/imports`,
+      request,
+      {},
+      options,
+    );
+  }
+
+  async getEditableArtifact(
+    workspaceId: string,
+    artifactId: string,
+    options: ReadEditableArtifactResourceOptions,
+  ): Promise<EditableArtifactResource> {
+    return await this.requestJson<EditableArtifactResource>(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/editable-artifacts/${encodeURIComponent(artifactId)}`,
+      undefined,
+      { replicaId: options.replicaId },
+      options,
+    );
+  }
+
+  async listSessionEditableArtifacts(
+    workspaceId: string,
+    sourceSessionId: string,
+    options: ListSessionEditableArtifactResourcesOptions,
+  ): Promise<EditableArtifactListResource> {
+    return await this.requestJson<EditableArtifactListResource>(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/editable-artifacts`,
+      undefined,
+      { sourceSessionId, replicaId: options.replicaId },
+      options,
+    );
+  }
+
+  async pinEditableArtifactVersion(
+    workspaceId: string,
+    artifactId: string,
+    request: PinEditableArtifactVersionRequest,
+    options: Readonly<{ signal?: AbortSignal | undefined }> = {},
+  ): Promise<EditableArtifactPinnedVersionResource> {
+    return await this.requestJson<EditableArtifactPinnedVersionResource>(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/editable-artifacts/${encodeURIComponent(artifactId)}/versions`,
+      request,
+      {},
+      options,
+    );
+  }
+
+  async createEditableArtifactMaterialization(
+    workspaceId: string,
+    artifactId: string,
+    request: CreateEditableArtifactMaterializationRequest,
+    options: Readonly<{ signal?: AbortSignal | undefined }> = {},
+  ): Promise<EditableArtifactMaterializationJobResource> {
+    return await this.requestJson<EditableArtifactMaterializationJobResource>(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/editable-artifacts/${encodeURIComponent(artifactId)}/materializations`,
+      request,
+      {},
+      options,
+    );
+  }
+
+  async getEditableArtifactMaterialization(
+    workspaceId: string,
+    artifactId: string,
+    jobId: string,
+    options: ReadEditableArtifactMaterializationOptions,
+  ): Promise<EditableArtifactMaterializationJobResource> {
+    return await this.requestJson<EditableArtifactMaterializationJobResource>(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/editable-artifacts/${encodeURIComponent(artifactId)}/materializations/${encodeURIComponent(jobId)}`,
+      undefined,
+      { replicaId: options.replicaId },
+      options,
+    );
+  }
+
+  /** The caller owns the returned bounded response stream. */
+  async downloadEditableArtifactMaterialization(
+    workspaceId: string,
+    artifactId: string,
+    jobId: string,
+    options: ReadEditableArtifactMaterializationOptions,
+  ): Promise<Response> {
+    return await this.requestResponse(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/editable-artifacts/${encodeURIComponent(artifactId)}/materializations/${encodeURIComponent(jobId)}/download`,
+      { replicaId: options.replicaId },
+      options,
+    );
+  }
+
   async listWorkspaceArtifacts(
     workspaceId: string,
     options: WorkspaceArtifactListOptions = {},

package/src/artifacts.ts

@@ -0,0 +1,17 @@
+/** Artifact-only API client entry; keeps unrelated SDK surfaces out of editor bundles. */
+export { OpenGeniClient } from "./artifact-client";
+export type {
+  CreateEditableArtifactMaterializationRequest,
+  CreateEditableArtifactResourceRequest,
+  EditableArtifactListResource,
+  EditableArtifactMaterializationFormat,
+  EditableArtifactMaterializationJobResource,
+  EditableArtifactMaterializationResultResource,
+  EditableArtifactPinnedVersionResource,
+  EditableArtifactResource,
+  ListSessionEditableArtifactResourcesOptions,
+  PinEditableArtifactVersionRequest,
+  ReadEditableArtifactMaterializationOptions,
+  ReadEditableArtifactResourceOptions,
+} from "./editable-artifact-resources";
+export type { FetchLike, OpenGeniClientOptions, OpenGeniRequestOptions } from "./client";