@opengeni/contracts 0.50.0 → 1.0.0

package/dist/modal-native-proof-v2.js

@@ -0,0 +1,37 @@
+import {
+  MODAL_NATIVE_FRESH_COMPILER_FINGERPRINT,
+  MODAL_NATIVE_FRESH_NORMALIZATION_V1,
+  MODAL_NATIVE_PREPARATION_RECIPE_V2,
+  MODAL_NATIVE_PROOF_PROTOCOL_VERSION,
+  ModalNativeConfigurationCaptureRefV2,
+  ModalNativeFreshBlueprintV1,
+  ModalNativeFreshNormalizationV1,
+  ModalNativeNamespaceEvidenceV2,
+  ModalNativeNamespaceReadClaimV2,
+  ModalNativeOriginalCommandReadClaimV2,
+  ModalNativeOriginalScopeV2,
+  ModalNativePreparationDeclarationV2,
+  ModalNativePreparationRecipeV2,
+  ModalNativePreparedStartDescriptionV1,
+  ModalNativeProofGrantRefV2,
+  ModalNativeReservedLeaseRefV2
+} from "./chunk-2VORLN2R.js";
+export {
+  MODAL_NATIVE_FRESH_COMPILER_FINGERPRINT,
+  MODAL_NATIVE_FRESH_NORMALIZATION_V1,
+  MODAL_NATIVE_PREPARATION_RECIPE_V2,
+  MODAL_NATIVE_PROOF_PROTOCOL_VERSION,
+  ModalNativeConfigurationCaptureRefV2,
+  ModalNativeFreshBlueprintV1,
+  ModalNativeFreshNormalizationV1,
+  ModalNativeNamespaceEvidenceV2,
+  ModalNativeNamespaceReadClaimV2,
+  ModalNativeOriginalCommandReadClaimV2,
+  ModalNativeOriginalScopeV2,
+  ModalNativePreparationDeclarationV2,
+  ModalNativePreparationRecipeV2,
+  ModalNativePreparedStartDescriptionV1,
+  ModalNativeProofGrantRefV2,
+  ModalNativeReservedLeaseRefV2
+};
+//# sourceMappingURL=modal-native-proof-v2.js.map

package/dist/modal-native-proof-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/model-availability.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `details.code` on a 422 `validation_failed` envelope when the requested or
+ * stored model is not in the live model catalog (retired, removed, or never
+ * offered). Retrying the same request cannot succeed; the client must choose
+ * another model. Additive to the public error envelope: `code` stays
+ * `validation_failed` and the message keeps its historical text.
+ */
+export declare const MODEL_UNAVAILABLE_ERROR_CODE: "model_unavailable";
+/** Typed cause for a model that is not selectable in the live catalog. */
+export declare class ModelUnavailableError extends Error {
+    readonly modelId: string;
+    readonly code: "model_unavailable";
+    constructor(modelId: string);
+}
+export declare function isModelUnavailableError(error: unknown): error is ModelUnavailableError;

package/dist/model-connection-access.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+export declare const ModelConnectionAccessPolicy: z.ZodObject<{
+    allowedModels: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    allowedWorkspaces: z.ZodNullable<z.ZodArray<z.ZodString>>;
+    allowPersonalWorkspaces: z.ZodBoolean;
+    version: z.ZodNumber;
+}, z.core.$strict>;
+export declare const ModelConnectionAccessResponse: z.ZodObject<{
+    policy: z.ZodObject<{
+        allowedModels: z.ZodNullable<z.ZodArray<z.ZodString>>;
+        allowedWorkspaces: z.ZodNullable<z.ZodArray<z.ZodString>>;
+        allowPersonalWorkspaces: z.ZodBoolean;
+        version: z.ZodNumber;
+    }, z.core.$strict>;
+    models: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+    }, z.core.$strip>>;
+    workspaces: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+    }, z.core.$strip>>;
+    personalWorkspacesSupported: z.ZodBoolean;
+}, z.core.$strip>;

package/dist/model-context-inspector.d.ts

@@ -0,0 +1,329 @@
+import { z } from "zod";
+export declare const MODEL_CONTEXT_SNAPSHOT_VERSION: 1;
+export declare const MODEL_CONTEXT_INSTRUCTIONS_MAX_UTF8_BYTES: number;
+export declare const MODEL_CONTEXT_SNAPSHOT_MAX_UTF8_BYTES: number;
+export declare const MODEL_CONTEXT_LAYER_MAX_COUNT = 16;
+export declare const MODEL_CONTEXT_TOOL_MAX_COUNT = 2048;
+export declare const MODEL_CONTEXT_SKILL_MAX_COUNT = 1024;
+export declare const ModelContextInstructionLayerId: z.ZodEnum<{
+    builtin_skills: "builtin_skills";
+    code_search: "code_search";
+    codemode: "codemode";
+    genesis_title: "genesis_title";
+    git_bindings: "git_bindings";
+    identity: "identity";
+    operational_contract: "operational_contract";
+    persona_and_core: "persona_and_core";
+    sandbox_filesystem: "sandbox_filesystem";
+    sandbox_preamble: "sandbox_preamble";
+    sdk_capability_instructions: "sdk_capability_instructions";
+    sent_system_instructions: "sent_system_instructions";
+    session_instructions: "session_instructions";
+    skill_catalog: "skill_catalog";
+    workspace_governance: "workspace_governance";
+    workspace_memory: "workspace_memory";
+}>;
+export type ModelContextInstructionLayerId = z.infer<typeof ModelContextInstructionLayerId>;
+/** One prompt module inside a layer (modular operational contract only). */
+export declare const ModelContextInstructionModule: z.ZodObject<{
+    id: z.ZodEnum<{
+        admin: "admin";
+        artifacts: "artifacts";
+        attachments: "attachments";
+        base_behavior: "base_behavior";
+        connected_machine: "connected_machine";
+        goals: "goals";
+        knowledge: "knowledge";
+        media: "media";
+        renderer_markdown: "renderer_markdown";
+        repositories: "repositories";
+        rig: "rig";
+        runtime_mechanics: "runtime_mechanics";
+        sandbox: "sandbox";
+        skills: "skills";
+        subagents: "subagents";
+        workspace_environment: "workspace_environment";
+    }>;
+    chars: z.ZodNumber;
+}, z.core.$strict>;
+export type ModelContextInstructionModule = z.infer<typeof ModelContextInstructionModule>;
+export declare const ModelContextInstructionLayer: z.ZodObject<{
+    id: z.ZodEnum<{
+        builtin_skills: "builtin_skills";
+        code_search: "code_search";
+        codemode: "codemode";
+        genesis_title: "genesis_title";
+        git_bindings: "git_bindings";
+        identity: "identity";
+        operational_contract: "operational_contract";
+        persona_and_core: "persona_and_core";
+        sandbox_filesystem: "sandbox_filesystem";
+        sandbox_preamble: "sandbox_preamble";
+        sdk_capability_instructions: "sdk_capability_instructions";
+        sent_system_instructions: "sent_system_instructions";
+        session_instructions: "session_instructions";
+        skill_catalog: "skill_catalog";
+        workspace_governance: "workspace_governance";
+        workspace_memory: "workspace_memory";
+    }>;
+    title: z.ZodString;
+    content: z.ZodString;
+    utf8Bytes: z.ZodNumber;
+    estimatedTokens: z.ZodNumber;
+    modules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<{
+            admin: "admin";
+            artifacts: "artifacts";
+            attachments: "attachments";
+            base_behavior: "base_behavior";
+            connected_machine: "connected_machine";
+            goals: "goals";
+            knowledge: "knowledge";
+            media: "media";
+            renderer_markdown: "renderer_markdown";
+            repositories: "repositories";
+            rig: "rig";
+            runtime_mechanics: "runtime_mechanics";
+            sandbox: "sandbox";
+            skills: "skills";
+            subagents: "subagents";
+            workspace_environment: "workspace_environment";
+        }>;
+        chars: z.ZodNumber;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ModelContextInstructionLayer = z.infer<typeof ModelContextInstructionLayer>;
+export declare const ModelContextToolVisibility: z.ZodEnum<{
+    eager: "eager";
+    searchable: "searchable";
+}>;
+export type ModelContextToolVisibility = z.infer<typeof ModelContextToolVisibility>;
+export declare const ModelContextTool: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+    visibility: z.ZodEnum<{
+        eager: "eager";
+        searchable: "searchable";
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+    namespace: z.ZodOptional<z.ZodString>;
+    schema: z.ZodOptional<z.ZodUnknown>;
+    utf8Bytes: z.ZodNumber;
+    estimatedTokens: z.ZodNumber;
+}, z.core.$strict>;
+export type ModelContextTool = z.infer<typeof ModelContextTool>;
+export declare const ModelContextSkillKind: z.ZodEnum<{
+    native_tool_skill: "native_tool_skill";
+    preference_descriptor: "preference_descriptor";
+    runtime_skill: "runtime_skill";
+}>;
+export type ModelContextSkillKind = z.infer<typeof ModelContextSkillKind>;
+export declare const ModelContextSkill: z.ZodObject<{
+    kind: z.ZodEnum<{
+        native_tool_skill: "native_tool_skill";
+        preference_descriptor: "preference_descriptor";
+        runtime_skill: "runtime_skill";
+    }>;
+    name: z.ZodString;
+    description: z.ZodString;
+    source: z.ZodOptional<z.ZodString>;
+    path: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type ModelContextSkill = z.infer<typeof ModelContextSkill>;
+export declare const ModelContextTokenCounts: z.ZodObject<{
+    instructions: z.ZodNumber;
+    tools: z.ZodNumber;
+    prefix: z.ZodNumber;
+}, z.core.$strict>;
+export type ModelContextTokenCounts = z.infer<typeof ModelContextTokenCounts>;
+export declare const ModelContextSnapshot: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    capturedAt: z.ZodString;
+    source: z.ZodLiteral<"model_request">;
+    requestIndex: z.ZodNumber;
+    instructions: z.ZodString;
+    providerRequest: z.ZodOptional<z.ZodObject<{
+        provider: z.ZodString;
+        body: z.ZodNullable<z.ZodString>;
+        unavailableReason: z.ZodOptional<z.ZodString>;
+        parts: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            estimatedTokens: z.ZodNullable<z.ZodNumber>;
+            utf8Bytes: z.ZodNumber;
+            itemEstimatedTokens: z.ZodOptional<z.ZodArray<z.ZodNullable<z.ZodNumber>>>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    layers: z.ZodArray<z.ZodObject<{
+        id: z.ZodEnum<{
+            builtin_skills: "builtin_skills";
+            code_search: "code_search";
+            codemode: "codemode";
+            genesis_title: "genesis_title";
+            git_bindings: "git_bindings";
+            identity: "identity";
+            operational_contract: "operational_contract";
+            persona_and_core: "persona_and_core";
+            sandbox_filesystem: "sandbox_filesystem";
+            sandbox_preamble: "sandbox_preamble";
+            sdk_capability_instructions: "sdk_capability_instructions";
+            sent_system_instructions: "sent_system_instructions";
+            session_instructions: "session_instructions";
+            skill_catalog: "skill_catalog";
+            workspace_governance: "workspace_governance";
+            workspace_memory: "workspace_memory";
+        }>;
+        title: z.ZodString;
+        content: z.ZodString;
+        utf8Bytes: z.ZodNumber;
+        estimatedTokens: z.ZodNumber;
+        modules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodEnum<{
+                admin: "admin";
+                artifacts: "artifacts";
+                attachments: "attachments";
+                base_behavior: "base_behavior";
+                connected_machine: "connected_machine";
+                goals: "goals";
+                knowledge: "knowledge";
+                media: "media";
+                renderer_markdown: "renderer_markdown";
+                repositories: "repositories";
+                rig: "rig";
+                runtime_mechanics: "runtime_mechanics";
+                sandbox: "sandbox";
+                skills: "skills";
+                subagents: "subagents";
+                workspace_environment: "workspace_environment";
+            }>;
+            chars: z.ZodNumber;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        visibility: z.ZodEnum<{
+            eager: "eager";
+            searchable: "searchable";
+        }>;
+        description: z.ZodOptional<z.ZodString>;
+        namespace: z.ZodOptional<z.ZodString>;
+        schema: z.ZodOptional<z.ZodUnknown>;
+        utf8Bytes: z.ZodNumber;
+        estimatedTokens: z.ZodNumber;
+    }, z.core.$strict>>;
+    skills: z.ZodArray<z.ZodObject<{
+        kind: z.ZodEnum<{
+            native_tool_skill: "native_tool_skill";
+            preference_descriptor: "preference_descriptor";
+            runtime_skill: "runtime_skill";
+        }>;
+        name: z.ZodString;
+        description: z.ZodString;
+        source: z.ZodOptional<z.ZodString>;
+        path: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    tokens: z.ZodObject<{
+        instructions: z.ZodNumber;
+        tools: z.ZodNumber;
+        prefix: z.ZodNumber;
+    }, z.core.$strict>;
+}, z.core.$strict>;
+export type ModelContextSnapshot = z.infer<typeof ModelContextSnapshot>;
+export declare const SessionModelContextResponse: z.ZodObject<{
+    sessionId: z.ZodString;
+    attemptId: z.ZodNullable<z.ZodString>;
+    turnId: z.ZodNullable<z.ZodString>;
+    snapshot: z.ZodNullable<z.ZodObject<{
+        version: z.ZodLiteral<1>;
+        capturedAt: z.ZodString;
+        source: z.ZodLiteral<"model_request">;
+        requestIndex: z.ZodNumber;
+        instructions: z.ZodString;
+        providerRequest: z.ZodOptional<z.ZodObject<{
+            provider: z.ZodString;
+            body: z.ZodNullable<z.ZodString>;
+            unavailableReason: z.ZodOptional<z.ZodString>;
+            parts: z.ZodArray<z.ZodObject<{
+                key: z.ZodString;
+                estimatedTokens: z.ZodNullable<z.ZodNumber>;
+                utf8Bytes: z.ZodNumber;
+                itemEstimatedTokens: z.ZodOptional<z.ZodArray<z.ZodNullable<z.ZodNumber>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        layers: z.ZodArray<z.ZodObject<{
+            id: z.ZodEnum<{
+                builtin_skills: "builtin_skills";
+                code_search: "code_search";
+                codemode: "codemode";
+                genesis_title: "genesis_title";
+                git_bindings: "git_bindings";
+                identity: "identity";
+                operational_contract: "operational_contract";
+                persona_and_core: "persona_and_core";
+                sandbox_filesystem: "sandbox_filesystem";
+                sandbox_preamble: "sandbox_preamble";
+                sdk_capability_instructions: "sdk_capability_instructions";
+                sent_system_instructions: "sent_system_instructions";
+                session_instructions: "session_instructions";
+                skill_catalog: "skill_catalog";
+                workspace_governance: "workspace_governance";
+                workspace_memory: "workspace_memory";
+            }>;
+            title: z.ZodString;
+            content: z.ZodString;
+            utf8Bytes: z.ZodNumber;
+            estimatedTokens: z.ZodNumber;
+            modules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodEnum<{
+                    admin: "admin";
+                    artifacts: "artifacts";
+                    attachments: "attachments";
+                    base_behavior: "base_behavior";
+                    connected_machine: "connected_machine";
+                    goals: "goals";
+                    knowledge: "knowledge";
+                    media: "media";
+                    renderer_markdown: "renderer_markdown";
+                    repositories: "repositories";
+                    rig: "rig";
+                    runtime_mechanics: "runtime_mechanics";
+                    sandbox: "sandbox";
+                    skills: "skills";
+                    subagents: "subagents";
+                    workspace_environment: "workspace_environment";
+                }>;
+                chars: z.ZodNumber;
+            }, z.core.$strict>>>;
+        }, z.core.$strict>>;
+        tools: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+            visibility: z.ZodEnum<{
+                eager: "eager";
+                searchable: "searchable";
+            }>;
+            description: z.ZodOptional<z.ZodString>;
+            namespace: z.ZodOptional<z.ZodString>;
+            schema: z.ZodOptional<z.ZodUnknown>;
+            utf8Bytes: z.ZodNumber;
+            estimatedTokens: z.ZodNumber;
+        }, z.core.$strict>>;
+        skills: z.ZodArray<z.ZodObject<{
+            kind: z.ZodEnum<{
+                native_tool_skill: "native_tool_skill";
+                preference_descriptor: "preference_descriptor";
+                runtime_skill: "runtime_skill";
+            }>;
+            name: z.ZodString;
+            description: z.ZodString;
+            source: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        tokens: z.ZodObject<{
+            instructions: z.ZodNumber;
+            tools: z.ZodNumber;
+            prefix: z.ZodNumber;
+        }, z.core.$strict>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type SessionModelContextResponse = z.infer<typeof SessionModelContextResponse>;

package/dist/model-display.d.ts

@@ -0,0 +1,38 @@
+/**
+ * One display identity for a model everywhere outside the Models settings page.
+ *
+ * Catalog ids carry routing facts (`codex/`, `organization-claude-subscription/`,
+ * `workspace-openrouter/anthropic/...`) and custom models may have no curated
+ * label. People should only ever see the model itself: `GPT-6.1 Sol`,
+ * `Claude Opus 5.5`. The same upstream model therefore renders identically
+ * whether an organization or a workspace connection serves it.
+ *
+ * Pure and dependency-free so the API, SDK, React package and web app share it.
+ */
+export type ModelVendor = "openai" | "anthropic" | "xai" | "google" | "meta" | "mistral" | "deepseek" | "moonshot" | "qwen" | "zhipu" | "nvidia";
+export type ModelDisplayInput = string | {
+    id: string;
+    label?: string | null | undefined;
+    upstreamModelId?: string | null | undefined;
+    deployment?: {
+        upstreamModelId?: string | null | undefined;
+    } | null | undefined;
+};
+/** The upstream model slug without routing prefixes or `:variant` suffixes. */
+export declare function modelSlug(value: string): string;
+/** `claude-opus-5-5` → `Claude Opus 5.5`, `codex/gpt-6.1-sol` → `GPT-6.1 Sol`. */
+export declare function humanizeModelSlug(value: string): string;
+/**
+ * True when a catalog label is only the model's identifier: empty, or exactly
+ * its id, upstream id, or any trailing path of them (`claude-opus-4-8`,
+ * `anthropic/claude-sonnet-4.6`). Any other label is a curated name and wins.
+ */
+export declare function isRawModelLabel(label: string, ids?: readonly (string | null | undefined)[]): boolean;
+/**
+ * The clean name to show for a model: its curated catalog label when it has
+ * one, otherwise a readable form of the upstream model id. Never a routing
+ * prefix, connection id or connection scope.
+ */
+export declare function modelDisplayName(input: ModelDisplayInput): string;
+/** Who makes the model, for its logo. Null when it cannot be told. */
+export declare function modelVendor(input: ModelDisplayInput): ModelVendor | null;

package/dist/model-display.js

@@ -0,0 +1,134 @@
+// src/model-display.ts
+var WORDS = {
+  gpt: "GPT",
+  chatgpt: "ChatGPT",
+  claude: "Claude",
+  grok: "Grok",
+  gemini: "Gemini",
+  gemma: "Gemma",
+  llama: "Llama",
+  deepseek: "DeepSeek",
+  qwen: "Qwen",
+  glm: "GLM",
+  kimi: "Kimi",
+  mistral: "Mistral",
+  codestral: "Codestral",
+  devstral: "Devstral",
+  magistral: "Magistral",
+  nemotron: "Nemotron",
+  oss: "OSS"
+};
+function modelSlug(value) {
+  const last = value.split("/").filter(Boolean).at(-1) ?? value;
+  return last.replace(/:[^:]*$/, "") || last;
+}
+function upstreamOf(input) {
+  return input.upstreamModelId?.trim() || input.deployment?.upstreamModelId?.trim() || null;
+}
+function titleToken(token, index) {
+  const lower = token.toLowerCase();
+  const word = WORDS[lower];
+  if (word) return word;
+  if (index === 0 && /^o\d+$/.test(lower)) return lower;
+  if (/^\d+(?:\.\d+)?[bkmt]$/.test(lower) || /^[a-z]\d+[a-z\d]*$/.test(lower)) {
+    return lower.toUpperCase();
+  }
+  if (/^\d/.test(token)) return lower;
+  return lower.charAt(0).toUpperCase() + lower.slice(1);
+}
+function humanizeModelSlug(value) {
+  const slug = modelSlug(value.trim()).replace(/[-_](?:\d{8}|\d{4}-\d{2}-\d{2})$/, "").replace(/[-_]latest$/i, "");
+  const raw = slug.split(/[-_\s]+/).filter(Boolean);
+  if (raw.length === 0) return value.trim() || value;
+  const tokens = [];
+  for (const token of raw) {
+    const previous = tokens.at(-1);
+    if (previous !== void 0 && /^\d{1,2}$/.test(token) && /^\d{1,2}$/.test(previous)) {
+      tokens[tokens.length - 1] = `${previous}.${token}`;
+      continue;
+    }
+    tokens.push(token);
+  }
+  const words = tokens.map(titleToken);
+  if (words[0] === "GPT" && words.length > 1 && /^\d/.test(words[1])) {
+    return [`GPT-${words[1]}`, ...words.slice(2)].join(" ");
+  }
+  return words.join(" ");
+}
+function isRawModelLabel(label, ids = []) {
+  const text = label.trim();
+  if (!text) return true;
+  return ids.some((id) => {
+    if (!id) return false;
+    const segments = id.trim().split("/").filter(Boolean);
+    return segments.some((_, index) => {
+      const tail = segments.slice(index).join("/");
+      return tail === text || modelSlug(tail) === text;
+    });
+  });
+}
+function modelDisplayName(input) {
+  if (typeof input === "string") {
+    return input.trim() && !/\s/.test(input.trim()) ? humanizeModelSlug(input) : input;
+  }
+  const upstream = upstreamOf(input);
+  const label = input.label?.trim();
+  if (label && !isRawModelLabel(label, [input.id, upstream])) return label;
+  return humanizeModelSlug(upstream ?? label ?? input.id);
+}
+var VENDOR_PATTERNS = [
+  ["anthropic", /^claude\b/],
+  ["openai", /^(?:gpt|chatgpt|o\d+|codex|dall-e|sora|text-embedding|whisper)\b/],
+  ["xai", /^grok\b/],
+  ["google", /^(?:gemini|gemma)\b/],
+  ["meta", /^llama\b/],
+  ["mistral", /^(?:mistral|codestral|devstral|magistral|ministral|pixtral)\b/],
+  ["deepseek", /^deepseek\b/],
+  ["moonshot", /^(?:kimi|moonshot)\b/],
+  ["qwen", /^(?:qwen|qwq)\b/],
+  ["zhipu", /^glm\b/],
+  ["nvidia", /^nemotron\b/]
+];
+var VENDOR_SEGMENTS = {
+  anthropic: "anthropic",
+  openai: "openai",
+  "x-ai": "xai",
+  xai: "xai",
+  google: "google",
+  "meta-llama": "meta",
+  mistralai: "mistral",
+  deepseek: "deepseek",
+  moonshotai: "moonshot",
+  qwen: "qwen",
+  "z-ai": "zhipu",
+  nvidia: "nvidia"
+};
+function vendorFromSlug(slug) {
+  for (const [vendor, pattern] of VENDOR_PATTERNS) if (pattern.test(slug)) return vendor;
+  return null;
+}
+function modelVendor(input) {
+  const ids = typeof input === "string" ? [input] : [upstreamOf(input), input.id];
+  for (const id of ids) {
+    if (!id) continue;
+    const lower = id.trim().toLowerCase();
+    if (lower.startsWith("codex/")) return "openai";
+    if (lower.startsWith("supergrok/")) return "xai";
+    const vendor = vendorFromSlug(modelSlug(lower));
+    if (vendor) return vendor;
+    const segment = lower.split("/").filter(Boolean).at(-2);
+    if (segment && Object.hasOwn(VENDOR_SEGMENTS, segment)) return VENDOR_SEGMENTS[segment];
+  }
+  if (typeof input !== "string" && input.label) {
+    return vendorFromSlug(input.label.trim().toLowerCase().replace(/\s+/g, "-"));
+  }
+  return null;
+}
+export {
+  humanizeModelSlug,
+  isRawModelLabel,
+  modelDisplayName,
+  modelSlug,
+  modelVendor
+};
+//# sourceMappingURL=model-display.js.map

package/dist/model-display.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/model-display.ts"],"sourcesContent":["/**\n * One display identity for a model everywhere outside the Models settings page.\n *\n * Catalog ids carry routing facts (`codex/`, `organization-claude-subscription/`,\n * `workspace-openrouter/anthropic/...`) and custom models may have no curated\n * label. People should only ever see the model itself: `GPT-6.1 Sol`,\n * `Claude Opus 5.5`. The same upstream model therefore renders identically\n * whether an organization or a workspace connection serves it.\n *\n * Pure and dependency-free so the API, SDK, React package and web app share it.\n */\n\nexport type ModelVendor =\n  | \"openai\"\n  | \"anthropic\"\n  | \"xai\"\n  | \"google\"\n  | \"meta\"\n  | \"mistral\"\n  | \"deepseek\"\n  | \"moonshot\"\n  | \"qwen\"\n  | \"zhipu\"\n  | \"nvidia\";\n\nexport type ModelDisplayInput =\n  | string\n  | {\n      id: string;\n      label?: string | null | undefined;\n      upstreamModelId?: string | null | undefined;\n      deployment?: { upstreamModelId?: string | null | undefined } | null | undefined;\n    };\n\nconst WORDS: Readonly<Record<string, string>> = {\n  gpt: \"GPT\",\n  chatgpt: \"ChatGPT\",\n  claude: \"Claude\",\n  grok: \"Grok\",\n  gemini: \"Gemini\",\n  gemma: \"Gemma\",\n  llama: \"Llama\",\n  deepseek: \"DeepSeek\",\n  qwen: \"Qwen\",\n  glm: \"GLM\",\n  kimi: \"Kimi\",\n  mistral: \"Mistral\",\n  codestral: \"Codestral\",\n  devstral: \"Devstral\",\n  magistral: \"Magistral\",\n  nemotron: \"Nemotron\",\n  oss: \"OSS\",\n};\n\n/** The upstream model slug without routing prefixes or `:variant` suffixes. */\nexport function modelSlug(value: string): string {\n  const last = value.split(\"/\").filter(Boolean).at(-1) ?? value;\n  return last.replace(/:[^:]*$/, \"\") || last;\n}\n\nfunction upstreamOf(input: Exclude<ModelDisplayInput, string>): string | null {\n  return input.upstreamModelId?.trim() || input.deployment?.upstreamModelId?.trim() || null;\n}\n\nfunction titleToken(token: string, index: number): string {\n  const lower = token.toLowerCase();\n  const word = WORDS[lower];\n  if (word) return word;\n  // OpenAI reasoning series stay lowercase: o3, o4 Mini.\n  if (index === 0 && /^o\\d+$/.test(lower)) return lower;\n  // Sizes and lettered versions read as identifiers: 120B, V4, K3, A12B.\n  if (/^\\d+(?:\\.\\d+)?[bkmt]$/.test(lower) || /^[a-z]\\d+[a-z\\d]*$/.test(lower)) {\n    return lower.toUpperCase();\n  }\n  if (/^\\d/.test(token)) return lower;\n  return lower.charAt(0).toUpperCase() + lower.slice(1);\n}\n\n/** `claude-opus-5-5` → `Claude Opus 5.5`, `codex/gpt-6.1-sol` → `GPT-6.1 Sol`. */\nexport function humanizeModelSlug(value: string): string {\n  const slug = modelSlug(value.trim())\n    // Snapshot dates are release detail, not a different model name.\n    .replace(/[-_](?:\\d{8}|\\d{4}-\\d{2}-\\d{2})$/, \"\")\n    .replace(/[-_]latest$/i, \"\");\n  const raw = slug.split(/[-_\\s]+/).filter(Boolean);\n  if (raw.length === 0) return value.trim() || value;\n  // Consecutive short numbers are one version: 5-5 → 5.5, 3-5 → 3.5. Longer\n  // numbers are snapshots (gpt-4-1106-preview), never a minor version.\n  const tokens: string[] = [];\n  for (const token of raw) {\n    const previous = tokens.at(-1);\n    if (previous !== undefined && /^\\d{1,2}$/.test(token) && /^\\d{1,2}$/.test(previous)) {\n      tokens[tokens.length - 1] = `${previous}.${token}`;\n      continue;\n    }\n    tokens.push(token);\n  }\n  const words = tokens.map(titleToken);\n  // OpenAI's own spelling joins family and version: GPT-6.1, GPT-4o.\n  if (words[0] === \"GPT\" && words.length > 1 && /^\\d/.test(words[1]!)) {\n    return [`GPT-${words[1]}`, ...words.slice(2)].join(\" \");\n  }\n  return words.join(\" \");\n}\n\n/**\n * True when a catalog label is only the model's identifier: empty, or exactly\n * its id, upstream id, or any trailing path of them (`claude-opus-4-8`,\n * `anthropic/claude-sonnet-4.6`). Any other label is a curated name and wins.\n */\nexport function isRawModelLabel(\n  label: string,\n  ids: readonly (string | null | undefined)[] = [],\n): boolean {\n  const text = label.trim();\n  if (!text) return true;\n  return ids.some((id) => {\n    if (!id) return false;\n    const segments = id.trim().split(\"/\").filter(Boolean);\n    return segments.some((_, index) => {\n      const tail = segments.slice(index).join(\"/\");\n      return tail === text || modelSlug(tail) === text;\n    });\n  });\n}\n\n/**\n * The clean name to show for a model: its curated catalog label when it has\n * one, otherwise a readable form of the upstream model id. Never a routing\n * prefix, connection id or connection scope.\n */\nexport function modelDisplayName(input: ModelDisplayInput): string {\n  if (typeof input === \"string\") {\n    // A bare id is humanized; text with spaces is already a name (\"Workspace default\").\n    return input.trim() && !/\\s/.test(input.trim()) ? humanizeModelSlug(input) : input;\n  }\n  const upstream = upstreamOf(input);\n  const label = input.label?.trim();\n  if (label && !isRawModelLabel(label, [input.id, upstream])) return label;\n  return humanizeModelSlug(upstream ?? label ?? input.id);\n}\n\nconst VENDOR_PATTERNS: ReadonlyArray<readonly [ModelVendor, RegExp]> = [\n  [\"anthropic\", /^claude\\b/],\n  [\"openai\", /^(?:gpt|chatgpt|o\\d+|codex|dall-e|sora|text-embedding|whisper)\\b/],\n  [\"xai\", /^grok\\b/],\n  [\"google\", /^(?:gemini|gemma)\\b/],\n  [\"meta\", /^llama\\b/],\n  [\"mistral\", /^(?:mistral|codestral|devstral|magistral|ministral|pixtral)\\b/],\n  [\"deepseek\", /^deepseek\\b/],\n  [\"moonshot\", /^(?:kimi|moonshot)\\b/],\n  [\"qwen\", /^(?:qwen|qwq)\\b/],\n  [\"zhipu\", /^glm\\b/],\n  [\"nvidia\", /^nemotron\\b/],\n];\n\n/** OpenRouter / Gateway vendor path segments (`anthropic/claude-…`). */\nconst VENDOR_SEGMENTS: Readonly<Record<string, ModelVendor>> = {\n  anthropic: \"anthropic\",\n  openai: \"openai\",\n  \"x-ai\": \"xai\",\n  xai: \"xai\",\n  google: \"google\",\n  \"meta-llama\": \"meta\",\n  mistralai: \"mistral\",\n  deepseek: \"deepseek\",\n  moonshotai: \"moonshot\",\n  qwen: \"qwen\",\n  \"z-ai\": \"zhipu\",\n  nvidia: \"nvidia\",\n};\n\nfunction vendorFromSlug(slug: string): ModelVendor | null {\n  for (const [vendor, pattern] of VENDOR_PATTERNS) if (pattern.test(slug)) return vendor;\n  return null;\n}\n\n/** Who makes the model, for its logo. Null when it cannot be told. */\nexport function modelVendor(input: ModelDisplayInput): ModelVendor | null {\n  const ids = typeof input === \"string\" ? [input] : [upstreamOf(input), input.id];\n  for (const id of ids) {\n    if (!id) continue;\n    const lower = id.trim().toLowerCase();\n    if (lower.startsWith(\"codex/\")) return \"openai\";\n    if (lower.startsWith(\"supergrok/\")) return \"xai\";\n    const vendor = vendorFromSlug(modelSlug(lower));\n    if (vendor) return vendor;\n    const segment = lower.split(\"/\").filter(Boolean).at(-2);\n    if (segment && Object.hasOwn(VENDOR_SEGMENTS, segment)) return VENDOR_SEGMENTS[segment]!;\n  }\n  if (typeof input !== \"string\" && input.label) {\n    return vendorFromSlug(input.label.trim().toLowerCase().replace(/\\s+/g, \"-\"));\n  }\n  return null;\n}\n"],"mappings":"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","names":[]}

package/dist/model-picker-order.d.ts

@@ -0,0 +1,25 @@
+export type ModelPickerBillingClass = "opengeni_credits" | "external" | "codex_subscription" | "supergrok_subscription" | "claude_subscription" | "byok" | "organization_byok";
+export type ModelPickerBillingCandidate = {
+    provider?: string | undefined;
+    providerId?: string | undefined;
+    source?: string | undefined;
+    cost?: "free" | "credits" | "subscription" | "workspace" | "organization" | undefined;
+    billing?: {
+        upstreamPayer?: string | undefined;
+        metering?: string | undefined;
+    } | undefined;
+    credentialSource?: {
+        kind?: string | undefined;
+        provider?: string | undefined;
+    } | undefined;
+};
+export declare function modelPickerBillingClassFor(model: ModelPickerBillingCandidate): ModelPickerBillingClass;
+export declare function compareModelPickerOrder(left: {
+    billingClass: ModelPickerBillingClass;
+    selectable: boolean;
+    label: string;
+}, right: {
+    billingClass: ModelPickerBillingClass;
+    selectable: boolean;
+    label: string;
+}): number;