@opengeni/sdk 0.25.0 → 0.25.5

package/src/types.ts

@@ -276,6 +276,18 @@ export type SessionToolPolicy = {
   inheritedFromSessionId: string | null;
 };
 
+export type UpdateSessionToolPolicyRequest =
+  | {
+      mode: "workspace_default";
+      expectedVersion: number;
+    }
+  | {
+      /** Omitted for compatibility with the original explicit-only API. */
+      mode?: "explicit" | undefined;
+      tools: ToolRef[];
+      expectedVersion: number;
+    };
+
 export type SessionEffectiveToolPolicy = {
   mode: SessionToolPolicy["mode"];
   inheritedFromSessionId: string | null;
@@ -472,6 +484,7 @@ export type Session = {
   resources: ResourceRef[];
   tools: ToolRef[];
   toolPolicy?: SessionToolPolicy | undefined;
+  toolPolicyVersion?: number | undefined;
   effectiveToolPolicy?: SessionEffectiveToolPolicy | undefined;
   metadata: Record<string, unknown>;
   /** Frozen creator fact; later turns carry their own independent initiator. */
@@ -762,6 +775,7 @@ export const SESSION_EVENT_TYPES = [
   "terminal.pty.exited",
   "session.title_set",
   "session.mcp.approval_policy.updated",
+  "session.tool_policy.updated",
   // Multi-account Codex (P1): the session's inference account changed.
   "codex.account.switched",
   // credential allocator metadata-only per-turn credential selection audit.
@@ -1993,6 +2007,8 @@ export type ClientAuthConfig =
 // parity suite. The SDK has no runtime dependency on the Zod contracts package.
 export const OPENGENI_API_CONTRACT_REVISION = "2026-07-turn-instructions-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;
 
 /**
  * Public, unauthenticated-by-default client bootstrap config returned by
@@ -2324,6 +2340,8 @@ export type NewSessionDraft = {
   text: string;
   resources: ResourceRef[];
   tools: ToolRef[];
+  /** False inherits the workspace-default MCP policy; true preserves an explicit array. */
+  toolsProvided: boolean;
   model: string;
   reasoningEffort: ReasoningEffort;
   options: NewSessionDraftOptions;
@@ -2823,6 +2841,19 @@ export type KnowledgeSourceKind =
   | "other";
 export type DocumentSearchMode = "hybrid" | "vector" | "keyword";
 
+export type DocumentVisibility = "workspace" | "private";
+
+export type DocumentCurationStatus = "none" | "pending" | "suggested" | "auto_filed" | "failed";
+
+export type DocumentCuration = {
+  suggestedBaseId: string | null;
+  suggestedBaseName: string | null;
+  confidence: number;
+  reason: string | null;
+  originalTitle: string | null;
+  model: string | null;
+};
+
 export type DocumentBase = {
   id: string;
   workspaceId: string;
@@ -2851,6 +2882,13 @@ export type Document = {
   sourceUpdatedAt: string | null;
   sourceVersion: string | null;
   aclTags: string[];
+  visibility: DocumentVisibility;
+  createdBy: string | null;
+  agentAccess: boolean;
+  summary: string | null;
+  topics: string[];
+  curationStatus: DocumentCurationStatus;
+  curation: DocumentCuration | null;
   createdAt: string;
   updatedAt: string;
 };
@@ -2897,6 +2935,21 @@ export type AddDocumentRequest = {
   sourceUpdatedAt?: string | undefined;
   sourceVersion?: string | undefined;
   aclTags?: string[] | undefined;
+  visibility?: DocumentVisibility | undefined;
+  agentAccess?: boolean | undefined;
+};
+
+export type CreateKnowledgeDropRequest = {
+  text?: string | undefined;
+  fileId?: string | undefined;
+  filename?: string | undefined;
+  title?: string | undefined;
+  visibility?: DocumentVisibility | undefined;
+  agentAccess?: boolean | undefined;
+};
+
+export type MoveDocumentRequest = {
+  targetBaseId?: string | undefined;
 };
 
 export type DocumentSearchRequest = {
@@ -3333,10 +3386,16 @@ export type GitHubRepository = {
 
 export type GitHubRepositoryScope = "all" | "selected";
 
+export type GitHubBindingStatus = "disabled" | "unbound" | "bound";
+
+export type GitHubInstallationLifecycle = "active" | "suspended" | "deleted" | "unverified";
+
 export type GitHubInstallationBinding = {
   installationId: number;
+  githubAccountId: number | null;
   accountLogin: string | null;
   accountType: string | null;
+  lifecycle: GitHubInstallationLifecycle;
   repositoryScope: GitHubRepositoryScope;
   repositoryCount: number;
   createdAt: string;
@@ -3345,12 +3404,14 @@ export type GitHubInstallationBinding = {
 
 export type GitHubAppInfo = {
   configured: boolean;
+  /** Truthful workspace binding state; server App credentials alone are not a binding. */
+  status: GitHubBindingStatus;
   appId: string | null;
   clientId: string | null;
   appSlug: string | null;
-  /** Reserved compatibility field; null while new installation binding is disabled. */
+  /** Fresh GitHub-controlled installation/configuration consent entry point. */
   installUrl: string | null;
-  /** Reserved compatibility field; null while new installation binding is disabled. */
+  /** Compatibility alias for installUrl; no repository-admin chooser is exposed. */
   linkUrl: string | null;
   /** Installation bindings owned independently by this workspace. */
   installations: GitHubInstallationBinding[];