@agent-native/core 0.189.0 → 0.190.0-nightly-20260925215540

package/corpus/templates/slides/vite.config.ts

@@ -25,15 +25,6 @@ export default defineConfig({
     }),
   ],
   optimizeDeps: {
-    include: [
-      "@tiptap/core",
-      "@tiptap/react",
-      "@tiptap/starter-kit",
-      "@tiptap/extension-collaboration",
-      "@tiptap/extension-collaboration-caret",
-      "@tiptap/y-tiptap",
-      "yjs",
-      "y-protocols/awareness",
-    ],
+    include: ["yjs", "y-protocols/awareness"],
   },
 });

package/dist/agent/jev-tool-prefetch.d.ts

@@ -1,6 +1,8 @@
 import { type BuilderGatewayAuth } from "../server/credential-provider.js";
 import type { EngineTool } from "./engine/types.js";
 import type { ActionEntry, JevContextCredentials } from "./production-agent.js";
+import type { AgentChatStructuredMessage, AgentMessage } from "./types.js";
+export declare const JEV_TIMEOUT_MS = 750;
 type JevChoiceAnswer = {
     choice?: unknown;
     probabilities?: unknown;
@@ -25,21 +27,45 @@ export interface JevRankCandidatesOptions {
     apiKey?: string;
     personalApiKey?: string;
     builderAuth?: BuilderGatewayAuth | null;
+    /** IDs, descriptions, and metadata are sent to Jev; callers provide summaries only. */
     candidates: readonly JevCandidate[];
     candidateStateKey: string;
     answerKey: string;
     question: string;
     limit?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
+}
+export interface JevCandidateRanking {
+    status: "selected" | "no-match" | "unavailable";
+    ids: string[];
 }
+/** Keep Jev grounded in recent user requests without sending assistant results. */
+export declare function buildJevRequestContext(input: {
+    request: string;
+    history?: readonly AgentMessage[];
+    structuredHistory?: readonly AgentChatStructuredMessage[];
+}): string;
+/** Current request plus the last two user turns for semantic/catalog retrieval. */
+export declare function buildRecentUserRequestContext(input: {
+    request: string;
+    history?: readonly AgentMessage[];
+    structuredHistory?: readonly AgentChatStructuredMessage[];
+}): string;
 /**
- * Rank a bounded metadata-only catalog with Jev. A missing key, malformed
- * response, timeout, or provider failure returns no ranking so callers keep
- * their existing deterministic fallback.
+ * Rank a bounded metadata-only catalog with Jev. Direct keys send bounded
+ * request text and candidate IDs, descriptions, and metadata to a third party;
+ * callers must omit paths, raw bodies, SQL, tool inputs/results, and row data.
+ * A missing key, malformed response, timeout, or provider failure returns no
+ * ranking so callers keep their existing deterministic fallback.
  */
 export declare function rankJevCandidates(options: JevRankCandidatesOptions): Promise<string[]>;
+export declare function rankJevCandidatesWithStatus(options: JevRankCandidatesOptions): Promise<JevCandidateRanking>;
 export declare function shortlistJevCandidates<T extends JevCandidate>(request: string, candidates: readonly T[]): T[];
 export interface JevToolPrefetchOptions {
     request: string;
+    skip?: boolean;
+    deadlineAt?: number;
     apiKey?: string;
     personalApiKey?: string;
     builderAuth?: BuilderGatewayAuth | null;

package/dist/agent/jev-tool-prefetch.js

@@ -4,25 +4,121 @@ import { searchToolRegistry, TOOL_SEARCH_ACTION_NAME } from "./tool-search.js";
 const MAX_JEV_CANDIDATES = 128;
 const DEFAULT_PREFETCH_LIMIT = 3;
 const MAX_PREFETCH_LIMIT = 5;
-const JEV_TIMEOUT_MS = 750;
+export const JEV_TIMEOUT_MS = 750;
 const JEV_MODEL = "jev-latest";
+const MAX_JEV_THREAD_CONTEXT_CHARS = 6_000;
+const MAX_JEV_PRIOR_USER_MESSAGES = 4;
+const MAX_JEV_PRIOR_MESSAGE_CHARS = 1_100;
+const MAX_JEV_CURRENT_MESSAGE_CHARS = 3_600;
+const MAX_RETRIEVAL_CONTEXT_CHARS = 3_600;
+const MAX_RETRIEVAL_PRIOR_USER_MESSAGES = 2;
+const MAX_RETRIEVAL_PRIOR_MESSAGE_CHARS = 900;
+function compactJevText(value, maxChars) {
+    const text = value.replace(/\s+/g, " ").trim();
+    if (text.length <= maxChars)
+        return text;
+    const ellipsis = " … ";
+    const startChars = Math.ceil((maxChars - ellipsis.length) * 0.75);
+    return `${text.slice(0, startChars)}${ellipsis}${text.slice(-(maxChars - startChars - ellipsis.length))}`;
+}
+function visiblePriorMessages(input) {
+    const structured = Array.isArray(input.structuredHistory)
+        ? input.structuredHistory.flatMap((message) => {
+            if (!message ||
+                (message.role !== "user" && message.role !== "assistant") ||
+                !Array.isArray(message.content)) {
+                return [];
+            }
+            const text = message.content
+                .flatMap((part) => part?.type === "text" && typeof part.text === "string"
+                ? [part.text]
+                : [])
+                .join(" ")
+                .trim();
+            return text ? [{ role: message.role, content: text }] : [];
+        })
+        : [];
+    return Array.isArray(input.structuredHistory)
+        ? structured
+        : (Array.isArray(input.history) ? input.history : []).flatMap((message) => message &&
+            (message.role === "user" || message.role === "assistant") &&
+            typeof message.content === "string" &&
+            message.content.trim()
+            ? [{ role: message.role, content: message.content }]
+            : []);
+}
+/** Keep Jev grounded in recent user requests without sending assistant results. */
+export function buildJevRequestContext(input) {
+    const priorMessages = visiblePriorMessages(input);
+    const current = compactJevText(input.request, MAX_JEV_CURRENT_MESSAGE_CHARS);
+    const currentBlock = `Current request:\n${current}`;
+    let remaining = MAX_JEV_THREAD_CONTEXT_CHARS - currentBlock.length - 40;
+    const recentLines = [];
+    const priorUsers = priorMessages.filter((message) => message.role === "user");
+    const selectedMessages = priorUsers.slice(-MAX_JEV_PRIOR_USER_MESSAGES);
+    for (const message of selectedMessages.reverse()) {
+        if (remaining < 80)
+            break;
+        const content = compactJevText(message.content, Math.min(MAX_JEV_PRIOR_MESSAGE_CHARS, remaining - 12));
+        const line = `User: ${content}`;
+        if (line.length > remaining)
+            break;
+        recentLines.push(line);
+        remaining -= line.length + 1;
+    }
+    const recent = recentLines.reverse();
+    return recent.length
+        ? `Recent conversation:\n${recent.join("\n")}\n\n${currentBlock}`
+        : currentBlock;
+}
+/** Current request plus the last two user turns for semantic/catalog retrieval. */
+export function buildRecentUserRequestContext(input) {
+    const priorUsers = visiblePriorMessages(input)
+        .filter((message) => message.role === "user")
+        .slice(-MAX_RETRIEVAL_PRIOR_USER_MESSAGES);
+    const current = compactJevText(input.request, MAX_JEV_CURRENT_MESSAGE_CHARS);
+    const currentBlock = `Current request:\n${current}`;
+    let remaining = MAX_RETRIEVAL_CONTEXT_CHARS - currentBlock.length - 32;
+    const recentLines = [];
+    for (const message of priorUsers.reverse()) {
+        if (remaining < 80)
+            break;
+        const content = compactJevText(message.content, Math.min(MAX_RETRIEVAL_PRIOR_MESSAGE_CHARS, remaining - 12));
+        const line = `User: ${content}`;
+        if (line.length > remaining)
+            break;
+        recentLines.push(line);
+        remaining -= line.length + 1;
+    }
+    const recent = recentLines.reverse();
+    return recent.length
+        ? `Recent user requests:\n${recent.join("\n")}\n\n${currentBlock}`
+        : currentBlock;
+}
 /**
- * Rank a bounded metadata-only catalog with Jev. A missing key, malformed
- * response, timeout, or provider failure returns no ranking so callers keep
- * their existing deterministic fallback.
+ * Rank a bounded metadata-only catalog with Jev. Direct keys send bounded
+ * request text and candidate IDs, descriptions, and metadata to a third party;
+ * callers must omit paths, raw bodies, SQL, tool inputs/results, and row data.
+ * A missing key, malformed response, timeout, or provider failure returns no
+ * ranking so callers keep their existing deterministic fallback.
  */
 export async function rankJevCandidates(options) {
+    return (await rankJevCandidatesWithStatus(options)).ids;
+}
+export async function rankJevCandidatesWithStatus(options) {
     const request = options.request.trim();
     const apiKey = options.personalApiKey?.trim();
     const builderAuth = options.builderAuth;
     if (!request ||
         (!apiKey && !builderAuth) ||
-        options.candidates.length === 0) {
-        return [];
+        options.candidates.length === 0 ||
+        options.signal?.aborted ||
+        (options.timeoutMs !== undefined && options.timeoutMs <= 0)) {
+        return { status: "unavailable", ids: [] };
     }
     const candidates = shortlistJevCandidates(request, options.candidates);
     if (candidates.length === 0)
-        return [];
+        return { status: "unavailable", ids: [] };
     const limit = Math.max(1, Math.min(options.limit ?? DEFAULT_PREFETCH_LIMIT, MAX_PREFETCH_LIMIT));
     try {
         let noMatchId = "__no_match__";
@@ -57,10 +153,13 @@ export async function rankJevCandidates(options) {
             personalApiKey: options.personalApiKey,
             builderAuth,
             request: jevRequest,
+            signal: options.signal,
+            timeoutMs: options.timeoutMs,
         });
         const answer = response.answers?.[options.answerKey];
-        if (answer?.choice === noMatchId)
-            return [];
+        if (answer?.choice === noMatchId) {
+            return { status: "no-match", ids: [] };
+        }
         const probabilities = answer?.probabilities && typeof answer.probabilities === "object"
             ? answer.probabilities
             : {};
@@ -69,7 +168,7 @@ export async function rankJevCandidates(options) {
             !Number.isFinite(noMatchProbability) ||
             noMatchProbability < 0 ||
             noMatchProbability > 1) {
-            return [];
+            return { status: "unavailable", ids: [] };
         }
         for (const candidate of candidates) {
             const probability = probabilities[candidate.id];
@@ -78,10 +177,10 @@ export async function rankJevCandidates(options) {
                     !Number.isFinite(probability) ||
                     probability < 0 ||
                     probability > 1)) {
-                return [];
+                return { status: "unavailable", ids: [] };
             }
         }
-        return candidates
+        const ids = candidates
             .filter((candidate) => typeof probabilities[candidate.id] === "number" &&
             probabilities[candidate.id] > noMatchProbability)
             .map((candidate) => ({
@@ -91,10 +190,13 @@ export async function rankJevCandidates(options) {
             .sort((a, b) => b.probability - a.probability || a.name.localeCompare(b.name))
             .map((candidate) => candidate.name)
             .slice(0, limit);
+        return ids.length > 0
+            ? { status: "selected", ids }
+            : { status: "no-match", ids: [] };
     }
     catch (error) {
         console.warn("[agent] Jev context prefetch unavailable; continuing with the existing context.", error instanceof Error ? error.message : "unknown error");
-        return [];
+        return { status: "unavailable", ids: [] };
     }
 }
 export function shortlistJevCandidates(request, candidates) {
@@ -122,6 +224,8 @@ export function shortlistJevCandidates(request, candidates) {
  * Jev is an accelerator, not a dependency of agent execution.
  */
 export async function preloadJevTools(options) {
+    if (options.skip)
+        return options.initialTools;
     const request = options.request.trim();
     const apiKey = options.personalApiKey?.trim();
     const builderAuth = options.builderAuth;
@@ -151,48 +255,71 @@ export async function preloadJevTools(options) {
     if (candidates.length === 0)
         return options.initialTools;
     const prefetchLimit = Math.max(1, Math.min(options.limit ?? DEFAULT_PREFETCH_LIMIT, MAX_PREFETCH_LIMIT));
-    const selectedNames = await rankJevCandidates({
-        request,
-        apiKey,
-        personalApiKey: options.personalApiKey,
-        candidates: candidates.map((candidate) => ({
-            id: candidate.name,
-            description: candidate.description,
-            metadata: { kind: "tool" },
-        })),
-        candidateStateKey: "candidate_tools",
-        answerKey: "best_tool",
-        builderAuth,
-        question: "Which tools should be loaded into the agent context first for this task? Pick the most useful tool; probabilities may be used to keep a small ranked shortlist.",
-        limit: prefetchLimit,
-    });
+    const remaining = Math.min(JEV_TIMEOUT_MS, options.deadlineAt === undefined
+        ? JEV_TIMEOUT_MS
+        : options.deadlineAt - Date.now());
+    if (remaining <= 0)
+        return options.initialTools;
+    const controller = new AbortController();
+    let timeout;
+    const selectedNames = await Promise.race([
+        rankJevCandidates({
+            request,
+            apiKey,
+            personalApiKey: options.personalApiKey,
+            candidates: candidates.map((candidate) => ({
+                id: candidate.name,
+                description: candidate.description,
+                metadata: { kind: "tool" },
+            })),
+            candidateStateKey: "candidate_tools",
+            answerKey: "best_tool",
+            builderAuth,
+            question: "Which tools should be loaded into the agent context first for this task? Pick the most useful tool; probabilities may be used to keep a small ranked shortlist.",
+            limit: prefetchLimit,
+            signal: controller.signal,
+            timeoutMs: remaining,
+        }),
+        new Promise((resolve) => {
+            timeout = setTimeout(() => {
+                controller.abort();
+                resolve([]);
+            }, remaining);
+        }),
+    ]);
+    if (timeout)
+        clearTimeout(timeout);
     return selectedNames.length > 0
         ? prependSelectedTools(options, selectedNames)
         : options.initialTools;
 }
 async function requestJev(options) {
+    options.signal?.throwIfAborted();
     const personalApiKey = options.personalApiKey?.trim();
     if (options.builderAuth) {
         try {
-            return await requestJevThroughBuilder(options.builderAuth, options.request);
+            return await requestJevThroughBuilder(options.builderAuth, options.request, { signal: options.signal, timeoutMs: options.timeoutMs });
         }
         catch (error) {
+            options.signal?.throwIfAborted();
             if (!personalApiKey)
                 throw error;
             console.warn("[agent] Builder Jev proxy unavailable; falling back to the direct Jev API.", error instanceof Error ? error.message : "unknown error");
-            return requestJevDirect(personalApiKey, options.request);
+            return requestJevDirect(personalApiKey, options.request, options);
         }
     }
     if (!personalApiKey) {
         throw new Error("Builder Jev proxy is unavailable.");
     }
-    return requestJevDirect(personalApiKey, options.request);
+    return requestJevDirect(personalApiKey, options.request, options);
 }
-async function requestJevDirect(apiKey, request) {
+async function requestJevDirect(apiKey, request, options) {
+    options.signal?.throwIfAborted();
     const { choice, TypeSafeClient } = await import("@typesafe-ai/sdk");
+    options.signal?.throwIfAborted();
     const client = new TypeSafeClient({
         apiKey,
-        timeout: JEV_TIMEOUT_MS,
+        timeout: Math.max(1, Math.min(JEV_TIMEOUT_MS, options.timeoutMs ?? JEV_TIMEOUT_MS)),
         retry: { maxRetries: 0 },
     });
     const systemOne = client.systemOne.bind(client);
@@ -201,7 +328,7 @@ async function requestJevDirect(apiKey, request) {
         questions: {
             [Object.keys(request.questions)[0]]: choice(Object.values(request.questions)[0].instructions, Object.values(request.questions)[0].criteria),
         },
-    }));
+    }, options.signal ? { signal: options.signal } : undefined));
 }
 export async function requestJevThroughBuilder(auth, request, options = {}) {
     const controller = new AbortController();

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

@@ -4,6 +4,7 @@ import type { Task } from "../a2a/types.js";
 import { type ActionAutomationContext, type ActionCaller } from "../action.js";
 import { type ArtifactReceipt } from "../artifacts/detect.js";
 import type { AgentNativeHarnessSetting } from "../config.js";
+import { type JevPromptContextCandidate } from "../server/agent-chat/prompt-resources.js";
 import { type BuilderGatewayAuth } from "../server/credential-provider.js";
 import { fireInternalDispatch } from "../server/self-dispatch.js";
 import { type ReasoningEffort } from "../shared/reasoning-effort.js";
@@ -407,16 +408,26 @@ export interface ProductionAgentOptions {
         attachments: AgentChatAttachment[];
         references: AgentChatReference[];
         threadId?: string;
+        /** Recent visible conversation text, bounded and with tool outputs omitted. */
+        requestContext: string;
+        /** Shared deadline for optional prompt-context preloading. */
+        contextPrefetchDeadlineAt: number;
         internalContinuation?: boolean;
+        dispatchToBackground: boolean;
+        isBackgroundWorker?: boolean;
         mode: AgentExecutionMode;
     }) => void | {
         message?: string;
         displayMessage?: string;
         attachments?: AgentChatAttachment[];
+        jevPromptCandidates?: JevPromptContextCandidate[];
+        jevFallbackCandidateIds?: string[];
     } | Promise<void | {
         message?: string;
         displayMessage?: string;
         attachments?: AgentChatAttachment[];
+        jevPromptCandidates?: JevPromptContextCandidate[];
+        jevFallbackCandidateIds?: string[];
     }>;
     /**
      * Resolve the exact action registry exposed to one interactive agent-chat

package/dist/agent/production-agent.js

@@ -47,7 +47,7 @@ import { loadPriorTurnToolCallJournal } from "./engine/tool-call-journal-seed.js
 import { backfillEngineMessagesToolResults, stringifyToolUseInputForGateway, unmatchedToolResultReplayText, } from "./engine/translate-anthropic.js";
 import { EngineError } from "./engine/types.js";
 import { filterHostedHarnessToolNames, normalizeHostedHarnessRuntime, } from "./harness/hosted.js";
-import { preloadJevTools } from "./jev-tool-prefetch.js";
+import { buildRecentUserRequestContext, buildJevRequestContext, preloadJevTools, } from "./jev-tool-prefetch.js";
 import { getDefaultMaxIterations, getDefaultMaxRunInputTokens, MAX_AGENT_MAX_ITERATIONS, MIN_AGENT_MAX_ITERATIONS, normalizeMaxIterations, normalizeMaxRunInputTokens, readAgentLoopSettings, } from "./loop-settings.js";
 import { getContextWindowForModel, resolveFallbackModel, } from "./model-config.js";
 import { maybeCompactThread, buildObservationalContext, hasObservationalMemory, serializeObservationalMemoryBlock, } from "./observational-memory/index.js";
@@ -7483,10 +7483,8 @@ export function createProductionAgentHandler(options) {
         if (requestRunCtx) {
             requestRunCtx.browserTabId = requestBrowserTabId;
             requestRunCtx.chatScope = requestChatScope;
-            // Let template extraContext / system-prompt builders detect the durable
-            // background worker so they can skip heavy hang-prone enrichment (e.g. the
-            // analytics data-dictionary read) that otherwise stalls the worker before
-            // it claims its run. Set early — before the system-prompt build runs.
+            // Let app prompt hooks select bounded worker-safe enrichment. Set this
+            // before request preparation and system-prompt assembly.
             requestRunCtx.isBackgroundWorker = isBackgroundWorker;
         }
         const requestMode = body.mode === "plan" ? "plan" : "act";
@@ -7499,10 +7497,16 @@ export function createProductionAgentHandler(options) {
         let requestMessage = hasMessageText ? message : "Use the attached context.";
         let requestAttachments = Array.isArray(attachments) ? attachments : [];
         let requestDisplayMessage = displayMessage;
+        const requestContext = buildRecentUserRequestContext({
+            request: requestMessage,
+            history,
+            structuredHistory,
+        });
         // Resolve owner first so we can look up a per-owner API key. Users
         // who bring their own key use their key for this request (durable
         // across serverless cold starts via the settings table).
         const ownerEmail = await resolveAgentOwnerEmail(options, event);
+        const contextPrefetchDeadlineAt = Date.now() + 1_300;
         const preparedRequest = await options.prepareRequest?.({
             event,
             ownerEmail,
@@ -7511,9 +7515,15 @@ export function createProductionAgentHandler(options) {
             attachments: requestAttachments,
             references,
             threadId,
+            requestContext,
+            contextPrefetchDeadlineAt,
             internalContinuation: Boolean(internalContinuation),
+            dispatchToBackground,
+            isBackgroundWorker,
             mode: requestMode,
         });
+        let jevPromptCandidates = [];
+        let jevFallbackCandidateIds = [];
         if (preparedRequest) {
             if (typeof preparedRequest.message === "string" &&
                 preparedRequest.message.trim().length > 0) {
@@ -7525,7 +7535,18 @@ export function createProductionAgentHandler(options) {
             if (Array.isArray(preparedRequest.attachments)) {
                 requestAttachments = preparedRequest.attachments;
             }
+            if (Array.isArray(preparedRequest.jevPromptCandidates)) {
+                jevPromptCandidates = preparedRequest.jevPromptCandidates;
+            }
+            if (Array.isArray(preparedRequest.jevFallbackCandidateIds)) {
+                jevFallbackCandidateIds = preparedRequest.jevFallbackCandidateIds;
+            }
         }
+        const jevRequestContext = buildJevRequestContext({
+            request: requestMessage,
+            history,
+            structuredHistory,
+        });
         const requestedHostedHarness = normalizeHostedHarnessRuntime(requestHarness?.runtime);
         if (requestHarness !== undefined && !requestedHostedHarness) {
             setResponseStatus(event, 400);
@@ -8146,7 +8167,9 @@ export function createProductionAgentHandler(options) {
             : undefined;
         const [requestTools, jevContext] = await Promise.all([
             preloadJevTools({
-                request: requestMessage,
+                request: jevRequestContext,
+                skip: Boolean(internalContinuation || dispatchToBackground),
+                deadlineAt: contextPrefetchDeadlineAt,
                 apiKey: jevContextCredentials.apiKey,
                 personalApiKey: jevContextCredentials.personalApiKey,
                 builderAuth: jevContextCredentials.builderAuth,
@@ -8156,12 +8179,20 @@ export function createProductionAgentHandler(options) {
                 readOnlyOnly: requestMode === "plan",
             }),
             preloadJevContextForPrompt({
-                request: requestMessage,
+                request: jevRequestContext,
+                appId: options.appId,
+                owner: ownerEmail ?? undefined,
+                orgId: getRequestOrgId() ?? null,
                 apiKey: jevContextCredentials.apiKey,
                 personalApiKey: jevContextCredentials.personalApiKey,
                 builderAuth: jevContextCredentials.builderAuth,
                 compact: options.jevContextCompact,
                 maxChars: jevContextMaxChars,
+                contextPrefetchDeadlineAt,
+                dispatchToBackground,
+                internalContinuation: Boolean(internalContinuation),
+                candidates: jevPromptCandidates,
+                fallbackCandidateIds: jevFallbackCandidateIds,
             }),
         ]);
         if (jevContext)
@@ -8174,7 +8205,7 @@ export function createProductionAgentHandler(options) {
             ...(jevContext
                 ? await buildSystemManifestSections([
                     {
-                        label: "Jev-prefetched skills and resources",
+                        label: "Jev-prefetched context",
                         provenance: "runtime-context",
                         governance: "inherited",
                         content: jevContext,

package/dist/app-config/runtime.d.ts

@@ -1,5 +1,6 @@
 import { z } from "zod";
 export declare const runtimeConfig: z.ZodObject<{
+    backgroundJobsEnabled: z.ZodOptional<z.ZodBoolean>;
     databasePoolMax: z.ZodOptional<z.ZodNumber>;
     agentChatStreaming: z.ZodDefault<z.ZodBoolean>;
     vercelBranchUrl: z.ZodOptional<z.ZodString>;

package/dist/app-config/runtime.js

@@ -1,5 +1,9 @@
 import { z } from "zod";
 export const runtimeConfig = z.object({
+    backgroundJobsEnabled: z.boolean().optional().meta({
+        env: "RUN_BACKGROUND_JOBS",
+        doc: "Run app-owned recurring background jobs. Defaults to enabled only in production.",
+    }),
     databasePoolMax: z.number().int().positive().optional().meta({
         env: "AGENT_NATIVE_DB_POOL_MAX",
         doc: "Maximum connections in each framework database pool. Defaults vary by runtime.",

package/dist/app-config/schema.d.ts

@@ -128,6 +128,7 @@ export declare const appConfigSchema: z.ZodObject<{
         publicUploadFallback: z.ZodDefault<z.ZodBoolean>;
     }, z.core.$strip>>;
     runtime: z.ZodPrefault<z.ZodObject<{
+        backgroundJobsEnabled: z.ZodOptional<z.ZodBoolean>;
         databasePoolMax: z.ZodOptional<z.ZodNumber>;
         agentChatStreaming: z.ZodDefault<z.ZodBoolean>;
         vercelBranchUrl: z.ZodOptional<z.ZodString>;

package/dist/client/AgentSidebar.d.ts

@@ -61,6 +61,8 @@ export interface AgentSidebarProps {
     position?: "left" | "right";
     /** Whether the sidebar starts open. Default: false */
     defaultOpen?: boolean;
+    /** Disable the Cmd+I / Ctrl+I shortcut that opens chat. */
+    disableChatShortcut?: boolean;
     /** Whether to render the panel's header collapse button. Default: true. */
     showCollapseButton?: boolean;
     /** Animate the mobile overlay in a sheet-style slide transition. Default: true */
@@ -150,7 +152,7 @@ export interface AgentSidebarProps {
  * Wraps app content with a toggleable agent sidebar.
  * Use AgentToggleButton in your header to open/close it.
  */
-export declare function AgentSidebar({ children, enabled, emptyStateText, defaultMode, suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, onConnectProvider, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position, defaultOpen, showCollapseButton, animateMobile, animateDesktop, chatViewTransition, chatViewTransitionHandoff, storageKey, openStorageKey, restoreActiveThread, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning, onFullscreenRequest, onOpenSettings, onNewCliTab, onNewUiTab, renderCliTab, newTabMode, newCliTabLabel, newUiTabLabel, scope, chatHistory, toggleScopeId, isolateHistoryByScope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding, thinkingDisplay, showModelSelector, chatOnly, }: AgentSidebarProps): React.JSX.Element;
+export declare function AgentSidebar({ children, enabled, emptyStateText, defaultMode, suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, onConnectProvider, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position, defaultOpen, disableChatShortcut, showCollapseButton, animateMobile, animateDesktop, chatViewTransition, chatViewTransitionHandoff, storageKey, openStorageKey, restoreActiveThread, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning, onFullscreenRequest, onOpenSettings, onNewCliTab, onNewUiTab, renderCliTab, newTabMode, newCliTabLabel, newUiTabLabel, scope, chatHistory, toggleScopeId, isolateHistoryByScope, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding, thinkingDisplay, showModelSelector, chatOnly, }: AgentSidebarProps): React.JSX.Element;
 /**
  * Focus the agent chat composer input.
  * Opens the sidebar if closed, then focuses the text input.

package/dist/client/AgentSidebar.js

@@ -161,7 +161,7 @@ function AgentSidebarPanelSkeleton() {
  * Wraps app content with a toggleable agent sidebar.
  * Use AgentToggleButton in your header to open/close it.
  */
-export function AgentSidebar({ children, enabled = true, emptyStateText = "How can I help you?", defaultMode = "chat", suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, onConnectProvider, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position = "right", defaultOpen = false, showCollapseButton = true, animateMobile = true, animateDesktop = true, chatViewTransition = false, chatViewTransitionHandoff = false, storageKey, openStorageKey, restoreActiveThread = true, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar = true, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning = false, onFullscreenRequest, onOpenSettings, onNewCliTab, onNewUiTab, renderCliTab, newTabMode = "ui", newCliTabLabel, newUiTabLabel, scope, chatHistory, toggleScopeId, isolateHistoryByScope = false, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding = false, thinkingDisplay, showModelSelector, chatOnly = true, }) {
+export function AgentSidebar({ children, enabled = true, emptyStateText = "How can I help you?", defaultMode = "chat", suggestions, dynamicSuggestions, composerToolbarSlot, composerSlot, onComposerTextChange, imageModelMenu, availableAgents, availableModels, modelListLoading, selectedAgent, onAgentChange, onConnectLocalRuntime, onConnectProvider, runtime, adapterReloadKey, threadFooterSlot, defaultSidebarWidth, sidebarWidth, position, defaultOpen, disableChatShortcut = false, showCollapseButton = true, animateMobile = true, animateDesktop = true, chatViewTransition = false, chatViewTransitionHandoff = false, storageKey, openStorageKey, restoreActiveThread = true, apiUrl, agentChatSurface, desktopIdentityUnauthenticated, desktopIdentityAuthenticated, showTabBar = true, suppressInlineOpenApp, composerPlaceholder, openOnChatRunning = false, onFullscreenRequest, onOpenSettings, onNewCliTab, onNewUiTab, renderCliTab, newTabMode = "ui", newCliTabLabel, newUiTabLabel, scope, chatHistory, toggleScopeId, isolateHistoryByScope = false, showScopeBadge, browserTabId, threadUrlSync, agentPageHref, suppressFirstRunOnboarding = false, thinkingDisplay, showModelSelector, chatOnly = true, }) {
     const resolvedBrowserTabId = browserTabId ??
         (typeof window === "undefined" ? undefined : getBrowserTabId());
     const staticHostedHarnessEnabled = isHostedHarnessConfigured(injectedAgentNativeConfig().harness);
@@ -192,8 +192,8 @@ export function AgentSidebar({ children, enabled = true, emptyStateText = "How c
             onAgentChange?.(agent);
         }
         : onAgentChange;
-    const effectivePosition = hostedHarnessUi ? "left" : position;
-    const effectiveDefaultOpen = hostedHarnessUi || defaultOpen;
+    const effectivePosition = position ?? (hostedHarnessUi ? "left" : "right");
+    const effectiveDefaultOpen = defaultOpen ?? hostedHarnessUi;
     const effectiveShowTabBar = hostedHarnessUi || showTabBar;
     const effectiveAnimateDesktop = hostedHarnessUi ? false : animateDesktop;
     const sidebarOpenStorageKey = openStorageKey ?? storageKey;
@@ -305,10 +305,6 @@ export function AgentSidebar({ children, enabled = true, emptyStateText = "How c
         hostedHarnessRuntime,
         hostedHarnessStorageKey,
     ]);
-    useEffect(() => {
-        if (hostedHarnessUi)
-            setOpenPersisted(true);
-    }, [hostedHarnessUi, setOpenPersisted]);
     const applyUrlOpenOverride = useCallback(() => {
         const override = consumeAgentSidebarUrlOpenOverride(sidebarOpenStorageKey);
         if (override !== null)
@@ -596,8 +592,8 @@ export function AgentSidebar({ children, enabled = true, emptyStateText = "How c
         window.addEventListener("message", handleMessage);
         return () => window.removeEventListener("message", handleMessage);
     }, [setOpenPersisted]);
-    // Cmd+\ / Ctrl+\ toggles the agent sidebar globally. Cmd+I / Ctrl+I focuses
-    // chat and attaches selected page text as one-shot context for the next turn.
+    // Cmd+\ / Ctrl+\ toggles globally; Cmd+I / Ctrl+I can focus chat and attach
+    // selected page text as one-shot context for the next turn.
     useEffect(() => {
         const handleKeyDown = (e) => {
             if ((e.metaKey || e.ctrlKey) &&
@@ -608,7 +604,7 @@ export function AgentSidebar({ children, enabled = true, emptyStateText = "How c
                 window.dispatchEvent(new CustomEvent("agent-panel:toggle", { detail: { focus: true } }));
                 return;
             }
-            if ((e.metaKey || e.ctrlKey) && e.key === "i") {
+            if (!disableChatShortcut && (e.metaKey || e.ctrlKey) && e.key === "i") {
                 if (!shouldHandleAgentPanelChatShortcut(e.target))
                     return;
                 e.preventDefault();
@@ -638,7 +634,7 @@ export function AgentSidebar({ children, enabled = true, emptyStateText = "How c
         };
         document.addEventListener("keydown", handleKeyDown);
         return () => document.removeEventListener("keydown", handleKeyDown);
-    }, []);
+    }, [disableChatShortcut]);
     // Hide sidebar during presentation mode
     useEffect(() => {
         const handler = (event) => {
@@ -847,7 +843,7 @@ export function AgentSidebar({ children, enabled = true, emptyStateText = "How c
                         !isPerAppChatHosted &&
                         !presentationMode &&
                         enabled &&
-                        (mobileAnimationEnabled ? shouldRenderPanel : open) && (_jsx("div", { className: cn("agent-sidebar-backdrop fixed inset-0 bg-foreground/40", mobileAnimationEnabled && !panelOpen && "pointer-events-none"), "data-agent-sidebar-animation": mobileAnimationEnabled ? "mobile" : undefined, "data-agent-sidebar-state": panelOpen ? "open" : "closed", style: { zIndex: SIDEBAR_OVERLAY_Z_INDEX - 1 }, onClick: () => setOpenPersisted(false) })), shouldMountPanel ? (_jsx(URLSync, { browserTabId: resolvedBrowserTabId })) : null, isResizing ? (_jsx("div", { "aria-hidden": "true", className: "agent-sidebar-resize-overlay" })) : null, isLeft && !presentationMode ? sidebar : null, isLeft && !presentationMode ? drawerPlaceholder : null, _jsx("div", { className: "agent-sidebar-main-surface flex flex-1 flex-col overflow-auto min-w-0", "data-agent-sidebar-main-position": position, "data-agent-sidebar-main-state": !isMobile && !presentationMode && panelOpen ? "open" : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: _jsx(ScreenRefreshBoundary, { children: children }) }), !isLeft && !presentationMode ? drawerPlaceholder : null, !isLeft && !presentationMode ? sidebar : null] })] }));
+                        (mobileAnimationEnabled ? shouldRenderPanel : open) && (_jsx("div", { className: cn("agent-sidebar-backdrop fixed inset-0 bg-foreground/40", mobileAnimationEnabled && !panelOpen && "pointer-events-none"), "data-agent-sidebar-animation": mobileAnimationEnabled ? "mobile" : undefined, "data-agent-sidebar-state": panelOpen ? "open" : "closed", style: { zIndex: SIDEBAR_OVERLAY_Z_INDEX - 1 }, onClick: () => setOpenPersisted(false) })), shouldMountPanel ? (_jsx(URLSync, { browserTabId: resolvedBrowserTabId })) : null, isResizing ? (_jsx("div", { "aria-hidden": "true", className: "agent-sidebar-resize-overlay" })) : null, isLeft && !presentationMode ? sidebar : null, isLeft && !presentationMode ? drawerPlaceholder : null, _jsx("div", { className: "agent-sidebar-main-surface flex flex-1 flex-col overflow-auto min-w-0", "data-agent-sidebar-main-position": effectivePosition, "data-agent-sidebar-main-state": !isMobile && !presentationMode && panelOpen ? "open" : "closed", "data-agent-sidebar-resizing": isResizing ? "true" : undefined, children: _jsx(ScreenRefreshBoundary, { children: children }) }), !isLeft && !presentationMode ? drawerPlaceholder : null, !isLeft && !presentationMode ? sidebar : null] })] }));
 }
 /**
  * Focus the agent chat composer input.

package/dist/client/analytics/index.d.ts

@@ -1,2 +1,2 @@
-export { AGENT_NATIVE_EXCEPTION_EVENT_NAME, addErrorBreadcrumb, captureClientException, captureError, captureException, captureMessage, clearAnalyticsSessionId, configureTracking, getAnalyticsAnonymousId, getAnalyticsSessionId, getFirstTouchAttribution, getSessionReplayContext, getSessionReplayUrl, isErrorCaptureInstalled, maybeStartSessionReplay, setAnalyticsSessionId, setSentryUser, setTrackingContentCaptureEnabled, setTrackingIdentity, startSessionReplay, stopSessionReplay, trackAgentChatLifecycle, trackEvent, trackLifecycleEvent, trackSessionStatus, type AgentChatLifecycleEvent, type CaptureExceptionContext, type CapturedExceptionEvent, type ClientCaptureContext, type ConfigureTrackingOptions, type ErrorCaptureConfigOptions, type ExceptionBreadcrumb, type ExceptionLevel, type FirstTouchAttribution, type SessionReplayContext, type SessionReplayLinkOptions, type SessionReplayOptions, type SessionReplayStartResult, type SessionReplayUrlMatcher, type TrackingIdentityUser, } from "../analytics.js";
+export { AGENT_NATIVE_EXCEPTION_EVENT_NAME, addErrorBreadcrumb, captureClientException, captureError, captureException, captureMessage, clearAnalyticsSessionId, configureTracking, getAnalyticsAnonymousId, getAnalyticsSessionId, getFirstTouchAttribution, getSessionReplayContext, getSessionReplayUrl, isErrorCaptureInstalled, maybeStartSessionReplay, setAnalyticsSessionId, setSentryUser, setTrackingContentCaptureEnabled, setTrackingIdentity, startSessionReplay, stopSessionReplay, trackAgentChatLifecycle, trackAnonymousEvent, trackEvent, trackLifecycleEvent, trackSessionStatus, type AgentChatLifecycleEvent, type CaptureExceptionContext, type CapturedExceptionEvent, type ClientCaptureContext, type ConfigureTrackingOptions, type ErrorCaptureConfigOptions, type ExceptionBreadcrumb, type ExceptionLevel, type FirstTouchAttribution, type SessionReplayContext, type SessionReplayLinkOptions, type SessionReplayOptions, type SessionReplayStartResult, type SessionReplayUrlMatcher, type TrackingIdentityUser, } from "../analytics.js";
 export { track } from "../track.js";