@opengeni/sdk 0.25.5 → 0.26.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/sdk",
-  "version": "0.25.5",
+  "version": "0.26.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": {

package/src/client.ts

@@ -46,6 +46,7 @@ import type {
   CreateCapabilityCatalogItemRequest,
   CreateCheckoutRequest,
   CreateCheckoutResponse,
+  ConnectOpenGeniSlackBotRequest,
   CreateConnectionRequest,
   CreateDocumentBaseRequest,
   CreateFileUploadRequest,
@@ -196,6 +197,18 @@ import type {
   OAuthStartRequest,
   OAuthStartResponse,
 } from "./types";
+import type {
+  ActivateWorkspaceInstructionPolicyRequest,
+  CreateWorkspaceInstructionPolicyDraftRequest,
+  ImportLegacyWorkspaceInstructionPolicyDraftRequest,
+  RollbackWorkspaceInstructionPolicyRequest,
+  WorkspaceInstructionPolicyActivationResponse,
+  WorkspaceInstructionPolicyDiffRequest,
+  WorkspaceInstructionPolicyDiffResponse,
+  WorkspaceInstructionPolicyListOptions,
+  WorkspaceInstructionPolicyListResponse,
+  WorkspaceInstructionPolicyRevision,
+} from "./workspace-instruction-policies";
 import {
   OPENGENI_API_CONTRACT_HEADER,
   OPENGENI_API_CONTRACT_REVISION,
@@ -1613,6 +1626,96 @@ export class OpenGeniClient {
     return await this.requestJson<Workspace>("PATCH", `/v1/workspaces/${workspaceId}`, request);
   }
 
+  /** Inspect immutable instruction-policy history, active heads, and activation audit evidence. */
+  async listWorkspaceInstructionPolicies(
+    workspaceId: string,
+    options: WorkspaceInstructionPolicyListOptions = {},
+  ): Promise<WorkspaceInstructionPolicyListResponse> {
+    const params = new URLSearchParams();
+    if (options.kind !== undefined) params.set("kind", options.kind);
+    if (options.scope !== undefined) params.set("scope", options.scope);
+    if (options.roleKey !== undefined) params.set("roleKey", options.roleKey);
+    if (options.afterRevision !== undefined) {
+      params.set("afterRevision", String(options.afterRevision));
+    }
+    if (options.limit !== undefined) params.set("limit", String(options.limit));
+    const query = params.toString();
+    return await this.requestJson<WorkspaceInstructionPolicyListResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/instruction-policies${query ? `?${query}` : ""}`,
+    );
+  }
+
+  async getWorkspaceInstructionPolicyRevision(
+    workspaceId: string,
+    revisionId: string,
+  ): Promise<WorkspaceInstructionPolicyRevision> {
+    return await this.requestJson<WorkspaceInstructionPolicyRevision>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/instruction-policies/${encodeURIComponent(revisionId)}`,
+    );
+  }
+
+  async createWorkspaceInstructionPolicyDraft(
+    workspaceId: string,
+    request: CreateWorkspaceInstructionPolicyDraftRequest,
+  ): Promise<WorkspaceInstructionPolicyRevision> {
+    return await this.requestJson<WorkspaceInstructionPolicyRevision>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/instruction-policies/drafts`,
+      request,
+    );
+  }
+
+  /** Import the stored legacy workspace override as an inactive charter draft. */
+  async importLegacyWorkspaceInstructionPolicyDraft(
+    workspaceId: string,
+    request: ImportLegacyWorkspaceInstructionPolicyDraftRequest = {},
+  ): Promise<WorkspaceInstructionPolicyRevision> {
+    return await this.requestJson<WorkspaceInstructionPolicyRevision>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/instruction-policies/import-legacy`,
+      request,
+    );
+  }
+
+  async diffWorkspaceInstructionPolicyRevisions(
+    workspaceId: string,
+    request: WorkspaceInstructionPolicyDiffRequest,
+  ): Promise<WorkspaceInstructionPolicyDiffResponse> {
+    const params = new URLSearchParams({
+      fromRevisionId: request.fromRevisionId,
+      toRevisionId: request.toRevisionId,
+    });
+    return await this.requestJson<WorkspaceInstructionPolicyDiffResponse>(
+      "GET",
+      `/v1/workspaces/${workspaceId}/instruction-policies/diff?${params}`,
+    );
+  }
+
+  async activateWorkspaceInstructionPolicyRevision(
+    workspaceId: string,
+    revisionId: string,
+    request: ActivateWorkspaceInstructionPolicyRequest,
+  ): Promise<WorkspaceInstructionPolicyActivationResponse> {
+    return await this.requestJson<WorkspaceInstructionPolicyActivationResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/instruction-policies/${encodeURIComponent(revisionId)}/activate`,
+      request,
+    );
+  }
+
+  async rollbackWorkspaceInstructionPolicyRevision(
+    workspaceId: string,
+    request: RollbackWorkspaceInstructionPolicyRequest,
+  ): Promise<WorkspaceInstructionPolicyActivationResponse> {
+    return await this.requestJson<WorkspaceInstructionPolicyActivationResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/instruction-policies/rollback`,
+      request,
+    );
+  }
+
   /**
    * Delete a workspace and everything in it. Refused (409) for the account's
    * only workspace and while it still has a running session. Irreversible.
@@ -2486,6 +2589,19 @@ export class OpenGeniClient {
     return response.connection;
   }
 
+  /** Validate and store/reinstall the workspace-shared OpenGeni Slack bot credential. */
+  async connectOpenGeniSlackBot(
+    workspaceId: string,
+    request: ConnectOpenGeniSlackBotRequest,
+  ): Promise<ConnectionMetadata> {
+    const response = await this.requestJson<ConnectionResponse>(
+      "POST",
+      `/v1/workspaces/${workspaceId}/connections/slack-bot`,
+      request,
+    );
+    return response.connection;
+  }
+
   async updateConnection(
     workspaceId: string,
     connectionId: string,

package/src/index.ts

@@ -53,6 +53,29 @@ export type {
 } from "./stream";
 export { streamWorkspaceControlEvents } from "./workspace-control-stream";
 export type { WorkspaceControlStreamTransport } from "./workspace-control-stream";
+export { normalizeWorkspaceInstructionPolicyRoleKey } from "./workspace-instruction-policies";
+export type {
+  ActivateWorkspaceInstructionPolicyRequest,
+  CreateWorkspaceInstructionPolicyDraftRequest,
+  ImportLegacyWorkspaceInstructionPolicyDraftRequest,
+  RollbackWorkspaceInstructionPolicyRequest,
+  WorkspaceInstructionPolicyActivationEvent,
+  WorkspaceInstructionPolicyActivationResponse,
+  WorkspaceInstructionPolicyActivationType,
+  WorkspaceInstructionPolicyConflictResponse,
+  WorkspaceInstructionPolicyDiffRequest,
+  WorkspaceInstructionPolicyDiffResponse,
+  WorkspaceInstructionPolicyDraftProvenanceSource,
+  WorkspaceInstructionPolicyHead,
+  WorkspaceInstructionPolicyKind,
+  WorkspaceInstructionPolicyListOptions,
+  WorkspaceInstructionPolicyListResponse,
+  WorkspaceInstructionPolicyProvenanceSource,
+  WorkspaceInstructionPolicyRevision,
+  WorkspaceInstructionPolicyRevisionIdentity,
+  WorkspaceInstructionPolicyScope,
+  WorkspaceInstructionPolicyTarget,
+} from "./workspace-instruction-policies";
 export {
   DEFAULT_WORKSPACE_TRANSCRIPTION_POLICY,
   authorizeTranscriptionAdapter,
@@ -168,6 +191,7 @@ export type {
   CreateApiKeyRequest,
   CreateApiKeyResponse,
   CreateCapabilityCatalogItemRequest,
+  ConnectOpenGeniSlackBotRequest,
   CreateConnectionRequest,
   CreateCheckoutRequest,
   CreateCheckoutResponse,

package/src/types.ts

@@ -389,6 +389,8 @@ export type ConnectionMetadata = {
   lastUsedAt: string | null;
   lastError: string | null;
   version: number;
+  verifiedInstallAt?: string | null;
+  verifiedInstallVersion?: number | null;
   metadata: Record<string, unknown>;
   createdBySubjectId: string | null;
   updatedBySubjectId: string | null;
@@ -406,6 +408,13 @@ export type CreateConnectionRequest = {
   metadata?: Record<string, unknown> | undefined;
 };
 
+export type ConnectOpenGeniSlackBotRequest = {
+  /** Write-only Slack bot token. It is never returned by the API. */
+  token: string;
+  /** Existing OpenGeni Slack bot connection to reinstall in place. */
+  connectionId?: string | undefined;
+};
+
 export type UpdateConnectionRequest = {
   providerDomain?: string | undefined;
   subjectId?: string | null | undefined;
@@ -1506,6 +1515,7 @@ export type ScheduledTaskAgentConfig = {
   resources: ResourceRef[];
   tools: ToolRef[];
   metadata: Record<string, unknown>;
+  slackBotConnectionId?: string | undefined;
   model?: string | undefined;
   reasoningEffort?: ReasoningEffort | undefined;
   sandboxBackend?: SandboxBackend | undefined;
@@ -2488,6 +2498,7 @@ export type ScheduledTaskAgentConfigInput = {
   resources?: ResourceRef[] | undefined;
   tools?: ToolRef[] | undefined;
   metadata?: Record<string, unknown> | undefined;
+  slackBotConnectionId?: string | undefined;
   model?: string | undefined;
   reasoningEffort?: ReasoningEffort | undefined;
   sandboxBackend?: SandboxBackend | undefined;

package/src/workspace-instruction-policies.ts

@@ -0,0 +1,124 @@
+export type WorkspaceInstructionPolicyKind = "charter" | "policy";
+export type WorkspaceInstructionPolicyScope = "global" | "role";
+export type WorkspaceInstructionPolicyProvenanceSource =
+  | "human"
+  | "onboarding"
+  | "knowledge_proposal"
+  | "legacy_import";
+export type WorkspaceInstructionPolicyDraftProvenanceSource = Exclude<
+  WorkspaceInstructionPolicyProvenanceSource,
+  "legacy_import"
+>;
+export type WorkspaceInstructionPolicyActivationType = "activate" | "rollback";
+
+export function normalizeWorkspaceInstructionPolicyRoleKey(value: string): string {
+  return value.normalize("NFKC").trim().toLowerCase().replace(/\s+/gu, "-").replace(/-+/g, "-");
+}
+
+export type WorkspaceInstructionPolicyTarget = {
+  kind: WorkspaceInstructionPolicyKind;
+  scope: WorkspaceInstructionPolicyScope;
+  roleKey: string | null;
+};
+
+export type WorkspaceInstructionPolicyRevisionIdentity = {
+  id: string;
+  revision: number;
+  contentHash: string;
+};
+
+export type WorkspaceInstructionPolicyRevision = WorkspaceInstructionPolicyRevisionIdentity &
+  WorkspaceInstructionPolicyTarget & {
+    accountId: string;
+    workspaceId: string;
+    content: string;
+    provenance: {
+      source: WorkspaceInstructionPolicyProvenanceSource;
+      sourceId: string | null;
+    };
+    supersedesRevisionId: string | null;
+    createdBySubjectId: string;
+    createdAt: string;
+  };
+
+export type WorkspaceInstructionPolicyHead = WorkspaceInstructionPolicyTarget & {
+  workspaceId: string;
+  revisionId: string;
+  revision: number;
+  contentHash: string;
+  activationVersion: number;
+  activatedAt: string;
+};
+
+export type WorkspaceInstructionPolicyActivationEvent = WorkspaceInstructionPolicyTarget & {
+  id: string;
+  accountId: string;
+  workspaceId: string;
+  type: WorkspaceInstructionPolicyActivationType;
+  activationVersion: number;
+  oldRevision: WorkspaceInstructionPolicyRevisionIdentity | null;
+  newRevision: WorkspaceInstructionPolicyRevisionIdentity;
+  actorSubjectId: string;
+  reason: string;
+  createdAt: string;
+};
+
+export type CreateWorkspaceInstructionPolicyDraftRequest = WorkspaceInstructionPolicyTarget & {
+  content: string;
+  provenanceSource?: WorkspaceInstructionPolicyDraftProvenanceSource;
+  provenanceSourceId?: string | null;
+  supersedesRevisionId?: string | null;
+};
+
+export type ImportLegacyWorkspaceInstructionPolicyDraftRequest = {
+  supersedesRevisionId?: string | null;
+};
+
+export type WorkspaceInstructionPolicyListOptions = {
+  kind?: WorkspaceInstructionPolicyKind;
+  scope?: WorkspaceInstructionPolicyScope;
+  roleKey?: string;
+  afterRevision?: number;
+  limit?: number;
+};
+
+export type WorkspaceInstructionPolicyListResponse = {
+  revisions: WorkspaceInstructionPolicyRevision[];
+  activeHeads: WorkspaceInstructionPolicyHead[];
+  activationEvents: WorkspaceInstructionPolicyActivationEvent[];
+  nextAfterRevision: number | null;
+};
+
+export type WorkspaceInstructionPolicyDiffRequest = {
+  fromRevisionId: string;
+  toRevisionId: string;
+};
+
+export type WorkspaceInstructionPolicyDiffResponse = {
+  from: WorkspaceInstructionPolicyRevision;
+  to: WorkspaceInstructionPolicyRevision;
+  format: "unified";
+  diff: string;
+};
+
+export type ActivateWorkspaceInstructionPolicyRequest = {
+  expectedCurrentRevisionId: string | null;
+  reason: string;
+};
+
+export type RollbackWorkspaceInstructionPolicyRequest = {
+  targetRevisionId: string;
+  expectedCurrentRevisionId: string;
+  reason: string;
+};
+
+export type WorkspaceInstructionPolicyActivationResponse = {
+  head: WorkspaceInstructionPolicyHead;
+  event: WorkspaceInstructionPolicyActivationEvent;
+};
+
+export type WorkspaceInstructionPolicyConflictResponse = {
+  code: "WORKSPACE_INSTRUCTION_POLICY_CONFLICT";
+  message: string;
+  currentHead: WorkspaceInstructionPolicyHead | null;
+};