@opengeni/sdk 1.0.1 → 2.2.0-canary.0

package/dist/workspace-instruction-policies.d.ts

@@ -36,6 +36,11 @@ export type WorkspaceInstructionPolicyHead = WorkspaceInstructionPolicyTarget &
     activationVersion: number;
     activatedAt: string;
 };
+export type WorkspaceInstructionPolicyInactiveHead = WorkspaceInstructionPolicyTarget & {
+    workspaceId: string;
+    activationVersion: number;
+    deactivatedAt: string;
+};
 export type WorkspaceInstructionPolicyActivationEvent = WorkspaceInstructionPolicyTarget & {
     id: string;
     operationId: string;
@@ -49,6 +54,18 @@ export type WorkspaceInstructionPolicyActivationEvent = WorkspaceInstructionPoli
     reason: string;
     createdAt: string;
 };
+export type WorkspaceInstructionPolicyDeactivationEvent = WorkspaceInstructionPolicyTarget & {
+    id: string;
+    operationId: string;
+    accountId: string;
+    workspaceId: string;
+    type: "automatic_deactivate";
+    activationVersion: number;
+    oldRevision: WorkspaceInstructionPolicyRevisionIdentity;
+    actorSubjectId: string;
+    reason: string;
+    createdAt: string;
+};
 export type CreateWorkspaceInstructionPolicyDraftRequest = WorkspaceInstructionPolicyTarget & {
     operationId?: string;
     content: string;
@@ -70,7 +87,12 @@ export type WorkspaceInstructionPolicyListOptions = {
 export type WorkspaceInstructionPolicyListResponse = {
     revisions: WorkspaceInstructionPolicyRevision[];
     activeHeads: WorkspaceInstructionPolicyHead[];
+    /** Additive current inactive target boundaries; absent on pre-controller servers. */
+    inactiveHeads?: WorkspaceInstructionPolicyInactiveHead[];
+    inactiveHeadsTruncated?: boolean;
     activationEvents: WorkspaceInstructionPolicyActivationEvent[];
+    /** Additive lifecycle history; absent on pre-controller servers. */
+    deactivationEvents?: WorkspaceInstructionPolicyDeactivationEvent[];
     nextAfterRevision: number | null;
 };
 export type WorkspaceInstructionPolicyDiffRequest = {

package/dist/workspace-learning.d.ts

@@ -0,0 +1,124 @@
+export type WorkspaceLearningMode = "off" | "suggest" | "automatic";
+export type WorkspaceLearningOverrideMode = WorkspaceLearningMode | "inherit";
+export type WorkspaceLearningSourceOverrideInput = {
+    kind: string;
+    id: string;
+    mode: WorkspaceLearningOverrideMode;
+};
+export type WorkspaceLearningSourceOverride = Omit<WorkspaceLearningSourceOverrideInput, "mode"> & {
+    mode: WorkspaceLearningMode;
+};
+export type WorkspaceLearningPolicyRevisionIdentity = {
+    id: string;
+    revision: number;
+    policyHash: string;
+};
+export type WorkspaceLearningPolicyRevision = WorkspaceLearningPolicyRevisionIdentity & {
+    operationId: string;
+    accountId: string;
+    workspaceId: string;
+    workspaceMode: WorkspaceLearningMode;
+    sourceOverrides: WorkspaceLearningSourceOverride[];
+    supersedesRevisionId: string | null;
+    createdBySubjectId: string;
+    createdAt: string;
+};
+export type WorkspaceLearningPolicyHead = Omit<WorkspaceLearningPolicyRevisionIdentity, "id"> & {
+    accountId: string;
+    workspaceId: string;
+    revisionId: string;
+    activationVersion: number;
+    activatedAt: string;
+};
+export type WorkspaceLearningPolicyEvent = {
+    id: string;
+    operationId: string;
+    accountId: string;
+    workspaceId: string;
+    type: "activate" | "rollback";
+    activationVersion: number;
+    oldRevision: WorkspaceLearningPolicyRevisionIdentity | null;
+    newRevision: WorkspaceLearningPolicyRevisionIdentity;
+    actorSubjectId: string;
+    reason: string;
+    createdAt: string;
+};
+export type GovernedLearningDecisionReceipt = {
+    id: string;
+    sourceKind: "scoped-knowledge-evidence" | "task-note";
+    sourceId: string;
+    proposalId: string;
+    policySnapshotId: string;
+    policyRevisionId: string | null;
+    policyActivationVersion: number;
+    effectiveMode: WorkspaceLearningMode;
+    confidenceBps: number;
+    conflictCount: number;
+    outcome: "off" | "suggest" | "automatic" | "confidence" | "conflict" | "stale" | "revoked";
+    reasons: string[];
+    automaticEligible: boolean;
+    createdAt: string;
+};
+export type GovernedLearningActivationReceipt = {
+    id: string;
+    decisionReceiptId: string;
+    initiatingHumanSubjectId: string;
+    serviceActorSubjectId: string;
+    sourceKind: "scoped-knowledge-evidence" | "task-note";
+    sourceId: string;
+    destination: "instruction_policy" | "preference";
+    destinationRevisionId: string;
+    destinationOldRevisionId: string | null;
+    destinationOldContentHash: string | null;
+    destinationOldVersion: number;
+    destinationNewContentHash: string;
+    destinationNewVersion: number;
+    effectiveAt: string;
+    createdAt: string;
+};
+export type GovernedLearningActivationUndoReceipt = {
+    id: string;
+    activationReceiptId: string;
+    initiatingHumanSubjectId: string;
+    serviceActorSubjectId: string;
+    destination: "instruction_policy" | "preference";
+    destinationActivatedRevisionId: string;
+    destinationRestoredRevisionId: string | null;
+    destinationOldVersion: number;
+    destinationNewVersion: number;
+    effectiveAt: string;
+    createdAt: string;
+};
+export type WorkspaceLearningHistoryResponse = {
+    head: WorkspaceLearningPolicyHead | null;
+    revisions: WorkspaceLearningPolicyRevision[];
+    policyEvents: WorkspaceLearningPolicyEvent[];
+    decisions: GovernedLearningDecisionReceipt[];
+    activations: GovernedLearningActivationReceipt[];
+    undos: GovernedLearningActivationUndoReceipt[];
+    truncated: boolean;
+    effectiveBoundary: "next_accepted_attempt";
+};
+export type CreateWorkspaceLearningPolicyRevisionRequest = {
+    operationId?: string;
+    workspaceMode: WorkspaceLearningMode;
+    sourceOverrides?: WorkspaceLearningSourceOverrideInput[];
+    supersedesRevisionId?: string | null;
+};
+export type ActivateWorkspaceLearningPolicyRevisionRequest = {
+    operationId?: string;
+    expectedCurrentRevisionId: string | null;
+    expectedActivationVersion: number;
+    reason: string;
+};
+export type RollbackWorkspaceLearningPolicyRevisionRequest = ActivateWorkspaceLearningPolicyRevisionRequest & {
+    targetRevisionId: string;
+    expectedCurrentRevisionId: string;
+};
+export type WorkspaceLearningPolicyMutationResponse = {
+    head: WorkspaceLearningPolicyHead;
+    event: WorkspaceLearningPolicyEvent;
+};
+export type WorkspaceLearningHistoryOptions = {
+    limit?: number;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/sdk",
-  "version": "1.0.1",
+  "version": "2.2.0-canary.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": {
@@ -38,6 +38,18 @@
       "types": "./dist/memory-slack.d.ts",
       "import": "./dist/memory-slack.js"
     },
+    "./automations": {
+      "types": "./dist/automations.d.ts",
+      "import": "./dist/automations.js"
+    },
+    "./pr-review": {
+      "types": "./dist/pr-review.d.ts",
+      "import": "./dist/pr-review.js"
+    },
+    "./organization-private-session-settings": {
+      "types": "./dist/organization-private-session-settings.d.ts",
+      "import": "./dist/organization-private-session-settings.js"
+    },
     "./realtime": {
       "types": "./dist/realtime.d.ts",
       "import": "./dist/realtime.js"
@@ -73,7 +85,7 @@
     "prepublishOnly": "bash ../../scripts/prepublish-guard"
   },
   "dependencies": {
-    "@opengeni/contracts": "^1.0.1"
+    "@opengeni/contracts": "^2.2.0-canary.0"
   },
   "engines": {
     "node": ">=18"

package/src/automations-client.ts

@@ -0,0 +1,118 @@
+import type {
+  AutomationRun,
+  AutomationSource,
+  AutomationTrigger,
+  AutomationWebhookResult,
+  CreateAutomationSourceRequest,
+  CreateAutomationTriggerRequest,
+  TriggerAutomationManuallyRequest,
+  UpdateAutomationSourceRequest,
+  UpdateAutomationTriggerRequest,
+} from "@opengeni/contracts";
+import type { OpenGeniClient as OpenGeniCoreClient } from "./client";
+
+export type OpenGeniAutomationsTransport = Pick<OpenGeniCoreClient, "requestJson">;
+
+export class OpenGeniAutomationsClient {
+  constructor(private readonly client: OpenGeniAutomationsTransport) {}
+
+  async listSources(workspaceId: string): Promise<AutomationSource[]> {
+    const result = await this.client.requestJson<{ sources: AutomationSource[] }>(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources`,
+    );
+    return result.sources;
+  }
+
+  async createSource(
+    workspaceId: string,
+    request: CreateAutomationSourceRequest,
+  ): Promise<AutomationSource> {
+    return await this.client.requestJson(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources`,
+      request,
+    );
+  }
+
+  async updateSource(
+    workspaceId: string,
+    sourceId: string,
+    request: UpdateAutomationSourceRequest,
+  ): Promise<AutomationSource> {
+    return await this.client.requestJson(
+      "PATCH",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources/${encodeURIComponent(sourceId)}`,
+      request,
+    );
+  }
+
+  async disableSource(workspaceId: string, sourceId: string): Promise<void> {
+    await this.client.requestJson(
+      "DELETE",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources/${encodeURIComponent(sourceId)}`,
+    );
+  }
+
+  async listTriggers(workspaceId: string): Promise<AutomationTrigger[]> {
+    const result = await this.client.requestJson<{ triggers: AutomationTrigger[] }>(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers`,
+    );
+    return result.triggers;
+  }
+
+  async createTrigger(
+    workspaceId: string,
+    request: CreateAutomationTriggerRequest,
+  ): Promise<AutomationTrigger> {
+    return await this.client.requestJson(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers`,
+      request,
+    );
+  }
+
+  async updateTrigger(
+    workspaceId: string,
+    triggerId: string,
+    request: UpdateAutomationTriggerRequest,
+  ): Promise<AutomationTrigger> {
+    return await this.client.requestJson(
+      "PATCH",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers/${encodeURIComponent(triggerId)}`,
+      request,
+    );
+  }
+
+  async disableTrigger(
+    workspaceId: string,
+    triggerId: string,
+    expectedRevision: number,
+  ): Promise<void> {
+    await this.client.requestJson(
+      "DELETE",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/triggers/${encodeURIComponent(triggerId)}?expectedRevision=${expectedRevision}`,
+    );
+  }
+
+  async listRuns(workspaceId: string): Promise<AutomationRun[]> {
+    const result = await this.client.requestJson<{ runs: AutomationRun[] }>(
+      "GET",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/runs`,
+    );
+    return result.runs;
+  }
+
+  async triggerManually(
+    workspaceId: string,
+    sourceId: string,
+    request: TriggerAutomationManuallyRequest,
+  ): Promise<AutomationWebhookResult> {
+    return await this.client.requestJson(
+      "POST",
+      `/v1/workspaces/${encodeURIComponent(workspaceId)}/automations/sources/${encodeURIComponent(sourceId)}/events`,
+      request,
+    );
+  }
+}

package/src/automations.ts

@@ -0,0 +1,15 @@
+export { OpenGeniAutomationsClient } from "./automations-client";
+export type { OpenGeniAutomationsTransport } from "./automations-client";
+export type {
+  AutomationAcceptedExecution,
+  AutomationNormalizedEvent,
+  AutomationRun,
+  AutomationSource,
+  AutomationTrigger,
+  AutomationWebhookResult,
+  CreateAutomationSourceRequest,
+  CreateAutomationTriggerRequest,
+  TriggerAutomationManuallyRequest,
+  UpdateAutomationSourceRequest,
+  UpdateAutomationTriggerRequest,
+} from "@opengeni/contracts";