@opengeni/sdk 0.28.2 → 0.32.1

package/src/types.ts

@@ -229,6 +229,7 @@ export type ViewerHeartbeatRequest = { leaseEpoch: number };
 export type ViewerHeartbeatResponse = { alive: boolean };
 
 export type ReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh";
+export type LatencyMode = "standard" | "priority" | "fast";
 export type GitCredentialProvider = "github" | "gitlab" | "azure_devops";
 export type GitCredentialBindingId = string;
 export type GitRepositoryAccess = "read" | "write";
@@ -272,7 +273,7 @@ export type ToolRef = {
 };
 
 export type SessionToolPolicy = {
-  mode: "workspace_default" | "explicit" | "inherited" | "legacy";
+  mode: "workspace_default" | "explicit" | "inherited";
   inheritedFromSessionId: string | null;
 };
 
@@ -282,9 +283,9 @@ export type UpdateSessionToolPolicyRequest =
       expectedVersion: number;
     }
   | {
-      /** Omitted for compatibility with the original explicit-only API. */
-      mode?: "explicit" | undefined;
+      mode: "explicit";
       tools: ToolRef[];
+      firstPartyMcpTools: FirstPartyMcpToolName[];
       expectedVersion: number;
     };
 
@@ -418,6 +419,71 @@ export type OpenGeniSlackBotInstallStart = {
   expiresAt: string;
 };
 
+export type GoogleDriveTargetScope = "user" | "workspace" | "organization";
+export type GoogleDriveSyncCadence = "manual" | "hourly" | "daily";
+export type GoogleDriveReadPolicy = "allow" | "ask" | "block";
+
+export type GoogleDriveSelectedSource = {
+  id: string;
+  name: string;
+  mimeType: string;
+  driveId: string | null;
+  targetScope: GoogleDriveTargetScope;
+  syncCadence: GoogleDriveSyncCadence;
+  readPolicy: GoogleDriveReadPolicy;
+  selectedAt: string;
+};
+
+export type GoogleDriveConnectionMetadata = {
+  credentialRole: "google_drive_metadata";
+  credentialLabel: "Google Drive metadata browser";
+  googlePermissionId: string;
+  googleEmail: string;
+  googleDisplayName: string | null;
+  verifiedAt: string;
+  accessMode: "metadata_readonly" | "readonly";
+  selectedSources?: GoogleDriveSelectedSource[] | undefined;
+  /** @deprecated Read selectedSources; retained while existing connections migrate. */
+  selectedSource?: GoogleDriveSelectedSource | null | undefined;
+  [key: string]: unknown;
+};
+
+export type GoogleDriveOAuthStartRequest = {
+  connectionId?: string | undefined;
+};
+
+export type GoogleDriveOAuthStartResponse = {
+  authorizationUrl: string;
+  expiresAt: string;
+};
+
+export type GoogleDriveBrowseItem = {
+  id: string;
+  name: string;
+  mimeType: string;
+  kind: "folder" | "file";
+  driveId: string | null;
+  modifiedTime: string | null;
+  size: string | null;
+  webViewLink: string | null;
+};
+
+export type GoogleDriveBrowseResponse = {
+  connection: ConnectionMetadata;
+  parentId: string;
+  current: GoogleDriveBrowseItem | null;
+  items: GoogleDriveBrowseItem[];
+  nextPageToken: string | null;
+  incompleteSearch: boolean;
+};
+
+export type SaveGoogleDriveSourceRequest = {
+  sources: Array<Pick<GoogleDriveBrowseItem, "id" | "name" | "mimeType" | "driveId">>;
+  targetScope: GoogleDriveTargetScope;
+  syncCadence: GoogleDriveSyncCadence;
+  readPolicy: GoogleDriveReadPolicy;
+};
+
 export type UpdateConnectionRequest = {
   providerDomain?: string | undefined;
   subjectId?: string | null | undefined;
@@ -496,8 +562,8 @@ export type Session = {
   resources: ResourceRef[];
   skills: SessionSkill[];
   tools: ToolRef[];
-  toolPolicy?: SessionToolPolicy | undefined;
-  toolPolicyVersion?: number | undefined;
+  toolPolicy: SessionToolPolicy;
+  toolPolicyVersion: number;
   effectiveToolPolicy?: SessionEffectiveToolPolicy | undefined;
   metadata: Record<string, unknown>;
   /** Frozen creator fact; later turns carry their own independent initiator. */
@@ -517,7 +583,7 @@ export type Session = {
   rigId: string | null;
   rigVersionId: string | null;
   firstPartyMcpPermissions: string[] | null;
-  firstPartyMcpTools: FirstPartyMcpToolName[] | null;
+  firstPartyMcpTools: FirstPartyMcpToolName[];
   mcpServers: SessionMcpServerMetadata[];
   parentSessionId: string | null;
   /** Immutable server-authored nested-agent lineage and policy snapshot. */
@@ -539,6 +605,11 @@ export type Session = {
   codexPinnedCredentialId?: string | null;
   /** Multi-account Codex (P1): the account the most recent turn ran on (the "Running on:" indicator). */
   codexLastCredentialId?: string | null;
+  /**
+   * Frozen at create. `remote_v2` ⇒ Codex remote compaction + Codex-only model
+   * admission; `portable` ⇒ plaintext compaction and free provider switching.
+   */
+  codexCompactionMode: "remote_v2" | "portable";
   /** Personal (authenticated subject) workspace pin state, never workspace-global. */
   pinned?: boolean;
   /** Stable pin ordering key; null when this subject has not pinned the session. */
@@ -630,6 +701,7 @@ export type SessionTurn = {
   toolsProvided?: boolean | undefined;
   model: string;
   reasoningEffort: ReasoningEffort;
+  latencyMode: LatencyMode;
   sandboxBackend: SandboxBackend;
   sandboxOs: SandboxOs | null;
   metadata: Record<string, unknown>;
@@ -716,6 +788,7 @@ export const SESSION_EVENT_TYPES = [
   "session.requiresAction",
   "session.humanInput.requested",
   "session.context.compaction.requested",
+  "session.context.compaction.started",
   "session.context.compacted",
   "session.context.compaction.skipped",
   "session.context.cleared",
@@ -1574,6 +1647,7 @@ export type CreateSessionRequest = {
   metadata?: Record<string, unknown> | undefined;
   model?: string | undefined;
   reasoningEffort?: ReasoningEffort | undefined;
+  latencyMode?: LatencyMode | undefined;
   sandboxBackend?: SandboxBackend | undefined;
   // The enrolled machine (a sandbox id) to run this session on; seeds the
   // active-sandbox pointer at creation so the first turn lands on it.
@@ -1673,6 +1747,8 @@ export type FirstPartyMcpToolName =
   | "memory_search"
   | "memory_save"
   | "memory_correct"
+  | "preference_registry_summary"
+  | "preference_registry_get"
   | "sandboxes_list"
   | "sandbox_attach"
   | "sandbox_swap"
@@ -1713,8 +1789,13 @@ export type FirstPartyMcpToolName =
   | "scheduled_task_runs_list"
   | "slack_bot_list_channels"
   | "slack_bot_channel_history"
+  | "slack_bot_thread_replies"
   | "slack_bot_list_users"
-  | "slack_bot_post_message";
+  | "slack_bot_list_files"
+  | "slack_bot_file_info"
+  | "slack_bot_file_content"
+  | "slack_bot_post_message"
+  | "slack_bot_delete_message";
 
 export type ProductAccessMode = "local" | "configured" | "managed";
 
@@ -2102,6 +2183,8 @@ export type ClientConfig = {
   allowedReasoningEfforts: ReasoningEffort[];
   mcpServers: { id: string; name: string }[];
   fileUploads: { enabled: boolean; maxSizeBytes: number };
+  /** Native browser microphone capture + server-side transcription capability. */
+  voiceInput?: ClientVoiceInputConfig | undefined;
   productAccessMode: ProductAccessMode;
   auth: ClientAuthConfig;
   // Server-wide hint: does this deployment support Channel-A structured services
@@ -2115,8 +2198,29 @@ export type ClientConfig = {
   };
 };
 
+/** Client-safe voice-input capability projection. */
+export type ClientVoiceInputConfig = {
+  available: boolean;
+  maxDurationSeconds: number;
+  maxSizeBytes: number;
+  acceptedMimeTypes: string[];
+};
+
+/** Response from POST /v1/workspaces/:workspaceId/transcriptions. */
+export type TranscribeAudioResponse = {
+  text: string;
+  languages: string[];
+};
+
 export type AccountRole = "owner" | "admin" | "member";
 
+export type AccessPrincipalKind =
+  | "human_session"
+  | "agent_attempt"
+  | "service"
+  | "api_key"
+  | "configured_key";
+
 export type AccountGrant = {
   accountId: string;
   subjectId: string;
@@ -2132,6 +2236,7 @@ export type AccessGrant = {
   subjectId: string;
   subjectLabel?: string | undefined;
   permissions: Permission[];
+  principalKind?: AccessPrincipalKind | undefined;
   metadata?: Record<string, unknown> | undefined;
   serviceInitiator?: ServiceTurnInitiator | undefined;
   serviceInitiatorContext?: ServiceTurnInitiatorContext | undefined;
@@ -2170,15 +2275,24 @@ export type Workspace = {
 
 export type WorkspaceSettings = {
   memoryEnabled?: boolean | undefined;
+  voiceInput?: WorkspaceVoiceInputSettings | undefined;
   transcription?: WorkspaceTranscriptionPolicy | undefined;
   maxNestedAgentDepth?: number | null | undefined;
+  /** Default for new Codex sessions; absent ⇒ remote_v2. */
+  codexCompactionDefault?: "remote_v2" | "portable" | undefined;
   [key: string]: unknown;
 };
 
+export type WorkspaceVoiceInputSettings = {
+  enabled: boolean;
+};
+
 export type UpdateWorkspaceSettingsRequest = {
   memoryEnabled?: boolean | undefined;
+  voiceInput?: WorkspaceVoiceInputSettings | undefined;
   transcription?: WorkspaceTranscriptionPolicy | undefined;
   maxNestedAgentDepth?: number | null | undefined;
+  codexCompactionDefault?: "remote_v2" | "portable" | undefined;
   [key: string]: unknown;
 };
 
@@ -2389,11 +2503,9 @@ export type ComposerDraft = {
   revision: number;
   text: string;
   resources: ResourceRef[];
-  tools: ToolRef[];
-  /** False inherits the session policy; true preserves an explicit array. */
-  toolsProvided: boolean;
   model: string;
   reasoningEffort: ReasoningEffort;
+  latencyMode?: LatencyMode | undefined;
   sourceTurnId: string | null;
   sourceTurnVersion: number | null;
   updatedAt: string | null;
@@ -2407,6 +2519,7 @@ export type NewSessionDraftOptions = {
   rigId?: string | undefined;
   goal?: GoalSpec | undefined;
   firstPartyMcpPermissions?: Permission[] | undefined;
+  firstPartyMcpTools?: FirstPartyMcpToolName[] | undefined;
 };
 
 export type NewSessionDraft = {
@@ -2418,6 +2531,7 @@ export type NewSessionDraft = {
   toolsProvided: boolean;
   model: string;
   reasoningEffort: ReasoningEffort;
+  latencyMode?: LatencyMode | undefined;
   options: NewSessionDraftOptions;
   updatedAt: string | null;
 };
@@ -3478,6 +3592,8 @@ export type GitHubRepositoryScope = "all" | "selected";
 
 export type GitHubBindingStatus = "disabled" | "unbound" | "bound";
 
+export type GitHubAppSetupMode = "platform" | "operator";
+
 export type GitHubInstallationLifecycle = "active" | "suspended" | "deleted" | "unverified";
 
 export type GitHubInstallationBinding = {
@@ -3488,6 +3604,8 @@ export type GitHubInstallationBinding = {
   lifecycle: GitHubInstallationLifecycle;
   repositoryScope: GitHubRepositoryScope;
   repositoryCount: number;
+  /** OpenGeni-owned entry point for changing the installation's repository allowlist. */
+  configureUrl: string | null;
   createdAt: string;
   updatedAt: string;
 };
@@ -3496,12 +3614,14 @@ export type GitHubAppInfo = {
   configured: boolean;
   /** Truthful workspace binding state; server App credentials alone are not a binding. */
   status: GitHubBindingStatus;
+  /** Platform deployments expose installation only; operator deployments may create an App. */
+  setupMode: GitHubAppSetupMode;
   appId: string | null;
   clientId: string | null;
   appSlug: string | null;
-  /** Fresh GitHub-controlled installation/configuration consent entry point. */
+  /** Fresh OAuth-first existing-installation discovery and install entry point. */
   installUrl: string | null;
-  /** Compatibility alias for installUrl; no repository-admin chooser is exposed. */
+  /** Compatibility alias for installUrl. */
   linkUrl: string | null;
   /** Installation bindings owned independently by this workspace. */
   installations: GitHubInstallationBinding[];
@@ -3590,6 +3710,142 @@ export type BillingUsageResponse = {
   usage: UsageEvent[];
 };
 
+export type InsightsRange = "today" | "week" | "month" | "ytd";
+
+export type InsightsBillingPath = "opengeni_credits" | "external";
+
+export type InsightsModelUsageRow = {
+  id: string;
+  model: string;
+  provider: string;
+  billing: InsightsBillingPath;
+  calls: number;
+  inputTokens: number;
+  outputTokens: number;
+  cachedTokens: number;
+  cacheWriteTokens: number;
+  reasoningTokens: number;
+  creditUsd: number;
+};
+
+export type InsightsSeriesPoint = {
+  label: string;
+  modelCostUsd: number;
+  warmSeconds: number;
+  inputTokens: number;
+  cachedTokens: number;
+  cacheHitPct: number;
+  calls: number;
+};
+
+export type InsightsDepthBucket = {
+  depth: number;
+  sessions: number;
+};
+
+export type InsightsModelFacet = {
+  provider: string;
+  model: string;
+};
+
+export type InsightsSpendDriver = {
+  id: string;
+  groupBy: "root_session" | "schedule";
+  label: string;
+  creditUsd: number;
+  tokens: number;
+  cacheHitPct: number;
+  pctOfCreditUsd: number;
+  deltaUsdVsPrior: number;
+};
+
+export type InsightsWarmGroupRow = {
+  id: string;
+  groupId: string;
+  label: string;
+  backend: string | null;
+  warmSeconds: number;
+  sessionsAttached: number;
+};
+
+export type InsightsLiveWarmLease = {
+  id: string;
+  groupId: string;
+  backend: string;
+  turnHolders: number;
+  viewerHolders: number;
+  warmForLabel: string;
+  warmSeconds: number;
+};
+
+export type InsightsFloorSession = {
+  id: string;
+  title: string;
+  state: "running" | "paused" | "failed" | "idle" | "compacting" | "waiting";
+  depth: number;
+  model: string | null;
+  provider: string | null;
+  ageLabel: string;
+  cacheHitPct: number | null;
+  route: string | null;
+};
+
+export type InsightsScheduleRow = {
+  id: string;
+  name: string;
+  fires: number;
+  creditUsd: number | null;
+  tokens: number | null;
+  cacheHitPct: number | null;
+  billing: InsightsBillingPath | null;
+};
+
+export type WorkspaceInsightsSnapshot = {
+  range: InsightsRange;
+  rangeLabel: string;
+  priorLabel: string;
+  seriesLabel: string;
+  cacheSeriesLabel: string;
+  timezone: "UTC";
+  models: InsightsModelUsageRow[];
+  facets: InsightsModelFacet[];
+  series: InsightsSeriesPoint[];
+  depth: InsightsDepthBucket[];
+  drivers: InsightsSpendDriver[];
+  schedules: InsightsScheduleRow[];
+  warmSeconds: number;
+  priorWarmSeconds: number;
+  warmGroups: InsightsWarmGroupRow[];
+  liveWarm: InsightsLiveWarmLease[];
+  floor: InsightsFloorSession[];
+  selfhostedEnabled: boolean;
+  machinesOnline: number;
+  workspaceCreditUsd: number;
+  priorWorkspaceCreditUsd: number;
+  creditUsd: number;
+  priorCreditUsd: number;
+  priorInputTokens: number;
+  priorCacheHitPct: number;
+  priorCalls: number;
+  goalsActive: number;
+  goalsCompleted: number;
+  sessionsTouched: number;
+  rootSessions: number;
+  deepestDepth: number;
+  deepestSessionTitle: string;
+  avgDepth: number;
+  warmIdleNow: number;
+  billableTokensUsed: number;
+  billableTokenCap: number | null;
+  agentRunsUsed: number;
+  agentRunCap: number | null;
+  modelFilterActive: boolean;
+};
+
+export type WorkspaceInsightsResponse = {
+  snapshot: WorkspaceInsightsSnapshot;
+};
+
 export type BillingEntitlementsResponse = {
   accountId: string;
   mode: EntitlementsMode;
@@ -3616,9 +3872,9 @@ export type UserMessageEventInput = {
     text: string;
     turnInstructions?: string | undefined;
     resources?: ResourceRef[] | undefined;
-    tools?: ToolRef[] | undefined;
     model?: string | undefined;
     reasoningEffort?: ReasoningEffort | undefined;
+    latencyMode?: LatencyMode | undefined;
     mcpCredentialUpdates?: SessionMcpCredentialUpdateInput[] | undefined;
   };
 };

package/src/workspace-state.ts

@@ -0,0 +1,134 @@
+import type {
+  WorkspaceInstructionPolicyKind,
+  WorkspaceInstructionPolicyProvenanceSource,
+  WorkspaceInstructionPolicyScope,
+} from "./workspace-instruction-policies";
+
+export type WorkspaceStateDocumentStatusCounts = {
+  queued: number;
+  indexing: number;
+  ready: number;
+  failed: number;
+};
+
+export type WorkspaceStateSourceKindCounts = {
+  manual_upload: number;
+  meeting_transcript: number;
+  repository: number;
+  email: number;
+  chat: number;
+  document: number;
+  web: number;
+  other: number;
+};
+
+export type WorkspaceStateMemoryStatusCounts = {
+  proposed: number;
+  approved: number;
+  rejected: number;
+  active: number;
+  superseded: number;
+  archived: number;
+};
+
+export type WorkspaceStateMemoryKindCounts = {
+  semantic: number;
+  episodic: number;
+  procedural: number;
+  decision: number;
+  preference: number;
+};
+
+export type WorkspaceStateGapCode =
+  | "no_document_bases"
+  | "no_visible_documents"
+  | "failed_documents"
+  | "processing_documents"
+  | "missing_topic_coverage"
+  | "no_memory_records"
+  | "pending_memory_review"
+  | "partial_inventory";
+
+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";
+    };
+  };
+  policy: {
+    authority: "workspace_instruction_policy_heads";
+    activeHeads: Array<{
+      kind: WorkspaceInstructionPolicyKind;
+      scope: WorkspaceInstructionPolicyScope;
+      roleKey: string | null;
+      revisionId: string;
+      revision: number;
+      contentHash: string;
+      activationVersion: number;
+      activatedAt: string;
+    }>;
+    activeHeadsTruncated: boolean;
+    latestRevision: {
+      kind: WorkspaceInstructionPolicyKind;
+      scope: WorkspaceInstructionPolicyScope;
+      roleKey: string | null;
+      revisionId: string;
+      revision: number;
+      contentHash: string;
+      provenanceSource: WorkspaceInstructionPolicyProvenanceSource;
+      state: "active" | "inactive";
+      createdAt: string;
+    } | null;
+    legacyRuntime: {
+      source: "workspace_override" | "deployment_default";
+      workspaceOverrideConfigured: boolean;
+    };
+    runtimeComposition: { status: "not_implemented" };
+  };
+  knowledge:
+    | {
+        availability: "unavailable";
+        reason: "missing_permission";
+        requiredPermission: "documents:search";
+      }
+    | {
+        availability: "available";
+        coverage: "complete" | "partial";
+        baseCount: number;
+        bases: Array<{
+          id: string;
+          name: string;
+          visibleDocumentCount: number;
+          statusCounts: WorkspaceStateDocumentStatusCounts;
+          latestUpdatedAt: string | null;
+        }>;
+        basesTruncated: boolean;
+        inspectedVisibleDocumentCount: number;
+        documentStatusCounts: WorkspaceStateDocumentStatusCounts;
+        sourceKindCounts: WorkspaceStateSourceKindCounts;
+        topics: Array<{ name: string; documentCount: number }>;
+        topicsTruncated: boolean;
+        latestDocumentUpdatedAt: string | null;
+        memorySample: {
+          recordCount: number;
+          sampleLimit: 100;
+          limitReached: boolean;
+          statusCounts: WorkspaceStateMemoryStatusCounts;
+          kindCounts: WorkspaceStateMemoryKindCounts;
+          preferenceAuthority: {
+            kindCountSource: "knowledge_memories_legacy_observations";
+            activeAuthority: "structured_preference_registry";
+          };
+          latestUpdatedAt: string | null;
+        };
+        gaps: Array<{
+          code: WorkspaceStateGapCode;
+          severity: "info" | "warning";
+          relatedCount: number | null;
+        }>;
+      };
+};