@opengeni/sdk 0.37.0 → 0.41.0

package/src/types.ts

@@ -461,10 +461,13 @@ export type RepositoryResourceRef = {
   githubRepositoryId?: number | undefined;
 };
 
+/** Value mirror of `@opengeni/contracts`; parity-tested without adding an SDK runtime dependency. */
+export const DEFAULT_FILE_RESOURCE_MOUNT_ROOT = ".opengeni/files" as const;
+
 export type FileResourceRef = {
   kind: "file";
   fileId: string;
-  /** Optional workspace-relative override; defaults to `files/<file-id>`. */
+  /** Optional workspace-relative override; defaults to `.opengeni/files/<file-id>`. */
   mountPath?: string | undefined;
 };
 
@@ -641,6 +644,22 @@ export type OpenGeniSlackBotInstallStart = {
 export type GoogleDriveTargetScope = "user" | "workspace" | "organization";
 export type GoogleDriveSyncCadence = "manual" | "hourly" | "daily";
 export type GoogleDriveReadPolicy = "allow" | "ask" | "block";
+export type GoogleDriveConnectionLifecycleState =
+  | "active"
+  | "paused"
+  | "token_revoked"
+  | "app_removed"
+  | "disconnected"
+  | "reconnect_required"
+  | "reconsent_required";
+
+export type GoogleDriveConnectionLifecycle =
+  | {
+      state: Exclude<GoogleDriveConnectionLifecycleState, "app_removed">;
+      recoverable: true;
+      observedAt: string;
+    }
+  | { state: "app_removed"; recoverable: false; observedAt: string };
 
 export type GoogleDriveSelectedSource = {
   id: string;
@@ -661,6 +680,7 @@ export type GoogleDriveConnectionMetadata = {
   googleDisplayName: string | null;
   verifiedAt: string;
   accessMode: "metadata_readonly" | "readonly";
+  lifecycle?: GoogleDriveConnectionLifecycle | undefined;
   selectedSources?: GoogleDriveSelectedSource[] | undefined;
   /** @deprecated Read selectedSources; retained while existing connections migrate. */
   selectedSource?: GoogleDriveSelectedSource | null | undefined;
@@ -676,6 +696,16 @@ export type GoogleDriveOAuthStartResponse = {
   expiresAt: string;
 };
 
+export type GoogleDriveLifecycleActionRequest = {
+  action: "pause" | "resume";
+  expectedVersion: number;
+};
+
+export type GoogleDriveDisconnectRequest = {
+  expectedVersion: number;
+  idempotencyKey: string;
+};
+
 export type GoogleDriveBrowseItem = {
   id: string;
   name: string;
@@ -1000,8 +1030,6 @@ export type HumanInputQuestion = {
   allowOther: boolean;
   validation?:
     | {
-        minLength?: number | null | undefined;
-        maxLength?: number | null | undefined;
         minSelections?: number | null | undefined;
         maxSelections?: number | null | undefined;
       }
@@ -2104,6 +2132,7 @@ export type ModelCapabilitiesV1 = {
     codeExecution: ModelCapabilityStateV1;
   };
   inputModalities: Array<"text" | "image" | "audio">;
+  inputFileMediaTypes?: string[] | undefined;
   outputModalities: Array<"text" | "image" | "audio">;
   transports: {
     sse: ModelCapabilityStateV1;
@@ -3365,6 +3394,8 @@ export type KnowledgeSourceKind =
   | "other";
 export type DocumentSearchMode = "hybrid" | "vector" | "keyword";
 
+export type DocumentAuthorityKind = "organization" | "workspace" | "personal";
+
 export type DocumentVisibility = "workspace" | "private";
 
 export type DocumentCurationStatus = "none" | "pending" | "suggested" | "auto_filed" | "failed";
@@ -3406,6 +3437,9 @@ export type Document = {
   sourceUpdatedAt: string | null;
   sourceVersion: string | null;
   aclTags: string[];
+  authorityKind: DocumentAuthorityKind;
+  authorityWorkspaceId: string | null;
+  authoritySubjectId: string | null;
   visibility: DocumentVisibility;
   createdBy: string | null;
   agentAccess: boolean;
@@ -3440,6 +3474,9 @@ export type DocumentSearchResult = {
   sourceUpdatedAt: string | null;
   sourceVersion: string | null;
   aclTags: string[];
+  authorityKind: DocumentAuthorityKind;
+  authorityWorkspaceId: string | null;
+  authoritySubjectId: string | null;
 };
 
 export type CreateDocumentBaseRequest = {
@@ -3459,6 +3496,7 @@ export type AddDocumentRequest = {
   sourceUpdatedAt?: string | undefined;
   sourceVersion?: string | undefined;
   aclTags?: string[] | undefined;
+  authorityKind?: DocumentAuthorityKind | undefined;
   visibility?: DocumentVisibility | undefined;
   agentAccess?: boolean | undefined;
 };
@@ -3468,6 +3506,7 @@ export type CreateKnowledgeDropRequest = {
   fileId?: string | undefined;
   filename?: string | undefined;
   title?: string | undefined;
+  authorityKind?: DocumentAuthorityKind | undefined;
   visibility?: DocumentVisibility | undefined;
   agentAccess?: boolean | undefined;
 };

package/src/workspace-instruction-policies.ts

@@ -1,3 +1,5 @@
+export const WORKSPACE_INSTRUCTION_POLICY_CONTENT_MAX_CHARS = 262_144;
+
 export type WorkspaceInstructionPolicyKind = "charter" | "policy";
 export type WorkspaceInstructionPolicyScope = "global" | "role";
 export type WorkspaceInstructionPolicyProvenanceSource =
@@ -29,6 +31,7 @@ export type WorkspaceInstructionPolicyRevisionIdentity = {
 
 export type WorkspaceInstructionPolicyRevision = WorkspaceInstructionPolicyRevisionIdentity &
   WorkspaceInstructionPolicyTarget & {
+    operationId: string;
     accountId: string;
     workspaceId: string;
     content: string;
@@ -52,6 +55,7 @@ export type WorkspaceInstructionPolicyHead = WorkspaceInstructionPolicyTarget &
 
 export type WorkspaceInstructionPolicyActivationEvent = WorkspaceInstructionPolicyTarget & {
   id: string;
+  operationId: string;
   accountId: string;
   workspaceId: string;
   type: WorkspaceInstructionPolicyActivationType;
@@ -64,6 +68,7 @@ export type WorkspaceInstructionPolicyActivationEvent = WorkspaceInstructionPoli
 };
 
 export type CreateWorkspaceInstructionPolicyDraftRequest = WorkspaceInstructionPolicyTarget & {
+  operationId?: string;
   content: string;
   provenanceSource?: WorkspaceInstructionPolicyDraftProvenanceSource;
   provenanceSourceId?: string | null;
@@ -71,6 +76,7 @@ export type CreateWorkspaceInstructionPolicyDraftRequest = WorkspaceInstructionP
 };
 
 export type ImportLegacyWorkspaceInstructionPolicyDraftRequest = {
+  operationId?: string;
   supersedesRevisionId?: string | null;
 };
 
@@ -102,13 +108,17 @@ export type WorkspaceInstructionPolicyDiffResponse = {
 };
 
 export type ActivateWorkspaceInstructionPolicyRequest = {
+  operationId?: string;
   expectedCurrentRevisionId: string | null;
+  expectedActivationVersion?: number;
   reason: string;
 };
 
 export type RollbackWorkspaceInstructionPolicyRequest = {
+  operationId?: string;
   targetRevisionId: string;
   expectedCurrentRevisionId: string;
+  expectedActivationVersion?: number;
   reason: string;
 };
 
@@ -122,3 +132,68 @@ export type WorkspaceInstructionPolicyConflictResponse = {
   message: string;
   currentHead: WorkspaceInstructionPolicyHead | null;
 };
+
+export type WorkspaceInstructionPolicyOperationReuseResponse = {
+  code: "WORKSPACE_INSTRUCTION_POLICY_OPERATION_REUSED";
+  message: string;
+};
+
+export type WorkspaceInstructionPolicyOnboardingProposalSource = {
+  id: string;
+  version: string;
+  confidenceBps: number;
+};
+
+export type CreateWorkspaceInstructionPolicyOnboardingProposalRequest =
+  WorkspaceInstructionPolicyTarget & {
+    operationId?: string;
+    content: string;
+    sourceId: string;
+    sourceVersion: string;
+    confidenceBps: number;
+    expectedCurrentRevisionId: string | null;
+    expectedActivationVersion: number;
+  };
+
+export type WorkspaceInstructionPolicyOnboardingProposal = WorkspaceInstructionPolicyTarget & {
+  id: string;
+  operationId: string;
+  accountId: string;
+  workspaceId: string;
+  source: WorkspaceInstructionPolicyOnboardingProposalSource;
+  baseline: WorkspaceInstructionPolicyHead | null;
+  draft: WorkspaceInstructionPolicyRevision;
+  status: "proposed";
+  createdBySubjectId: string;
+  createdAt: string;
+};
+
+export type WorkspaceInstructionPolicyOnboardingProposalListOptions = {
+  limit?: number;
+};
+
+export type WorkspaceInstructionPolicyOnboardingProposalListResponse = {
+  proposals: WorkspaceInstructionPolicyOnboardingProposal[];
+  truncated: boolean;
+};
+
+export type WorkspaceInstructionPolicyOnboardingProposalContentErrorResponse = {
+  code:
+    | "WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_EMPTY"
+    | "WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_OVERSIZED";
+  message: string;
+  maxChars: number;
+};
+
+export type WorkspaceInstructionPolicyOnboardingProposalStaleResponse = {
+  code: "WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_STALE";
+  message: string;
+  currentHead: WorkspaceInstructionPolicyHead | null;
+};
+
+export type WorkspaceInstructionPolicyOnboardingProposalConflictResponse = {
+  code: "WORKSPACE_INSTRUCTION_POLICY_ONBOARDING_PROPOSAL_CONFLICT";
+  message: string;
+  existingProposalId: string;
+  existingDraftRevisionId: string;
+};

package/src/workspace-state.ts

@@ -49,15 +49,93 @@ export type WorkspaceStateGapCode =
   | "pending_memory_review"
   | "partial_inventory";
 
+export type WorkspaceStateGovernanceDriftStatus =
+  | "identical"
+  | "changed"
+  | "superseded"
+  | "missing"
+  | "unavailable"
+  | "truncated";
+
+export type WorkspaceStateGetOptions = { attemptId?: string };
+
+export type WorkspaceStateAttemptGovernance =
+  | { status: "not_requested" }
+  | {
+      status: "unavailable";
+      reason: "attempt_not_found_or_not_authorized";
+      driftStatus: "unavailable";
+    }
+  | {
+      status: "available";
+      attemptId: string;
+      executionGeneration: number;
+      acceptedAt: string;
+      policySnapshot:
+        | { status: "missing" }
+        | {
+            status: "available";
+            id: string;
+            createdAt: string;
+            entryHash: string;
+            policyRole: string | null;
+            roleSource:
+              | "session_binding"
+              | "metadata_fallback"
+              | "none"
+              | "invalid_metadata_fallback";
+            entries: Array<{
+              kind: WorkspaceInstructionPolicyKind;
+              scope: WorkspaceInstructionPolicyScope;
+              roleKey: string | null;
+              revisionId: string;
+              revision: number;
+              contentHash: string;
+              activationVersion: number;
+              activatedAt: string;
+              provenance: {
+                source: WorkspaceInstructionPolicyProvenanceSource;
+                sourceIdHash: string | null;
+              };
+            }>;
+          };
+      preferenceSnapshot:
+        | { status: "missing" }
+        | {
+            status: "available";
+            id: string;
+            createdAt: string;
+            descriptorHash: string;
+            descriptorCount: number;
+            truncated: boolean;
+          };
+      drift: {
+        overall: WorkspaceStateGovernanceDriftStatus;
+        policy: {
+          status: WorkspaceStateGovernanceDriftStatus;
+          snapshotHash: string | null;
+          currentHash: string | null;
+          snapshotTargetCount: number;
+          currentTargetCount: number;
+        };
+        preferences: {
+          status: WorkspaceStateGovernanceDriftStatus;
+          snapshotHash: string | null;
+          currentHash: string | null;
+          snapshotDescriptorCount: number;
+          currentDescriptorCount: number;
+          snapshotTruncated: boolean;
+          currentTruncated: boolean;
+        };
+      };
+    };
+
 export type WorkspaceStateResponse = {
   workspaceId: string;
   generatedAt: string;
   truth: {
     current: { source: "read_time_projection"; capturedAt: string };
-    policySnapshot: {
-      status: "not_captured";
-      reason: "workspace_instruction_policy_snapshot_not_implemented";
-    };
+    attemptGovernance: WorkspaceStateAttemptGovernance;
   };
   policy: {
     authority: "workspace_instruction_policy_heads";