@opengeni/sdk 0.28.2 → 0.29.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/sdk",
-  "version": "0.28.2",
+  "version": "0.29.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": {

package/src/index.ts

@@ -237,8 +237,10 @@ export type {
   FileResourceRef,
   FileStatus,
   FileUploadData,
+  FirstPartyMcpToolName,
   GetPackResponse,
   GitHubAppInfo,
+  GitHubAppSetupMode,
   GitHubBindingStatus,
   GitHubInstallationBinding,
   GitHubInstallationLifecycle,

package/src/types.ts

@@ -272,7 +272,7 @@ export type ToolRef = {
 };
 
 export type SessionToolPolicy = {
-  mode: "workspace_default" | "explicit" | "inherited" | "legacy";
+  mode: "workspace_default" | "explicit" | "inherited";
   inheritedFromSessionId: string | null;
 };
 
@@ -282,9 +282,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;
     };
 
@@ -496,8 +496,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 +517,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. */
@@ -2389,9 +2389,6 @@ 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;
   sourceTurnId: string | null;
@@ -2407,6 +2404,7 @@ export type NewSessionDraftOptions = {
   rigId?: string | undefined;
   goal?: GoalSpec | undefined;
   firstPartyMcpPermissions?: Permission[] | undefined;
+  firstPartyMcpTools?: FirstPartyMcpToolName[] | undefined;
 };
 
 export type NewSessionDraft = {
@@ -3478,6 +3476,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 +3488,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 +3498,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[];
@@ -3616,7 +3620,6 @@ export type UserMessageEventInput = {
     text: string;
     turnInstructions?: string | undefined;
     resources?: ResourceRef[] | undefined;
-    tools?: ToolRef[] | undefined;
     model?: string | undefined;
     reasoningEffort?: ReasoningEffort | undefined;
     mcpCredentialUpdates?: SessionMcpCredentialUpdateInput[] | undefined;