@agent-native/core 0.205.0 → 0.206.0-nightly-20261009011246

package/dist/agent/model-version.d.ts

@@ -1,3 +1,22 @@
+export interface NormalizeModelOptions {
+    preserveCustomModels?: boolean;
+    acceptsCustomModels?: boolean;
+}
+export interface ModelEngineConfig {
+    name: string;
+    label?: string;
+    defaultModel: string;
+    supportedModels: readonly string[];
+    /** Models currently offered in the picker, which may be a user-selected subset. */
+    selectableModels?: readonly string[];
+    acceptsCustomModels?: boolean;
+    preserveCustomModels?: boolean;
+}
 export declare function findLatestSupportedVersionMatch(candidate: string, supportedModels: readonly string[]): string | undefined;
+export declare function upgradeBuilderModelAlias(candidate: string, supportedModels: readonly string[]): string | undefined;
 export declare function isNewerVersionedModel(candidate: string, newerModel: string): boolean;
 export declare function upgradeModelToLatestSupportedVersion(candidate: string, supportedModels: readonly string[]): string | undefined;
+export declare function upgradeModelForProvider(candidate: string, supportedModels: readonly string[], provider: string): string | undefined;
+export declare function normalizeModelForEngine(engine: ModelEngineConfig, model: string | null | undefined, options?: NormalizeModelOptions): string;
+export declare function getModelOptionLabel(model: string, engine?: ModelEngineConfig, builderFallbackLabel?: string): string;
+export declare function getBuilderModelOptionLabel(model: string, builderFallbackLabel?: string): string;

package/dist/agent/model-version.js

@@ -1,4 +1,33 @@
+import { BUILDER_CLAUDE_SONNET_MODEL_ID, BUILDER_MODEL_ALIASES, BUILDER_MODEL_CONFIG, CLAUDE_SONNET_MODEL_ID, getClaudeModelOptionLabel, } from "./model-config.js";
 const UPGRADEABLE_GPT_TIERS = new Set(["-sol", "-terra", "-luna"]);
+const OPENROUTER_MODEL_ALIASES = {
+    "x-ai/grok-code-fast-1": "x-ai/grok-build-0.1",
+};
+const MODEL_DISPLAY_NAMES = {
+    "anthropic/claude-haiku-5.5": "Claude Haiku 5.5",
+    "anthropic/claude-opus-4.8": "Claude Opus 4.8",
+    "anthropic/claude-opus-5.5": "Claude Opus 5.5",
+    "anthropic/claude-sonnet-5.5": "Claude Sonnet 5.5",
+    "deepseek/deepseek-chat-v3.1": "DeepSeek v3.1",
+    "deepseek/deepseek-v4-pro": "DeepSeek V4 Pro",
+    "deepseek/deepseek-v4.1-flash": "DeepSeek V4.1 Flash",
+    "gemini-3.1-pro-preview": "Gemini 3.1 Pro Preview",
+    "google/gemini-3.1-flash-lite": "Gemini 3.1 Flash-Lite",
+    "google/gemini-3.1-pro-preview": "Gemini 3.1 Pro",
+    "google/gemini-3.5-flash-lite": "Gemini 3.5 Flash-Lite",
+    "google/gemini-3.8-flash": "Gemini 3.8 Flash",
+    "inception/mercury-2.5": "Mercury 2.5",
+    "meta/muse-spark-1.3": "Muse Spark 1.3",
+    "moonshotai/kimi-k2.5": "Kimi K2.5",
+    "qwen/qwen3-coder": "Qwen3 Coder",
+    "qwen/qwen3.8-max-0902": "Qwen 3.8 Max",
+    "x-ai/grok-4.7": "Grok 4.7",
+    "x-ai/grok-build-0.1": "Grok Build 0.1",
+    "z-ai/glm-4.5": "GLM 4.5",
+    "z-ai/glm-5.1": "GLM 5.1",
+    "z-ai/glm-5.2": "GLM 5.2",
+    "z-ai/glm-5.3-flash": "GLM 5.3 Flash",
+};
 function parseVersionedModelId(model) {
     const match = /^(?<family>.+?)[-.](?<version>\d+(?:[-.]\d+)*)(?<suffix>(?:[-.][a-z][a-z0-9]*)*)$/i.exec(model.trim().toLowerCase());
     const groups = match?.groups;
@@ -43,6 +72,22 @@ export function findLatestSupportedVersionMatch(candidate, supportedModels) {
     }
     return best?.model;
 }
+export function upgradeBuilderModelAlias(candidate, supportedModels) {
+    const latest = BUILDER_MODEL_ALIASES[candidate];
+    return latest && supportedModels.includes(latest) ? latest : undefined;
+}
+function upgradeOpenRouterModelAlias(candidate, supportedModels, provider) {
+    if (provider !== "ai-sdk:openrouter")
+        return undefined;
+    const latest = OPENROUTER_MODEL_ALIASES[candidate];
+    return latest && supportedModels.includes(latest) ? latest : undefined;
+}
+function upgradeProviderModelAlias(candidate, supportedModels, provider) {
+    return ((provider === "builder"
+        ? upgradeBuilderModelAlias(candidate, supportedModels)
+        : undefined) ??
+        upgradeOpenRouterModelAlias(candidate, supportedModels, provider));
+}
 export function isNewerVersionedModel(candidate, newerModel) {
     const current = parseVersionedModelId(candidate);
     const newer = parseVersionedModelId(newerModel);
@@ -65,3 +110,111 @@ export function upgradeModelToLatestSupportedVersion(candidate, supportedModels)
         ? latest
         : undefined;
 }
+export function upgradeModelForProvider(candidate, supportedModels, provider) {
+    return (upgradeProviderModelAlias(candidate, supportedModels, provider) ??
+        upgradeModelToLatestSupportedVersion(candidate, supportedModels));
+}
+export function normalizeModelForEngine(engine, model, options = {}) {
+    const candidate = typeof model === "string" ? model.trim() : "";
+    if (!candidate)
+        return engine.defaultModel;
+    const providerAlias = upgradeProviderModelAlias(candidate, engine.supportedModels, engine.name);
+    if (providerAlias)
+        return providerAlias;
+    if (engine.preserveCustomModels || options.preserveCustomModels) {
+        return candidate;
+    }
+    const upgradedModel = upgradeModelForProvider(candidate, engine.supportedModels, engine.name);
+    if (upgradedModel)
+        return upgradedModel;
+    if (candidate === "auto" ||
+        engine.supportedModels.includes(candidate) ||
+        engine.supportedModels.length === 0) {
+        return candidate;
+    }
+    if (engine.acceptsCustomModels || options.acceptsCustomModels) {
+        return candidate === BUILDER_CLAUDE_SONNET_MODEL_ID &&
+            engine.supportedModels.includes(CLAUDE_SONNET_MODEL_ID)
+            ? CLAUDE_SONNET_MODEL_ID
+            : candidate;
+    }
+    const versionMatch = findLatestSupportedVersionMatch(candidate, engine.supportedModels);
+    if (versionMatch && isNewerVersionedModel(candidate, versionMatch)) {
+        return versionMatch;
+    }
+    if (versionMatch)
+        return versionMatch;
+    return engine.defaultModel;
+}
+function displayModelName(model) {
+    const knownLabel = Object.hasOwn(MODEL_DISPLAY_NAMES, model)
+        ? MODEL_DISPLAY_NAMES[model]
+        : undefined;
+    if (knownLabel !== undefined)
+        return knownLabel;
+    const normalizedModel = model.replace(/^(?:anthropic|openai|google)\//, "");
+    const claudeLabel = getClaudeModelOptionLabel(normalizedModel);
+    if (claudeLabel !== normalizedModel)
+        return claudeLabel;
+    const gpt = /^gpt-(\d+)(?:[.-](\d+))?(?:-(.+))?$/.exec(normalizedModel);
+    if (gpt) {
+        const version = gpt[2] ? `${gpt[1]}.${gpt[2]}` : gpt[1];
+        const tierParts = gpt[3]?.split("-");
+        if (tierParts?.some((part) => !part))
+            return normalizedModel;
+        const tier = tierParts?.length
+            ? ` ${tierParts
+                .map((part) => part[0].toUpperCase() + part.slice(1))
+                .join(" ")}`
+            : "";
+        return `GPT-${version}${tier}`;
+    }
+    if (normalizedModel.startsWith("gemini-")) {
+        return `Gemini ${normalizedModel
+            .slice("gemini-".length)
+            .replace(/-/g, " ")
+            .replace(/\bflash\b/gi, "Flash")
+            .replace(/\bpro\b/gi, "Pro")
+            .replace(/\blite\b/gi, "Lite")}`;
+    }
+    if (normalizedModel.startsWith("grok-")) {
+        return `Grok ${normalizedModel.slice("grok-".length).replace(/-/g, " ")}`;
+    }
+    if (normalizedModel.startsWith("deepseek-")) {
+        return `DeepSeek ${normalizedModel
+            .slice("deepseek-".length)
+            .replace(/^v(\d)/i, "V$1")
+            .replace(/-/g, " ")}`;
+    }
+    if (normalizedModel.startsWith("qwen")) {
+        return normalizedModel.replace(/-/g, " ").replace(/^qwen/i, "Qwen");
+    }
+    if (normalizedModel.startsWith("glm-")) {
+        return `GLM ${normalizedModel.slice("glm-".length).replace(/-/g, " ")}`;
+    }
+    if (normalizedModel.startsWith("kimi-")) {
+        return `Kimi ${normalizedModel.slice("kimi-".length).replace(/-/g, " ")}`;
+    }
+    return normalizedModel;
+}
+export function getModelOptionLabel(model, engine, builderFallbackLabel) {
+    if (!engine)
+        return displayModelName(model);
+    const effectiveModel = normalizeModelForEngine(engine, model);
+    const effectiveLabel = displayModelName(effectiveModel);
+    if (effectiveModel === model)
+        return effectiveLabel;
+    const engineLabel = engine.name === "builder"
+        ? builderFallbackLabel
+        : (engine.label ?? engine.name);
+    return engineLabel
+        ? `${displayModelName(model)} → ${effectiveLabel} · ${engineLabel}`
+        : `${displayModelName(model)} → ${effectiveLabel}`;
+}
+export function getBuilderModelOptionLabel(model, builderFallbackLabel) {
+    return getModelOptionLabel(model, {
+        name: "builder",
+        label: "Builder",
+        ...BUILDER_MODEL_CONFIG,
+    }, builderFallbackLabel);
+}

package/dist/agent/production-agent.d.ts

@@ -661,6 +661,7 @@ export declare function isRecoverableContinuationError(event: {
     error: string;
     errorCode?: string;
     recoverable?: boolean;
+    providerRetryable?: boolean;
 }): boolean;
 export declare function lastUnfinishedPreparingActionToolFromEvents(events: readonly AgentChatEvent[]): string | undefined;
 export declare function backgroundContinuationReasonForRun(run: ActiveRun): AgentLoopContinuationReason;

package/dist/agent/production-agent.js

@@ -1160,8 +1160,9 @@ export function isRetryableError(err) {
         msg.includes("daily gateway request cap"))
         return false;
     if (engineErr) {
-        if (engineErr.providerRetryable === true)
-            return true;
+        if (engineErr.providerRetryable !== undefined) {
+            return engineErr.providerRetryable;
+        }
         const sc = engineErr.statusCode;
         if (sc === 429 || sc === 500 || sc === 502 || sc === 503 || sc === 529)
             return true;
@@ -1943,6 +1944,11 @@ export function isResumableEngineError(err) {
     if (!(err instanceof Error))
         return false;
     const code = err instanceof EngineError ? (err.errorCode ?? "").toLowerCase() : "";
+    if ((err instanceof EngineError && err.providerRetryable === false) ||
+        code === "invalid_request" ||
+        code === "invalid_request_error") {
+        return false;
+    }
     if (code === "builder_gateway_timeout" ||
         code === "builder_gateway_network_error" ||
         code === "builder_gateway_stream_ended" ||
@@ -1952,6 +1958,9 @@ export function isResumableEngineError(err) {
     if (code === "http_502" ||
         code === "http_503" ||
         code === "http_504" ||
+        (code === "overloaded_error" &&
+            err instanceof EngineError &&
+            err.providerRetryable === true) ||
         code === "timeout") {
         return true;
     }
@@ -1989,6 +1998,8 @@ export function isTransientProviderRateLimitError(err) {
         return true;
     if (code === PROVIDER_TRANSIENT_REJECTION_ERROR_CODE)
         return true;
+    if (code === "overloaded_error" && err.providerRetryable === true)
+        return true;
     if (code === "rate_limited" && err.providerRetryable === true)
         return true;
     return false;
@@ -2011,6 +2022,9 @@ export function continuationReasonForResumableError(err) {
         code === "http_529" ||
         code === "rate_limited" ||
         code === PROVIDER_TRANSIENT_REJECTION_ERROR_CODE ||
+        (code === "overloaded_error" &&
+            err instanceof EngineError &&
+            err.providerRetryable === true) ||
         (err instanceof EngineError &&
             (err.statusCode === 429 ||
                 err.statusCode === 529 ||
@@ -3438,7 +3452,7 @@ export async function runAgentLoop(opts) {
     };
     if (followUpRunId)
         send({ type: "suggestions", suggestions: [] });
-    let model = opts.model;
+    let model = normalizeModelForEngine(engine, opts.model);
     let outcomeReported = false;
     const reportOutcome = (outcome) => {
         if (outcomeReported)
@@ -5767,10 +5781,13 @@ function backgroundChatProgressRunId(turnId) {
 export function isRecoverableContinuationError(event) {
     const code = String(event.errorCode ?? "").toLowerCase();
     const message = event.error.toLowerCase();
-    if (code === "builder_gateway_error")
-        return false;
-    if (event.recoverable === false)
+    if (event.providerRetryable === false ||
+        event.recoverable === false ||
+        code === "builder_gateway_error" ||
+        code === "invalid_request" ||
+        code === "invalid_request_error") {
         return false;
+    }
     return (event.recoverable === true ||
         code === "builder_gateway_timeout" ||
         code === "builder_gateway_network_error" ||
@@ -5790,6 +5807,7 @@ export function isRecoverableContinuationError(event) {
         code === "http_504" ||
         code === "http_529" ||
         code === "run_timeout" ||
+        (code === "overloaded_error" && event.providerRetryable === true) ||
         message.includes("timeout") ||
         isProviderConnectionErrorMessage(message) ||
         message.includes("temporarily unavailable"));

package/dist/agent/provider-model-selection.js

@@ -20,7 +20,7 @@ import { deleteOrgSetting, deleteUserSetting, getOrgSetting, getUserSetting, put
 import { isCustomOpenAiBaseUrl, OLLAMA_BASE_URL_ENV_VAR, OPENAI_BASE_URL_ENV_VAR, } from "./engine/openai-compatible-endpoint.js";
 import { PROVIDER_ENV_META } from "./engine/provider-env-vars.js";
 import { BUILDER_MODEL_CONFIG } from "./model-config.js";
-import { upgradeModelToLatestSupportedVersion } from "./model-version.js";
+import { upgradeModelForProvider } from "./model-version.js";
 export const PROVIDER_MODEL_SELECTION_KEY_PREFIX = "agent-provider-models";
 /** Audit target type for selection changes and refused attempts. */
 export const PROVIDER_MODEL_SELECTION_AUDIT_TARGET_TYPE = "provider-models";
@@ -96,7 +96,7 @@ export function normalizeSelectedModels(provider, models, options = {}) {
     const normalized = [
         ...new Set([...seen].map((id) => options.preserveCustomModels
             ? id
-            : (upgradeModelToLatestSupportedVersion(id, supportedModels) ?? id))),
+            : (upgradeModelForProvider(id, supportedModels, provider) ?? id))),
     ];
     if (provider === "builder") {
         const catalog = new Set(BUILDER_MODEL_CONFIG.supportedModels);
@@ -196,10 +196,12 @@ function parseRow(provider, scope, stored, preserveCustomModels = false) {
         return { provider, scope, models: null, ...customModelMetadata };
     }
     const models = stored.models.filter((model) => typeof model === "string" && !!model.trim());
+    const supportedModels = recommendedProviderModels(provider);
     const currentModels = [
         ...new Set(models.map((model) => preserveCustomModels
             ? model
-            : (upgradeModelToLatestSupportedVersion(model, recommendedProviderModels(provider)) ?? model))),
+            : (upgradeModelForProvider(model, supportedModels, provider) ??
+                model))),
     ];
     return {
         provider,
@@ -398,7 +400,7 @@ export async function resolveUncheckedDefaultModelReplacement(engine) {
         return undefined;
     const currentDefault = selection.preserveCustomModels
         ? engine.defaultModel
-        : (upgradeModelToLatestSupportedVersion(engine.defaultModel, recommendedProviderModels(provider)) ?? engine.defaultModel);
+        : (upgradeModelForProvider(engine.defaultModel, recommendedProviderModels(provider), provider) ?? engine.defaultModel);
     if (selection.models.includes(currentDefault))
         return undefined;
     return selection.models[0];

package/dist/agent/run-manager.js

@@ -6,6 +6,7 @@ import { ServicePrincipalRefusedError } from "../org/service-principal-guard.js"
 import { captureError } from "../server/capture-error.js";
 import { isLlmCredentialError, LLM_MISSING_CREDENTIALS_ERROR_CODE, LLM_MISSING_CREDENTIALS_MESSAGE, } from "./engine/credential-errors.js";
 import { classifyTerminalErrorCode, describeErrorWithCauses, isProviderConnectionError, } from "./engine/error-detail.js";
+import { runErrorTelemetryProperties } from "./engine/error-telemetry.js";
 import { getAgentEngineEntry } from "./engine/registry.js";
 import { EngineError } from "./engine/types.js";
 import { insertRun, insertRunEvent, updateRunStatusIfRunning, markRunAborted, getRunAbortState, getRunStatus, getRunEventsSince, getCurrentTurnRunEventsForThread, getRunById, getRunByThread, getRunTurnRef, markTurnAborted, cleanupOldRuns, updateRunHeartbeat, bumpRunProgress, setRunInFlightMarker, reapIfStale, reapUnclaimedBackgroundRun, shouldRedispatchUnclaimedBackgroundRun, reconcileTerminalRunFromEvents, ensureTerminalRunEvent, getLastTerminalRunEvent, resolveErroredRunTerminalEvent, setRunError, setRunTerminalReason, persistRunCheckpointEvent, recordRunDiagnostic, RUN_DIAG_STAGE, terminalEventForAbortReason, RUN_RECORD_MISSING_ERROR_EVENT, RUN_RECORD_MISSING_GRACE_MS, RUN_TERMINAL_LOOKUP_FAILED_ERROR_EVENT, UNKNOWN_RUN_STATUS_ERROR_EVENT, } from "./run-store.js";
@@ -319,7 +320,6 @@ function terminalReasonForRun(finalStatus, terminalEvent, abortReason, completio
         return "error:unknown";
     return "done";
 }
-const MAX_RUN_ERROR_DETAIL_LENGTH = 500;
 function emitRunBoundaryTrackingEvent(args) {
     const properties = {
         source: "agent_run_manager",
@@ -375,11 +375,7 @@ function emitRunTerminalTrackingEvent(args) {
         status: args.status,
         terminal_reason: args.terminalReason,
         error_code: args.errorCode,
-        error_detail: args.errorDetail
-            ? args.errorDetail.length > MAX_RUN_ERROR_DETAIL_LENGTH
-                ? `${args.errorDetail.slice(0, MAX_RUN_ERROR_DETAIL_LENGTH)}…`
-                : args.errorDetail
-            : undefined,
+        ...(args.errorCode ? runErrorTelemetryProperties(args.errorCode) : {}),
         dispatch_mode: args.dispatchMode,
         abort_reason: args.abortReason,
         duration_ms: args.durationMs,
@@ -991,6 +987,7 @@ export function startRun(runId, threadId, runFn, onComplete, options) {
         captureError(error, {
             route: "/_agent-native/agent-chat",
             aiTraceId: runId,
+            errorMessagePolicy: "omit",
             tags: {
                 source: "agent-run-manager",
                 phase,
@@ -1122,8 +1119,8 @@ export function startRun(runId, threadId, runFn, onComplete, options) {
             ...(err instanceof EngineError && err.upgradeUrl
                 ? { upgradeUrl: err.upgradeUrl }
                 : {}),
-            ...(err instanceof EngineError && err.providerRetryable === true
-                ? { providerRetryable: true }
+            ...(err instanceof EngineError && err.providerRetryable !== undefined
+                ? { providerRetryable: err.providerRetryable }
                 : {}),
             ...(err instanceof EngineError && err.contextOverflow === true
                 ? { contextOverflow: true }
@@ -1135,7 +1132,6 @@ export function startRun(runId, threadId, runFn, onComplete, options) {
         let terminalPersistenceError = null;
         let eventPersistenceError = null;
         let runTerminalErrorCode;
-        let runTerminalErrorDetail;
         let terminalPersistenceEstablished = false;
         try {
             await persistenceChain;
@@ -1335,7 +1331,6 @@ export function startRun(runId, threadId, runFn, onComplete, options) {
             }
             errorCode ??= classifyTerminalErrorCode(errorDetail);
             runTerminalErrorCode = errorCode ?? "unknown";
-            runTerminalErrorDetail = errorDetail;
             await setRunError(runId, errorCode ?? "unknown", errorDetail);
         }
         if (terminalPersistenceError) {
@@ -1362,7 +1357,6 @@ export function startRun(runId, threadId, runFn, onComplete, options) {
                 status: persistedStatus,
                 terminalReason,
                 errorCode: runTerminalErrorCode,
-                errorDetail: runTerminalErrorDetail,
                 dispatchMode: options?.dispatchMode,
                 abortReason: run.abortReason,
                 durationMs: Date.now() - run.startedAt,

package/dist/agent/thread-data-builder.js

@@ -1,6 +1,7 @@
 import { parseAgentSuggestion, } from "@agent-native/agentkit/protocol";
 import { formatChatErrorText, normalizeChatError, } from "../client/error-format.js";
 import { isCredentialGapCodeAgentEvent, normalizeCodeAgentTranscript, } from "../code-agents/transcript-normalizer.js";
+import { stripAgentChatContextFromMessage } from "../shared/agent-chat-context.js";
 import { RUN_NOT_STARTED_METADATA_KEY, } from "../shared/agent-chat-run-not-started.js";
 import { BUILDER_GATEWAY_INTERNAL_ERROR_CODE } from "./engine/error-detail.js";
 import { stringifyToolUseInputForGateway } from "./engine/translate-anthropic.js";
@@ -13,10 +14,13 @@ const MAX_STORED_ATTACHMENT_CHARS = 60_000;
 function isInternalContinuationError(event) {
     const code = String(event.errorCode ?? "").toLowerCase();
     const msg = event.error.toLowerCase();
-    if (code === "builder_gateway_error")
-        return false;
-    if (event.recoverable === false)
+    if (event.providerRetryable === false ||
+        event.recoverable === false ||
+        code === "builder_gateway_error" ||
+        code === "invalid_request" ||
+        code === "invalid_request_error") {
         return false;
+    }
     return (event.recoverable === true ||
         code === "builder_gateway_timeout" ||
         code === "builder_gateway_stream_ended" ||
@@ -3007,10 +3011,14 @@ export function extractThreadMeta(repo) {
             : typeof msg.content === "string"
                 ? msg.content
                 : "";
-        if (textParts.trim()) {
+        const visiblePrompt = stripAgentChatContextFromMessage(textParts)
+            .replace(/@\[([^\]|]+)\|[^\]]*\]/g, "@$1")
+            .replace(/\s+/g, " ")
+            .trim();
+        if (visiblePrompt) {
             if (!title)
-                title = textParts.trim().slice(0, 80);
-            preview = textParts.trim().slice(0, 120);
+                title = visiblePrompt.slice(0, 80);
+            preview = visiblePrompt.slice(0, 120);
         }
     }
     return { title: titleOverride || title, preview };

package/dist/authorization/check-action.js

@@ -1,6 +1,7 @@
 import { getDbExec } from "../db/client.js";
 import { getAppPermissionOverrides, getRegisteredAppRoles, resolveAppRole, } from "../org/app-roles.js";
 import { isWorkspaceAppAccessAllowed, WORKSPACE_APP_ACCESS_UNAVAILABLE, WORKSPACE_APP_ACCESS_UNAVAILABLE_MESSAGE, } from "../org/workspace-app-access.js";
+import { resolveWorkspaceAccessAppId } from "../org/workspace-app-identity.js";
 import { ForbiddenError, resolveAccess } from "../sharing/access.js";
 import { ROLE_RANK } from "../sharing/schema.js";
 import { registerActionAccessChecker } from "./action-access-runtime.js";
@@ -63,10 +64,13 @@ export async function checkAction(config, args, ctx, target) {
                 permission,
             };
         }
-        const appAllowed = await isWorkspaceAppAccessAllowed(appId, {
-            email: identity.userEmail,
-            orgId: identity.orgId,
-        });
+        const workspaceAppId = resolveWorkspaceAccessAppId(appId);
+        const appAllowed = workspaceAppId
+            ? await isWorkspaceAppAccessAllowed(workspaceAppId, {
+                email: identity.userEmail,
+                orgId: identity.orgId,
+            })
+            : true;
         if (appAllowed === WORKSPACE_APP_ACCESS_UNAVAILABLE) {
             throw Object.assign(new Error(WORKSPACE_APP_ACCESS_UNAVAILABLE_MESSAGE), {
                 statusCode: 503,

package/dist/chat-threads/store.js

@@ -1,5 +1,5 @@
 import crypto from "node:crypto";
-import { mergeThreadDataForClientSave, normalizeThreadRepository, normalizeThreadTitle, } from "../agent/thread-data-builder.js";
+import { extractThreadMeta, mergeThreadDataForClientSave, normalizeThreadRepository, normalizeThreadTitle, } from "../agent/thread-data-builder.js";
 import { representedRootAssistantMessageIds, threadMessageRecord, } from "../agent/thread-message-projection.js";
 import { getDbExec } from "../db/client.js";
 import { createGetDb } from "../db/create-get-db.js";
@@ -1101,16 +1101,29 @@ export async function updateThreadData(id, threadData, title, preview, messageCo
             // Completion persistence can race the separate generated-title save.
             // Keep a title already committed by that save when this caller only has
             // its stale empty snapshot.
-            const preserveCurrentTitleAndPreview = options.preserveCurrentMetadata ||
-                options.preserveCurrentTitleAndPreview;
-            const nextTitle = preserveCurrentTitleAndPreview
+            const preserveCurrentMetadata = options.preserveCurrentMetadata;
+            const preserveCurrentTitleAndPreview = options.preserveCurrentTitleAndPreview;
+            const snapshotMetaForBlankFields = !options.preserveCurrentMetadata &&
+                options.preserveCurrentTitleAndPreview &&
+                (!current.title.trim() || !current.preview.trim())
+                ? extractThreadMeta(merged)
+                : undefined;
+            const nextTitle = preserveCurrentMetadata
                 ? current.title
-                : title || current.title;
-            const nextPreview = preserveCurrentTitleAndPreview
+                : preserveCurrentTitleAndPreview
+                    ? current.title.trim()
+                        ? current.title
+                        : snapshotMetaForBlankFields?.title || current.title
+                    : title || current.title || extractThreadMeta(merged).title;
+            const nextPreview = preserveCurrentMetadata
                 ? current.preview
-                : typeof transformed === "object" && transformed.preview !== undefined
-                    ? transformed.preview
-                    : preview;
+                : preserveCurrentTitleAndPreview
+                    ? current.preview.trim()
+                        ? current.preview
+                        : snapshotMetaForBlankFields?.preview || current.preview
+                    : typeof transformed === "object" && transformed.preview !== undefined
+                        ? transformed.preview
+                        : preview;
             const result = await client.execute({
                 sql: `UPDATE chat_threads SET thread_data = ?, title = ?, preview = ?, message_count = COALESCE(?, message_count), updated_at = ? WHERE id = ? AND updated_at = ? AND LOWER(owner_email) = LOWER(?)`,
                 args: [

package/dist/client/analytics.d.ts

@@ -107,6 +107,7 @@ export interface LastTouchAttribution {
     capture_truncated?: string;
 }
 export declare function getAnalyticsIdentityKey(): string | undefined;
+export declare function resolveAnalyticsIdentityKey(): Promise<string | undefined>;
 export declare function getAnalyticsAnonymousId(): string | undefined;
 export declare function getAnalyticsSessionId(): string | undefined;
 export declare function getFirstTouchAttribution(): FirstTouchAttribution | null;

package/dist/client/analytics.js

@@ -343,20 +343,22 @@ function setTrackingIdentityFromSession(data) {
     };
 }
 function refreshTrackingAuthSession() {
-    if (typeof window === "undefined" || typeof fetch !== "function") {
+    if (typeof window === "undefined") {
         _trackingIdentityResolved = true;
         return Promise.resolve();
     }
+    if (typeof fetch !== "function")
+        return Promise.resolve();
     if (_trackingSessionRefresh)
         return _trackingSessionRefresh;
     _trackingSessionRefresh = fetchAuthSessionStatus()
         .then((result) => {
         if (result.state === "available") {
             setTrackingIdentityFromSession(result.value);
+            _trackingIdentityResolved = true;
         }
     })
         .finally(() => {
-        _trackingIdentityResolved = true;
         _trackingSessionRefresh = null;
     });
     return _trackingSessionRefresh;
@@ -396,6 +398,12 @@ function getTrackingAuthUserId() {
 export function getAnalyticsIdentityKey() {
     return getTrackingUserId() || getOrCreateAnonymousId();
 }
+export async function resolveAnalyticsIdentityKey() {
+    if (!_trackingIdentityResolved) {
+        await (_trackingSessionRefresh ?? refreshTrackingAuthSession());
+    }
+    return _trackingIdentityResolved ? getAnalyticsIdentityKey() : undefined;
+}
 function getOrCreateAnonymousId() {
     return getOrCreateAnalyticsAnonymousId();
 }

package/dist/client/chat/runtime.js

@@ -1,5 +1,6 @@
 import { AgentKitRunSlotBusyError } from "@agent-native/agentkit/client";
 import { AUTO_CONTINUE_OF_RUN_METADATA_KEY, CONTINUE_OF_RUN_METADATA_KEY, } from "../../agent/auto-continue.js";
+import { getOrCreateAnalyticsSessionId } from "../analytics-session.js";
 import { agentChatStreamingUrl, agentNativePath } from "../api-path.js";
 import { CHAT_REQUEST_TOO_LARGE_MESSAGE } from "../error-format.js";
 import { appendMissingFinalResponseWarning, } from "../sse-event-processor.js";
@@ -2399,6 +2400,11 @@ export function createAgentNativeChatRuntime(options = {}) {
     const runtimeId = options.id ?? "agent-native";
     const fetchImpl = options.fetch ?? fetch;
     const streamingUrl = options.streamingUrl?.trim() || agentChatStreamingUrl();
+    const isSameOriginEndpoint = (url) => {
+        if (typeof window === "undefined")
+            return false;
+        return new URL(url, window.location.href).origin === window.location.origin;
+    };
     let streamFallbackWarningShown = false;
     const runtimeFetch = streamingUrl
         ? async (input, init) => {
@@ -2439,6 +2445,9 @@ export function createAgentNativeChatRuntime(options = {}) {
             }
             const headers = new Headers(init?.headers);
             headers.set("Authorization", `Bearer ${token}`);
+            if (!isSameOriginEndpoint(streamingUrl)) {
+                headers.delete("x-agent-native-session-id");
+            }
             try {
                 return await fetchImpl(streamingUrl, {
                     ...init,
@@ -2471,6 +2480,15 @@ export function createAgentNativeChatRuntime(options = {}) {
         headers: async (input) => {
             const headers = await resolveHeaders(options.headers, input);
             headers.set("x-agent-native-surface", options.surface ?? "app");
+            if (!isSameOriginEndpoint(apiUrl)) {
+                headers.delete("x-agent-native-session-id");
+            }
+            else if (!headers.has("x-agent-native-session-id")) {
+                const browserSessionId = getOrCreateAnalyticsSessionId();
+                if (browserSessionId) {
+                    headers.set("x-agent-native-session-id", browserSessionId);
+                }
+            }
             return headers;
         },
         capabilities: {

package/dist/client/chat-model-groups.d.ts

@@ -10,7 +10,10 @@ export interface EngineModelGroup {
 export interface ChatModelEngineEntry {
     name: string;
     label: string;
+    defaultModel?: string;
     supportedModels?: readonly string[];
+    /** Full runtime model set, independent of any user-selected picker subset. */
+    runtimeSupportedModels?: readonly string[];
     modelDisplayNames?: Readonly<Record<string, string>>;
     acceptsCustomModels?: boolean;
     preserveCustomModels?: boolean;

package/dist/client/error-format.js

@@ -312,7 +312,10 @@ function isConnectionError(text, errorCode) {
 export function normalizeChatError(errorMessage, errorCode) {
     const raw = String(errorMessage || "Unknown error");
     const looksHtml = /<html[\s>]|<body[\s>]|<head[\s>]/i.test(raw);
-    const text = looksHtml ? htmlToText(raw) : raw.trim();
+    const providerText = looksHtml ? htmlToText(raw) : raw.trim();
+    const text = /^Gateway error \(no detail; raw event:/i.test(providerText)
+        ? "Gateway error (no detail)"
+        : providerText;
     const providerPayload = looksHtml ? null : parseProviderErrorPayload(text);
     const code = normalizeErrorCode(errorCode ?? providerPayload?.errorCode);
     const credential = chatCredentialState(text, code);
@@ -385,12 +388,6 @@ export function normalizeChatError(errorMessage, errorCode) {
             details: text,
         };
     }
-    if (/^Gateway error \(no detail; raw event:/i.test(text)) {
-        return {
-            message: "The model gateway returned no error details and the chat couldn't recover. Wait a moment and retry, or start a new chat if it keeps happening.",
-            details: text,
-        };
-    }
     if (/inactivity timeout/i.test(text)) {
         return {
             message: "The agent connection timed out before it could finish. You can continue from the partial work or retry.",
@@ -411,6 +408,12 @@ export function normalizeChatError(errorMessage, errorCode) {
             details: text,
         };
     }
+    if (/^Gateway error \(no detail(?:;|\))/i.test(text)) {
+        return {
+            message: "The model gateway returned no error details and the chat couldn't recover. Wait a moment and retry, or start a new chat if it keeps happening.",
+            details: text,
+        };
+    }
     if (looksHtml) {
         return {
             message: text.slice(0, 240) || "The provider returned an HTML error page.",