@opengeni/contracts 2.9.2 → 2.11.1-canary.0

package/dist/personal-github.js

@@ -1,25 +1,25 @@
 import {
   ConnectionMetadata
-} from "./chunk-AWNGBY5I.js";
-import "./chunk-WYBDERIY.js";
-import "./chunk-MRWYRAS5.js";
-import "./chunk-4IVHBXRI.js";
-import "./chunk-CM6BMECR.js";
-import "./chunk-JUFK3T4Q.js";
+} from "./chunk-6HOHS44G.js";
 import "./chunk-YBW5JSA3.js";
-import "./chunk-N6GRVXAJ.js";
+import "./chunk-NPBM4QSK.js";
+import "./chunk-CM6BMECR.js";
+import "./chunk-MRWYRAS5.js";
 import "./chunk-3SIZGL3O.js";
+import "./chunk-M5ZGRVIQ.js";
+import "./chunk-BCS7WHCK.js";
+import "./chunk-WYBDERIY.js";
+import "./chunk-7ABONTXE.js";
 import "./chunk-NVJMJWLL.js";
 import "./chunk-YRKRZ6OF.js";
-import "./chunk-7RMTKFJW.js";
+import "./chunk-7Q6HPDY2.js";
 import "./chunk-Y3KNXVTD.js";
+import "./chunk-TXTQIYCV.js";
 import "./chunk-RIY7GYQS.js";
 import "./chunk-D2HKF2EF.js";
 import "./chunk-MYBZRDTY.js";
-import "./chunk-TXTQIYCV.js";
 import "./chunk-PX3VCKAU.js";
-import "./chunk-BCS7WHCK.js";
-import "./chunk-M5ZGRVIQ.js";
+import "./chunk-JUFK3T4Q.js";
 
 // src/personal-github.ts
 import { z } from "zod";

package/dist/session-titles.d.ts

@@ -30,3 +30,38 @@ export declare function boundAutomaticSessionTitle(value: string): string;
  * title (normally {@link AUTOMATIC_SESSION_TITLE_FALLBACK}) in that case.
  */
 export declare function normalizeAutomaticSessionTitle(value: string): string | null;
+export type SessionDisplayTitleInput = {
+    id?: string | null | undefined;
+    title?: string | null | undefined;
+    titleSource?: "user" | "agent" | null | undefined;
+    initialMessage?: string | null | undefined;
+    metadata?: Readonly<Record<string, unknown>> | undefined;
+};
+export type SessionDisplayTitleOptions = {
+    /** Optional metadata fields to try before the opening-prompt preview. */
+    metadataKeys?: readonly string[] | undefined;
+};
+/**
+ * Derive a bounded, sensitive-safe preview from the opening prompt.
+ *
+ * Unsafe leading lines are skipped instead of forcing the whole session back
+ * to a generic label. This covers prompts that begin with a pasted URL or
+ * identifier followed by an ordinary natural-language request on the next
+ * line, without putting the rejected value into navigation surfaces.
+ */
+export declare function deriveAutomaticSessionTitlePreview(value: unknown): string | null;
+/**
+ * Whether the durable title still represents the automatic-title pending state.
+ * A user-authored title always wins, even when its literal value is the marker.
+ */
+export declare function sessionTitleIsPending(input: SessionDisplayTitleInput): boolean;
+/**
+ * Derive the title a human-facing client should display for a session.
+ *
+ * A semantic agent title or human rename wins. While automatic naming is still
+ * pending, clients show a short, sensitive-safe preview of the opening prompt.
+ * If no safe prompt text exists, a UUID-derived reference keeps real sessions
+ * distinguishable without exposing prompt bytes. The durable pending marker is
+ * therefore an internal lifecycle value rather than the ordinary visible name.
+ */
+export declare function deriveSessionDisplayTitle(input: SessionDisplayTitleInput, options?: SessionDisplayTitleOptions): string;

package/dist/session-titles.js

@@ -4,14 +4,20 @@ import {
   SESSION_TITLE_MAX_CHARACTERS,
   boundAutomaticSessionTitle,
   containsSensitiveAutomaticSessionTitleValue,
-  normalizeAutomaticSessionTitle
-} from "./chunk-4IVHBXRI.js";
+  deriveAutomaticSessionTitlePreview,
+  deriveSessionDisplayTitle,
+  normalizeAutomaticSessionTitle,
+  sessionTitleIsPending
+} from "./chunk-7ABONTXE.js";
 export {
   AUTOMATIC_SESSION_TITLE_FALLBACK,
   AUTOMATIC_SESSION_TITLE_MAX_GRAPHEMES,
   SESSION_TITLE_MAX_CHARACTERS,
   boundAutomaticSessionTitle,
   containsSensitiveAutomaticSessionTitleValue,
-  normalizeAutomaticSessionTitle
+  deriveAutomaticSessionTitlePreview,
+  deriveSessionDisplayTitle,
+  normalizeAutomaticSessionTitle,
+  sessionTitleIsPending
 };
 //# sourceMappingURL=session-titles.js.map

package/dist/workspace-learning-policy.d.ts

@@ -3,7 +3,7 @@ export declare const WORKSPACE_LEARNING_POLICY_MAX_SOURCE_OVERRIDES = 256;
 export declare const WORKSPACE_LEARNING_POLICY_SOURCE_KIND_MAX_CHARS = 96;
 export declare const WORKSPACE_LEARNING_POLICY_SOURCE_ID_MAX_CHARS = 1024;
 export declare const WORKSPACE_LEARNING_POLICY_REASON_MAX_CHARS = 4096;
-export declare const WORKSPACE_LEARNING_POLICY_DEFAULT_OFF_REVISION_ID = "workspace-learning-policy:default-off:v1";
+export declare const WORKSPACE_LEARNING_POLICY_DEFAULT_SUGGEST_REVISION_ID = "workspace-learning-policy:default-suggest:v1";
 export declare const WorkspaceLearningMode: z.ZodEnum<{
     automatic: "automatic";
     off: "off";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opengeni/contracts",
-  "version": "2.9.2",
+  "version": "2.11.1-canary.0",
   "description": "Shared zod schemas and wire-contract types for the OpenGeni API.",
   "license": "Apache-2.0",
   "repository": {
@@ -34,6 +34,14 @@
       "types": "./dist/personal-github.d.ts",
       "import": "./dist/personal-github.js"
     },
+    "./github-repository": {
+      "types": "./dist/github-repository.d.ts",
+      "import": "./dist/github-repository.js"
+    },
+    "./github-repository-contracts": {
+      "types": "./dist/github-repository-contracts.d.ts",
+      "import": "./dist/github-repository-contracts.js"
+    },
     "./atlassian": {
       "types": "./dist/atlassian.d.ts",
       "import": "./dist/atlassian.js"
@@ -78,6 +86,10 @@
       "types": "./dist/xai-provider-account-authority.d.ts",
       "import": "./dist/xai-provider-account-authority.js"
     },
+    "./model-picker-order": {
+      "types": "./dist/model-picker-order.d.ts",
+      "import": "./dist/model-picker-order.js"
+    },
     "./editable-artifacts": {
       "types": "./dist/editable-artifacts.d.ts",
       "import": "./dist/editable-artifacts.js"

package/src/github-repository-contracts.ts

@@ -0,0 +1,85 @@
+import { z } from "zod";
+
+export const VerifyPublicGitHubRepositoryRefRequest = z
+  .object({
+    url: z.string().min(1).max(2048),
+    ref: z
+      .string()
+      .trim()
+      .min(1)
+      .max(1024)
+      .refine((value) => !/[\u0000-\u001f\u007f]/u.test(value), "ref contains control characters"),
+  })
+  .strict();
+export type VerifyPublicGitHubRepositoryRefRequest = z.infer<
+  typeof VerifyPublicGitHubRepositoryRefRequest
+>;
+
+export const VerifyPublicGitHubRepositoryRefResponse = z
+  .object({
+    owner: z.string().min(1).max(39),
+    name: z.string().min(1).max(100),
+    fullName: z.string().min(3).max(140),
+    canonicalUrl: z.string().url(),
+    cloneUrl: z.string().url(),
+    defaultBranch: z.string().min(1).max(1024),
+    ref: z.string().min(1).max(1024),
+    commitSha: z.string().regex(/^[0-9a-f]{40}$/u),
+  })
+  .strict();
+export type VerifyPublicGitHubRepositoryRefResponse = z.infer<
+  typeof VerifyPublicGitHubRepositoryRefResponse
+>;
+
+export const GITHUB_REPOSITORY_BRANCH_PAGE_MAX = 100 as const;
+
+export const ListGitHubRepositoryBranchesQuery = z
+  .object({
+    cursor: z.coerce.number().int().positive().max(10_000).default(1),
+    limit: z.coerce
+      .number()
+      .int()
+      .min(1)
+      .max(GITHUB_REPOSITORY_BRANCH_PAGE_MAX)
+      .default(GITHUB_REPOSITORY_BRANCH_PAGE_MAX),
+  })
+  .strict();
+export type ListGitHubRepositoryBranchesQuery = z.infer<typeof ListGitHubRepositoryBranchesQuery>;
+
+export const GitHubRepositoryBranch = z
+  .object({
+    name: z.string().min(1).max(1024),
+    isDefault: z.boolean(),
+  })
+  .strict();
+export type GitHubRepositoryBranch = z.infer<typeof GitHubRepositoryBranch>;
+
+export const GitHubRepositoryBranchesResponse = z
+  .object({
+    branches: z.array(GitHubRepositoryBranch).max(GITHUB_REPOSITORY_BRANCH_PAGE_MAX),
+    nextCursor: z.number().int().positive().max(10_000).nullable(),
+  })
+  .strict()
+  .superRefine((response, context) => {
+    const names = new Set<string>();
+    let defaultCount = 0;
+    response.branches.forEach((branch, index) => {
+      if (names.has(branch.name)) {
+        context.addIssue({
+          code: "custom",
+          path: ["branches", index, "name"],
+          message: "branch names must be unique",
+        });
+      }
+      names.add(branch.name);
+      if (branch.isDefault) defaultCount += 1;
+    });
+    if (defaultCount > 1) {
+      context.addIssue({
+        code: "custom",
+        path: ["branches"],
+        message: "at most one branch may be marked as default",
+      });
+    }
+  });
+export type GitHubRepositoryBranchesResponse = z.infer<typeof GitHubRepositoryBranchesResponse>;

package/src/github-repository.ts

@@ -0,0 +1,59 @@
+export type CanonicalGitHubRepository = {
+  owner: string;
+  name: string;
+  fullName: string;
+  canonicalUrl: string;
+  cloneUrl: string;
+};
+
+/**
+ * Parse only a canonical public github.com repository URL. This deliberately
+ * rejects aliases, credentials, ports, query/fragment state, encoded paths,
+ * and repository subpaths so callers cannot accidentally verify one target
+ * and attach another.
+ */
+export function parseCanonicalGitHubRepositoryUrl(value: string): CanonicalGitHubRepository {
+  if (!value.startsWith("https://github.com/")) {
+    throw new Error("GitHub repository URL must use the exact https://github.com host.");
+  }
+  let url: URL;
+  try {
+    url = new URL(value);
+  } catch {
+    throw new TypeError("GitHub repository URL is invalid.");
+  }
+  if (
+    url.protocol !== "https:" ||
+    url.hostname !== "github.com" ||
+    url.host !== "github.com" ||
+    url.username ||
+    url.password ||
+    url.search ||
+    url.hash ||
+    url.pathname.includes("%")
+  ) {
+    throw new TypeError("Use a canonical https://github.com/owner/repository URL.");
+  }
+  const match = /^\/([^/]+)\/([^/]+?)\/?$/u.exec(url.pathname);
+  if (!match) {
+    throw new TypeError("GitHub repository URL must contain exactly owner/repository.");
+  }
+  const owner = match[1]!;
+  const name = match[2]!.replace(/\.git$/iu, "");
+  if (
+    !/^[A-Za-z0-9](?:[A-Za-z0-9-]{0,37}[A-Za-z0-9])?$/u.test(owner) ||
+    !/^[A-Za-z0-9_.-]{1,100}$/u.test(name) ||
+    name === "." ||
+    name === ".."
+  ) {
+    throw new TypeError("GitHub repository owner or name is invalid.");
+  }
+  const fullName = `${owner}/${name}`;
+  return {
+    owner,
+    name,
+    fullName,
+    canonicalUrl: `https://github.com/${fullName}`,
+    cloneUrl: `https://github.com/${fullName}.git`,
+  };
+}