@opengeni/sdk 2.5.0-canary.2 → 3.1.0

package/src/types.ts

@@ -1389,6 +1389,64 @@ export type SessionListResponse = {
   nextCursor: string | null;
 };
 
+export type WorkClaimSubjectType =
+  | "repository"
+  | "branch"
+  | "pull_request"
+  | "issue"
+  | "artifact"
+  | "release"
+  | "ci_run"
+  | "other";
+
+export type WorkClaimDiscoverySummary = {
+  id: string;
+  sessionId: string;
+  subject: {
+    namespace: string;
+    type: WorkClaimSubjectType;
+    canonicalKey: string;
+    displayLabel: string | null;
+  };
+  role: "working" | "reviewing" | "monitoring" | "delivering";
+  state: "active" | "released" | "superseded" | "stale";
+  revision: number;
+  provenance:
+    | "explicit_agent"
+    | "user_api"
+    | "trusted_integration"
+    | "session_resource"
+    | "system_lifecycle";
+  version: {
+    kind:
+      | "git_commit"
+      | "branch_head"
+      | "pull_request_head"
+      | "artifact_version"
+      | "release_version"
+      | "ci_run"
+      | "other";
+    value: string;
+  } | null;
+  observedAt: string;
+  updatedAt: string;
+  settledAt: string | null;
+};
+
+export type WorkDiscoveryProjection = {
+  claims: WorkClaimDiscoverySummary[];
+  claimsTruncated: boolean;
+  match: {
+    class: "exact_subject" | "title" | "goal" | "fuzzy";
+    field: "subject" | "title" | "goal" | "claim_key" | "claim_label";
+    scoreBand: "exact" | "strong" | "related";
+    claimId: string | null;
+  } | null;
+  possibleOverlap: boolean;
+  advisoryOnly: true;
+  noAdditionalAccess: true;
+};
+
 /** Compact, bounded session projection for workspace agent-topology browsers. */
 export type AgentTopologySession = {
   id: string;
@@ -1403,6 +1461,11 @@ export type AgentTopologySession = {
     titleTruncated: boolean;
   }>;
   status: SessionStatus;
+  goal: {
+    status: SessionGoalStatus;
+    summary: string;
+    summaryTruncated: boolean;
+  } | null;
   pause: {
     state: "active" | "paused";
     additionalBlockerCount: number;
@@ -1423,6 +1486,7 @@ export type AgentTopologySession = {
     failedDescendants: number;
     truncated: boolean;
   };
+  relatedWork: WorkDiscoveryProjection;
   createdAt: string;
   updatedAt: string;
 };
@@ -1431,6 +1495,8 @@ export type AgentTopologyPageResponse = {
   sessions: AgentTopologySession[];
   total: number;
   hasMore: boolean;
+  /** Operator rollout decision for human advisory presentation. */
+  humanAdvisoriesEnabled?: boolean | undefined;
   nextCursor: string | null;
 };
 
@@ -2776,6 +2842,8 @@ export type FirstPartyMcpToolName =
   | "task_note_save"
   | "task_note_archive"
   | "task_note_replace"
+  | "work_claim_upsert"
+  | "work_claim_release"
   | "knowledge_propose"
   | "knowledge_correct"
   | "task_note_promote_knowledge"
@@ -3403,8 +3471,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-08-personal-only-organization-setup-v1" as const;
+export const OPENGENI_API_CONTRACT_REVISION = "2026-08-organization-recovery-custody-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;
@@ -3437,6 +3504,7 @@ export type ClientConfig = {
   /** Native browser microphone capture + server-side transcription capability. */
   voiceInput?: ClientVoiceInputConfig | undefined;
   productAccessMode: ProductAccessMode;
+  managedAuthSessionSetMode: "legacy" | "dual" | "broker";
   auth: ClientAuthConfig;
   analytics: {
     consentRequired: boolean;
@@ -3857,6 +3925,108 @@ export type OrganizationRetentionPolicy = {
   version: number;
   updatedAt: string;
 };
+export type OrganizationRecoveryPolicyState =
+  | "pending_acceptance"
+  | "active"
+  | "degraded"
+  | "superseded"
+  | "disabled";
+export type OrganizationRecoveryOperationState =
+  | "collecting"
+  | "cooling"
+  | "executed"
+  | "cancelled"
+  | "expired"
+  | "superseded";
+export type OrganizationRecoveryUnavailableReason =
+  | "no_policy"
+  | "pending_acceptance"
+  | "degraded"
+  | "disabled"
+  | "identity_unavailable";
+export type OrganizationRecoveryMemberSummary = {
+  membershipId: string;
+  name: string | null;
+  email: string | null;
+};
+export type OrganizationRecoveryCustodian = OrganizationRecoveryMemberSummary & {
+  ordinal: number;
+  enrollmentState: "pending_acceptance" | "accepted" | "ineligible";
+  acceptedAt: string | null;
+};
+export type OrganizationRecoveryPolicy = {
+  id: string;
+  organizationId: string;
+  revision: number;
+  state: OrganizationRecoveryPolicyState;
+  custodians: OrganizationRecoveryCustodian[];
+  createdAt: string;
+  updatedAt: string;
+};
+export type OrganizationRecoveryApproval = OrganizationRecoveryMemberSummary & {
+  approvedAt: string;
+};
+export type OrganizationRecoveryOperation = {
+  id: string;
+  organizationId: string;
+  policyId: string;
+  policyRevision: number;
+  revision: number;
+  state: OrganizationRecoveryOperationState;
+  target: OrganizationRecoveryMemberSummary;
+  approvals: OrganizationRecoveryApproval[];
+  approvalCount: number;
+  quorumAt: string | null;
+  executableAt: string | null;
+  expiresAt: string;
+  executedAt: string | null;
+  cancelledAt: string | null;
+  notificationJournaled: boolean;
+  createdAt: string;
+  updatedAt: string;
+};
+export type OrganizationRecoveryCapabilities = {
+  configure: boolean;
+  accept: boolean;
+  disable: boolean;
+  start: boolean;
+  approve: boolean;
+  cancel: boolean;
+  execute: boolean;
+};
+export type OrganizationRecoveryOverview = {
+  organizationId: string;
+  availability: "available" | "recovery_unavailable";
+  unavailableReason: OrganizationRecoveryUnavailableReason | null;
+  recentReauthenticationAt: string | null;
+  eligibleMembers: OrganizationRecoveryMemberSummary[];
+  policy: OrganizationRecoveryPolicy | null;
+  operation: OrganizationRecoveryOperation | null;
+  capabilities: OrganizationRecoveryCapabilities;
+};
+export type ConfigureOrganizationRecoveryPolicyRequest = {
+  custodianMembershipIds: [string, string, string];
+  expectedPolicyRevision: number;
+  operationId: string;
+};
+export type AcceptOrganizationRecoveryCustodyRequest = {
+  expectedPolicyRevision: number;
+  operationId: string;
+};
+export type DisableOrganizationRecoveryPolicyRequest = AcceptOrganizationRecoveryCustodyRequest;
+export type StartOrganizationRecoveryOperationRequest = {
+  targetMembershipId: string;
+  expectedPolicyRevision: number;
+  operationId: string;
+};
+export type OrganizationRecoveryOperationCommandRequest = {
+  expectedOperationRevision: number;
+  operationId: string;
+};
+export type OrganizationRecoveryMutationResponse = {
+  replay: boolean;
+  overview: OrganizationRecoveryOverview;
+};
 export type CreateOrganizationInvitationRequest = {
   email: string;
   name?: string;
@@ -4765,6 +4935,20 @@ export type VariableSet = {
   updatedAt: string;
 };
 
+/** Exact-ID attachment metadata; intentionally excludes catalog and secret metadata. */
+export type VariableSetAttachmentMetadata = {
+  id: string;
+  scope: "organization" | "workspace" | "user";
+};
+
+export type ResolveVariableSetAttachmentsRequest = {
+  variableSetIds: string[];
+};
+
+export type ResolveVariableSetAttachmentsResponse = {
+  variableSets: VariableSetAttachmentMetadata[];
+};
+
 /** @deprecated use VariableSetVariableMetadata */
 export type WorkspaceEnvironmentVariableMetadata = VariableSetVariableMetadata;