@jxsuite/protocol 6.0.0 → 6.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jxsuite/protocol",
-  "version": "6.0.0",
+  "version": "6.2.0",
   "description": "The Studio Backend Protocol — wire types and the canonical route table every Jx Studio backend implements",
   "license": "MIT",
   "repository": {

package/src/routes.ts

@@ -382,6 +382,14 @@ export const STUDIO_ROUTES = {
   gitFetch: route("POST", "/__studio/git/fetch", "Refresh remote tracking state"),
   gitCheckout: route("POST", "/__studio/git/checkout", "Switch branches"),
   gitCreateBranch: route("POST", "/__studio/git/create-branch", "Create a branch"),
+  gitCommitBranch: route(
+    "POST",
+    "/__studio/git/commit-branch",
+    "Commit the change set as a NEW branch off the session's base, then take it out of this one " +
+      "→ GitCommitBranchResult; 409 branch_exists",
+    "A publish the remote conflicts with reports the conflict alone, and Send for review stays " +
+      "refused on a branch whose every commit is live.",
+  ),
   gitDiff: route("GET", "/__studio/git/diff", "Unified diff of dirty files (or one path)"),
   gitShow: route("GET", "/__studio/git/show", "File content at a ref"),
   gitDiscard: route("POST", "/__studio/git/discard", "Discard working changes"),

package/src/types.ts

@@ -238,6 +238,18 @@ export interface GitLogEntry {
   date: string;
 }
 
+/**
+ * Response of `git/commit-branch` (see StudioPlatform.gitCommitBranch): the branch the change set
+ * now lives on, its commit, and which files left this session (`moved`) or stayed because they were
+ * edited while it was made (`kept`).
+ */
+export interface GitCommitBranchResult {
+  branch: string;
+  sha: string;
+  moved: string[];
+  kept: string[];
+}
+
 /** Response of the pull-request route (see StudioPlatform.createPullRequest). */
 export interface PullRequestInfo {
   url: string;
@@ -817,6 +829,12 @@ export interface AiModelInfo {
 }
 
 /** Response of the AI proxy's models route (the chat route's sibling). */
+/**
+ * The wire a provider speaks: the OpenAI-compatible chat-completions API, or the Anthropic Messages
+ * API (ai.md §2.6). The chat route's own body and frames are the same for both.
+ */
+export type AiProviderFamily = "openai-compat" | "anthropic";
+
 export interface AiModelsResponse {
   models: AiModelInfo[];
   /** True when the backend holds working credentials (env key, managed platform). */
@@ -825,6 +843,13 @@ export interface AiModelsResponse {
   managed?: boolean;
   /** The backend's preferred model id, when it declares one. */
   defaultModel?: string;
+  /**
+   * The provider families the chat route can reach with a caller's own key, chosen per request with
+   * the `X-Api-Provider` header (ai.md §2.6). Absent means `["openai-compat"]`: a backend that
+   * predates the header forwards every key to an OpenAI-compatible endpoint, so a client **MUST
+   * NOT** send it a key for any other family.
+   */
+  providers?: AiProviderFamily[];
   /** Set when the upstream provider was unreachable and defaults were returned. */
   upstreamError?: number | string;
   /**