@agent-native/core 0.219.0 → 0.220.0-nightly-20261023212848

package/dist/chat-threads/store.d.ts

@@ -53,6 +53,7 @@ export interface ChatThread {
     updatedAt: number;
     scope: ChatThreadScope | null;
     pinnedAt: number | null;
+    hiddenAt?: number | null;
     archivedAt: number | null;
     source: ChatThreadSource | null;
     orgId: string | null;
@@ -83,6 +84,7 @@ export interface ChatThreadSummary {
     updatedAt: number;
     scope: ChatThreadScope | null;
     pinnedAt: number | null;
+    hiddenAt?: number | null;
     archivedAt: number | null;
     source: ChatThreadSource | null;
     orgId: string | null;
@@ -164,6 +166,8 @@ export interface ListThreadsOptions {
      * (e.g. an "Archived" filter or restoring one via `setThreadArchived`).
      */
     includeArchived?: boolean;
+    /** Include chats hidden by this caller. Defaults to false. */
+    includeHidden?: boolean;
     /**
      * Include connected and other-app threads. The HTTP chat list defaults this
      * to false so each app shows its own local chats first; internal callers
@@ -184,6 +188,8 @@ export declare function searchThreads(ownerEmail: string, query: string, limit?:
     orgId?: string | null;
     /** See `ListThreadsOptions.includeArchived` — defaults to false. */
     includeArchived?: boolean;
+    /** Include chats hidden by this caller. Defaults to false. */
+    includeHidden?: boolean;
     /** See `ListThreadsOptions.includeExternal`. */
     includeExternal?: boolean;
     /** Current app id used by the local-only view. */
@@ -211,19 +217,30 @@ export declare function adoptThreadScopeIfUnscoped(id: string, ownerEmail: strin
  * `null` to clear the scope (chat becomes general).
  */
 export declare function setThreadScope(id: string, ownerEmail: string, scope: ChatThreadScope | null): Promise<void>;
-export declare function renameThread(id: string, title: string, options?: {
-    ownerEmail?: string;
+export declare function assertThreadOwner(thread: Pick<ChatThread, "ownerEmail">, ownerEmail: string): void;
+export declare function renameThread(id: string, title: string, options: {
+    ownerEmail: string;
 }): Promise<boolean>;
-export declare function setThreadPinned(id: string, pinned: boolean, options?: {
-    ownerEmail?: string;
+export declare function setThreadPinned(id: string, pinned: boolean, options: {
+    ownerEmail: string;
+    orgId?: string | null;
 }): Promise<boolean>;
-export declare function setThreadArchived(id: string, archived: boolean, options?: {
-    ownerEmail?: string;
+export declare function setThreadHidden(id: string, hidden: boolean, options: {
+    ownerEmail: string;
+    orgId?: string | null;
+}): Promise<boolean>;
+export declare function setThreadArchived(id: string, archived: boolean, options: {
+    ownerEmail: string;
 }): Promise<boolean>;
 export interface UpdateThreadDataOptions {
     preserveExistingQueuedMessages?: boolean;
     preserveExistingTopLevelKeys?: boolean;
     preserveCurrentMetadata?: boolean;
+    /**
+     * Preserve the title and its override from each current CAS revision; a
+     * blank title still fills from the merged visible prompts.
+     */
+    preserveCurrentTitle?: boolean;
     preserveCurrentTitleAndPreview?: boolean;
     trustedRunSequenceResetIds?: ReadonlySet<string>;
     onAnnotationConflict?: (conflict: ThreadAnnotationSnapshotConflict) => void;

package/dist/chat-threads/store.js

@@ -13,7 +13,7 @@ import { fromMigrationEntries } from "../db/versioned-store-migrations.js";
 import { widenIntColumnsToBigInt } from "../db/widen-columns.js";
 import { getRequestOrgId } from "../server/request-context.js";
 import { assertNoInlineImageBytes, stripInlineBytes, } from "../shared/inline-bytes.js";
-import { hasCurrentOrgMembership, resolveAccess, } from "../sharing/access.js";
+import { ForbiddenError, hasCurrentOrgMembership, resolveAccess, } from "../sharing/access.js";
 import { registerShareableResource } from "../sharing/registry.js";
 import { roleSatisfies } from "../sharing/schema.js";
 import { emitChatThreadChange } from "./emitter.js";
@@ -161,6 +161,17 @@ export const chatThreadsStore = defineStore({
             },
         },
         ...fromMigrationEntries(CHAT_THREAD_SCHEMA_MIGRATIONS_TABLE, CHAT_THREAD_SCHEMA_MIGRATIONS, { data: [3] }),
+        {
+            name: "viewer-state",
+            sql: `CREATE TABLE IF NOT EXISTS chat_thread_viewer_state (
+        thread_id TEXT NOT NULL REFERENCES chat_threads(id) ON DELETE CASCADE,
+        user_email TEXT NOT NULL,
+        pinned_at BIGINT,
+        hidden_at BIGINT,
+        updated_at BIGINT NOT NULL,
+        PRIMARY KEY (thread_id, user_email)
+      )`,
+        },
     ],
 });
 function ensureTable() {
@@ -632,6 +643,7 @@ function rowToThread(r) {
         updatedAt: Number(r.updated_at),
         scope: readScope(r),
         pinnedAt: readNullableNumber(r.pinned_at),
+        hiddenAt: readNullableNumber(r.hidden_at),
         archivedAt: readNullableNumber(r.archived_at),
         source: readSource(r),
         orgId: r.org_id ?? null,
@@ -662,6 +674,7 @@ function rowToSummary(r) {
         updatedAt: Number(r.updated_at),
         scope: readScope(r),
         pinnedAt: readNullableNumber(r.pinned_at),
+        hiddenAt: readNullableNumber(r.hidden_at),
         archivedAt: readNullableNumber(r.archived_at),
         source: readSource(r),
         orgId: r.org_id ?? null,
@@ -765,7 +778,21 @@ export async function resolveThreadAccess(userEmail, threadId, minRole = "viewer
         return null;
     if (!(await hasThreadAccess(userEmail, threadId, minRole, ctx)))
         return null;
-    return await getThread(threadId);
+    const thread = await getThread(threadId);
+    if (!thread)
+        return null;
+    if (normalizeAccessEmail(thread.ownerEmail) === normalizeAccessEmail(userEmail)) {
+        return { ...thread, hiddenAt: null };
+    }
+    const { rows } = await getDbExec().execute({
+        sql: `SELECT pinned_at, hidden_at FROM chat_thread_viewer_state WHERE thread_id = ? AND user_email = ?`,
+        args: [threadId, normalizeAccessEmail(userEmail)],
+    });
+    return {
+        ...thread,
+        pinnedAt: readNullableNumber(rows[0]?.pinned_at),
+        hiddenAt: readNullableNumber(rows[0]?.hidden_at),
+    };
 }
 export async function resolveThreadAccessScope(userEmail, threadId, minRole = "viewer", ctx = {}) {
     if (!userEmail || !threadId)
@@ -792,9 +819,10 @@ export async function resolveThreadsAccess(userEmail, threadIds, ctx = {}) {
     const access = await chatThreadAccessSql(userEmail, ctx.orgId);
     const client = getDbExec();
     const placeholders = ids.map(() => "?").join(", ");
+    const projection = chatThreadViewerSelect(THREAD_COLUMNS, userEmail);
     const { rows } = await client.execute({
-        sql: `SELECT ${THREAD_COLUMNS} FROM chat_threads WHERE id IN (${placeholders}) AND ${access.sql}`,
-        args: [...ids, ...access.args],
+        sql: `SELECT ${projection.sql} FROM chat_threads WHERE id IN (${placeholders}) AND ${access.sql}`,
+        args: [...projection.args, ...ids, ...access.args],
     });
     for (const row of rows) {
         const thread = rowToThread(row);
@@ -948,6 +976,14 @@ async function chatThreadAccessSql(userEmail, orgId) {
 function normalizeAccessEmail(userEmail) {
     return userEmail.trim().toLowerCase();
 }
+function chatThreadViewerSelect(columns, userEmail) {
+    const email = normalizeAccessEmail(userEmail);
+    const viewerValue = (column) => `(SELECT ${column} FROM chat_thread_viewer_state WHERE thread_id = chat_threads.id AND user_email = ?)`;
+    return {
+        sql: `${columns.replace("pinned_at", `CASE WHEN LOWER(owner_email) = ? THEN pinned_at ELSE ${viewerValue("pinned_at")} END AS pinned_at`)}, CASE WHEN LOWER(owner_email) = ? THEN NULL ELSE ${viewerValue("hidden_at")} END AS hidden_at`,
+        args: [email, email, email, email],
+    };
+}
 /**
  * Summary projection plus the caller's access basis, derived from the same
  * owner and per-user-share comparisons the ACL uses. Anything that is neither
@@ -955,9 +991,10 @@ function normalizeAccessEmail(userEmail) {
  */
 function chatThreadSummarySelect(userEmail) {
     const normalizedEmail = normalizeAccessEmail(userEmail);
+    const viewer = chatThreadViewerSelect(SUMMARY_COLUMNS, userEmail);
     return {
-        sql: `${SUMMARY_COLUMNS}, CASE WHEN LOWER(owner_email) = ? THEN 'owner' WHEN EXISTS (SELECT 1 FROM chat_thread_shares WHERE chat_thread_shares.resource_id = chat_threads.id AND chat_thread_shares.principal_type = 'user' AND LOWER(chat_thread_shares.principal_id) = ?) THEN 'direct' ELSE 'organization' END AS access_basis`,
-        args: [normalizedEmail, normalizedEmail],
+        sql: `${viewer.sql}, CASE WHEN LOWER(owner_email) = ? THEN 'owner' WHEN EXISTS (SELECT 1 FROM chat_thread_shares WHERE chat_thread_shares.resource_id = chat_threads.id AND chat_thread_shares.principal_type = 'user' AND LOWER(chat_thread_shares.principal_id) = ?) THEN 'direct' ELSE 'organization' END AS access_basis`,
+        args: [...viewer.args, normalizedEmail, normalizedEmail],
     };
 }
 function chatThreadOwnershipSql(userEmail, ownership) {
@@ -996,6 +1033,10 @@ export async function listThreads(ownerEmail, options = {}, legacyOffset) {
         filters.push(ownershipFilter.sql);
         args.push(...ownershipFilter.args);
     }
+    if (!opts.includeHidden) {
+        filters.push(`(LOWER(owner_email) = ? OR NOT EXISTS (SELECT 1 FROM chat_thread_viewer_state WHERE thread_id = chat_threads.id AND user_email = ? AND hidden_at IS NOT NULL))`);
+        args.push(normalizeAccessEmail(ownerEmail), normalizeAccessEmail(ownerEmail));
+    }
     if (!opts.includeArchived) {
         filters.push(`archived_at IS NULL`);
     }
@@ -1015,7 +1056,7 @@ export async function listThreads(ownerEmail, options = {}, legacyOffset) {
     }
     args.push(limit, offset);
     const { rows } = await client.execute({
-        sql: `SELECT ${select.sql} FROM chat_threads WHERE ${filters.join(" AND ")} ORDER BY CASE WHEN pinned_at IS NULL THEN 1 ELSE 0 END, pinned_at DESC, updated_at DESC, id ASC LIMIT ? OFFSET ?`,
+        sql: `SELECT ${select.sql} FROM chat_threads WHERE ${filters.join(" AND ")} ORDER BY pinned_at DESC NULLS LAST, updated_at DESC, id ASC LIMIT ? OFFSET ?`,
         args,
     });
     return rows
@@ -1051,6 +1092,10 @@ export async function searchThreads(ownerEmail, query, limit = 50, options = {})
         filters.push(ownershipFilter.sql);
         args.push(...ownershipFilter.args);
     }
+    if (!options.includeHidden) {
+        filters.push(`(LOWER(owner_email) = ? OR NOT EXISTS (SELECT 1 FROM chat_thread_viewer_state WHERE thread_id = chat_threads.id AND user_email = ? AND hidden_at IS NOT NULL))`);
+        args.push(normalizeAccessEmail(ownerEmail), normalizeAccessEmail(ownerEmail));
+    }
     if (!options.includeArchived) {
         filters.push(`archived_at IS NULL`);
     }
@@ -1067,7 +1112,7 @@ export async function searchThreads(ownerEmail, query, limit = 50, options = {})
     }
     args.push(limit, options.offset ?? 0);
     const { rows } = await client.execute({
-        sql: `SELECT ${select.sql} FROM chat_threads WHERE ${filters.join(" AND ")} ORDER BY CASE WHEN pinned_at IS NULL THEN 1 ELSE 0 END, pinned_at DESC, updated_at DESC, id ASC LIMIT ? OFFSET ?`,
+        sql: `SELECT ${select.sql} FROM chat_threads WHERE ${filters.join(" AND ")} ORDER BY pinned_at DESC NULLS LAST, updated_at DESC, id ASC LIMIT ? OFFSET ?`,
         args,
     });
     return rows
@@ -1131,61 +1176,90 @@ export async function setThreadScope(id, ownerEmail, scope) {
     });
     emitChatThreadChange(id);
 }
-export async function renameThread(id, title, options = {}) {
+export function assertThreadOwner(thread, ownerEmail) {
+    if (!ownerEmail?.trim() ||
+        thread.ownerEmail.toLowerCase() !== ownerEmail.trim().toLowerCase()) {
+        throw new ForbiddenError();
+    }
+}
+async function getOwnedThread(id, ownerEmail) {
+    const thread = await getThread(id);
+    if (thread)
+        assertThreadOwner(thread, ownerEmail);
+    return thread;
+}
+export async function renameThread(id, title, options) {
     const nextTitle = normalizeThreadTitle(title);
     if (!nextTitle)
         return false;
     return await withThreadDataLock(id, async () => {
-        const thread = await getThread(id);
+        const thread = await getOwnedThread(id, options.ownerEmail);
         if (!thread)
             return false;
-        if (options.ownerEmail && thread.ownerEmail !== options.ownerEmail) {
-            return false;
-        }
         const repo = parseThreadData(thread.threadData);
         repo._titleOverride = nextTitle;
-        await updateThreadData(id, JSON.stringify(repo), nextTitle, thread.preview, thread.messageCount);
-        return true;
+        return await updateThreadData(id, JSON.stringify(repo), nextTitle, thread.preview, thread.messageCount);
     });
 }
-export async function setThreadPinned(id, pinned, options = {}) {
+async function setThreadViewerState(id, field, enabled, options) {
+    const email = normalizeAccessEmail(options.ownerEmail);
+    const { rows } = await getDbExec().execute({
+        sql: `SELECT id, owner_email FROM chat_threads WHERE id = ?`,
+        args: [id],
+    });
+    const thread = rows[0];
+    if (!thread)
+        return false;
+    if (!email || normalizeAccessEmail(String(thread.owner_email)) === email) {
+        throw new ForbiddenError();
+    }
+    if (!(await hasThreadAccess(email, id, "viewer", {
+        orgId: (options.orgId === undefined ? getRequestOrgId() : options.orgId) ??
+            undefined,
+    }))) {
+        throw new ForbiddenError();
+    }
+    const now = Math.max(Date.now(), 1);
+    await getDbExec().execute({
+        sql: `INSERT INTO chat_thread_viewer_state (thread_id, user_email, ${field}, updated_at)
+          VALUES (?, ?, ?, ?)
+          ON CONFLICT (thread_id, user_email) DO UPDATE SET ${field} = EXCLUDED.${field}, updated_at = EXCLUDED.updated_at`,
+        args: [id, email, enabled ? now : null, now],
+    });
+    emitChatThreadChange(id);
+    return true;
+}
+export async function setThreadPinned(id, pinned, options) {
     await ensureTable();
     const client = getDbExec();
     const now = Math.max(Date.now(), 1);
-    const args = [pinned ? now : null, id];
-    let ownerFilter = "";
-    if (options.ownerEmail) {
-        ownerFilter = " AND owner_email = ?";
-        args.push(options.ownerEmail);
-    }
     const result = await client.execute({
-        sql: `UPDATE chat_threads SET pinned_at = ? WHERE id = ?${ownerFilter}`,
-        args,
+        sql: `UPDATE chat_threads SET pinned_at = ? WHERE id = ? AND LOWER(owner_email) = LOWER(?)`,
+        args: [pinned ? now : null, id, options.ownerEmail.trim()],
     });
     if (result.rowsAffected > 0) {
         emitChatThreadChange(id);
         return true;
     }
-    return false;
+    return setThreadViewerState(id, "pinned_at", pinned, options);
 }
-export async function setThreadArchived(id, archived, options = {}) {
+export async function setThreadHidden(id, hidden, options) {
+    await ensureTable();
+    return setThreadViewerState(id, "hidden_at", hidden, options);
+}
+export async function setThreadArchived(id, archived, options) {
     await ensureTable();
     const client = getDbExec();
     const now = Math.max(Date.now(), 1);
-    const args = [archived ? now : null, id];
-    let ownerFilter = "";
-    if (options.ownerEmail) {
-        ownerFilter = " AND owner_email = ?";
-        args.push(options.ownerEmail);
-    }
     const result = await client.execute({
-        sql: `UPDATE chat_threads SET archived_at = ? WHERE id = ?${ownerFilter}`,
-        args,
+        sql: `UPDATE chat_threads SET archived_at = ? WHERE id = ? AND LOWER(owner_email) = LOWER(?)`,
+        args: [archived ? now : null, id, options.ownerEmail.trim()],
     });
     if (result.rowsAffected > 0) {
         emitChatThreadChange(id);
         return true;
     }
+    await getOwnedThread(id, options.ownerEmail);
     return false;
 }
 export class InlineAttachmentDataNotPersistableError extends Error {
@@ -1238,6 +1312,14 @@ export async function updateThreadData(id, threadData, title, preview, messageCo
                 trustedRunSequenceResetIds: options.trustedRunSequenceResetIds,
                 onAnnotationConflict: (conflict) => annotationConflicts.push(conflict),
             });
+            if (options.preserveCurrentTitle) {
+                if (Object.prototype.hasOwnProperty.call(safeCurrentThreadData, "_titleOverride")) {
+                    merged._titleOverride = safeCurrentThreadData._titleOverride;
+                }
+                else {
+                    delete merged._titleOverride;
+                }
+            }
             // Client snapshots can predate their upload URL, so inline bytes become a
             // visible placeholder rather than failing the save; legacy rows are
             // scrubbed on their next write.
@@ -1251,13 +1333,14 @@ export async function updateThreadData(id, threadData, title, preview, messageCo
             const preserveCurrentMetadata = options.preserveCurrentMetadata;
             const preserveCurrentTitleAndPreview = options.preserveCurrentTitleAndPreview;
             const snapshotMetaForBlankFields = !options.preserveCurrentMetadata &&
-                options.preserveCurrentTitleAndPreview &&
+                (options.preserveCurrentTitleAndPreview ||
+                    options.preserveCurrentTitle) &&
                 (!current.title.trim() || !current.preview.trim())
                 ? extractThreadMeta(merged)
                 : undefined;
             const nextTitle = preserveCurrentMetadata
                 ? current.title
-                : preserveCurrentTitleAndPreview
+                : preserveCurrentTitleAndPreview || options.preserveCurrentTitle
                     ? current.title.trim()
                         ? current.title
                         : snapshotMetaForBlankFields?.title || current.title

package/dist/cli/amplify-stream.js

@@ -403,7 +403,7 @@ const FUNCTION_URL_CORS = JSON.stringify({
     ],
     AllowMethods: ["POST"],
     AllowOrigins: ["*"],
-    ExposeHeaders: ["x-dispatch-mode", "x-run-id"],
+    ExposeHeaders: ["x-dispatch-mode", "x-run-id", "x-turn-id"],
     MaxAge: 600,
 });
 const FUNCTION_URL_PERMISSIONS = [

package/dist/client/agent-chat/index.d.ts

@@ -20,7 +20,7 @@ export { buildDynamicAgentSuggestions, dedupeSuggestions, mergeAgentSuggestions,
 export { clearChatStorage } from "../chat/storage.js";
 export { isAssistantChatHistoryVersion, coerceAssistantChatHistoryDate, type AssistantChatHistoryDate, type AssistantChatHistoryVersion, } from "../chat/assistant-chat-history-version.js";
 export { ChatThreadListConfigError, useChatThreadList, type UseChatThreadListOptions, type UseChatThreadListResult, type ChatThreadListRefreshOutcome, } from "../use-chat-thread-list.js";
-export { ChatThreadListError, fetchChatThreadListPage, notifyChatThreadsUpdated, useChatThreads, type ChatThreadAccessBasis, type ChatThreadListPage, type ChatThreadListRow, type ChatThreadListPageRequest, type ChatThreadOwnership, type ChatThreadVisibility, type ChatThreadScope, type ChatThreadSnapshot, type ChatThreadSummary, type ChatThreadData, type ChatThreadShareLink, type ChatThreadShareState, type UseChatThreadsOptions, } from "../use-chat-threads.js";
+export { ChatThreadListError, ChatThreadMutationError, hideChatThread, fetchChatThreadListPage, notifyChatThreadsUpdated, useChatThreads, type ChatThreadAccessBasis, type ChatThreadListPage, type ChatThreadListRow, type ChatThreadListPageRequest, type ChatThreadOwnership, type ChatThreadVisibility, type ChatThreadScope, type ChatThreadSnapshot, type ChatThreadSummary, type ChatThreadData, type ChatThreadShareLink, type ChatThreadShareState, type UseChatThreadsOptions, } from "../use-chat-threads.js";
 export { type AgentCallProgress, type ContentPart, } from "../sse-event-processor.js";
 export { useRunStuckDetection, useAbortRun, type RunStuckState, type UseRunStuckDetectionOptions, } from "../use-run-stuck-detection.js";
 export { AGENT_CHAT_HOME_HANDOFF_TTL_MS, AGENT_CHAT_VIEW_TRANSITION_CLASS, AGENT_CHAT_VIEW_TRANSITION_NAME, consumeAgentChatHomeHandoff, getAgentChatViewTransitionStyle, isAgentChatHomeHandoffActive, markAgentChatHomeHandoff, navigateWithAgentChatViewTransition, startAgentChatViewTransition, supportsAgentChatViewTransition, type AgentChatHomeHandoffOptions, type AgentChatViewTransition, type AgentChatViewTransitionOptions, } from "../chat-view-transition.js";
@@ -28,6 +28,7 @@ export { useAgentChatHomeHandoff, useAgentChatHomeHandoffLinks, type UseAgentCha
 export { AGENT_SIDEBAR_DEFAULT_MAX_WIDTH, AGENT_SIDEBAR_MIN_WIDTH, AGENT_SIDEBAR_WIDE_WIDTH_RATIO, clampAgentSidebarWidth, consumeAgentSidebarUrlOpenOverride, getAgentSidebarMaxWidth, getAgentSidebarWideWidth, dispatchAgentSidebarStateChange, getInitialAgentSidebarOpen, requestAgentSidebarOpen, subscribeAgentSidebarUrlChanges, SIDEBAR_STATE_CHANGE_EVENT, setAgentSidebarOpenPreference, type AgentSidebarStateChangeDetail, type AgentSidebarStateMode, type AgentSidebarStateSource, } from "../agent-sidebar-state.js";
 export * from "../chat/agentkit-protocol.js";
 export { createAgentNativeAgentKitTransport, type CreateAgentNativeAgentKitTransportOptions, } from "../chat/agentkit-agent-native.js";
+export { trackTurnSubmitted } from "../chat/turn-submitted-telemetry.js";
 export { AGENT_CHAT_RUNNING_EVENT, dispatchAgentChatRunning, resolveAgentChatRunningThreadId, useAgentChatRunningThreads, type AgentChatPresentationPhase, type AgentChatRunningEventDetail, type AgentChatRunningThreadsState, type UseAgentChatRunningThreadsOptions, } from "../use-agent-chat-running-threads.js";
 export { CHAT_FIRST_APP_LAYOUT_STORAGE_KEY, CHAT_FIRST_DEFAULT_APP_IDS, CHAT_FIRST_SURFACE_TABS_STORAGE_KEY, CHAT_FIRST_SURFACE_PANEL_STORAGE_KEY, CHAT_FIRST_SURFACE_WIDTH_DEFAULT, CHAT_FIRST_SURFACE_WIDTH_MIN, clampChatFirstSurfaceWidth, CHAT_FIRST_MODE_STORAGE_KEY, CHAT_FIRST_MODE_CHANGED_EVENT, CHAT_FIRST_OPEN_APP_EVENT, CHAT_FIRST_OPEN_BROWSER_EVENT, CHAT_FIRST_WATCH_SESSION_EVENT, CHAT_FIRST_SURFACE_CATALOG, chatFirstSurfaceTabId, closeChatFirstSessionWatch, emitChatFirstOpenApp, emitChatFirstOpenBrowser, emitChatFirstSessionWatch, getChatFirstSessionWatchStore, getChatFirstSurfaceTabsStore, getChatFirstSurfacePanelStore, orderChatFirstAppIds, readChatFirstAppLayout, resolveChatFirstAppTarget, resolveChatFirstBrowserTarget, resolveChatFirstSessionId, normalizeChatFirstSessionReference, readChatFirstMode, readChatFirstModeState, readChatFirstSurfaceWidth, subscribeChatFirstOpenApp, subscribeChatFirstOpenBrowser, subscribeChatFirstSessionWatch, useChatFirstSessionWatch, useChatFirstSurfaceResize, useChatFirstSurfacePanel, useChatFirstSurfaceTabs, writeChatFirstAppLayout, writeChatFirstMode, writeChatFirstSurfaceWidth, type ChatFirstAppLayoutPreference, type ChatFirstModeReadResult, type ChatFirstAppRegistration, type ChatFirstAppResolution, type ChatFirstAppTarget, type ChatFirstAppSurfacePlacement, type ChatFirstAgentActivity, type ChatFirstAgentActivityStatus, type ChatFirstOpenAppDelivery, type ChatFirstOpenAppDetail, type ChatFirstOpenBrowserDetail, type ChatFirstBrowserResolution, type ChatFirstSessionKind, type ChatFirstSessionReference, type ChatFirstSessionWatchDelivery, type ChatFirstSessionWatchState, type ChatFirstSessionWatchStore, type ChatFirstSurfaceKind, type ChatFirstSurfaceTab, type ChatFirstSurfacePanelState, type ChatFirstSurfacePanelStore, type ChatFirstSurfaceTabsState, type ChatFirstSurfaceTabsStore, } from "../chat-first-state.js";
 export { useVoiceProviderStatus } from "../voice-provider-status.js";

package/dist/client/agent-chat/index.js

@@ -20,13 +20,14 @@ export { buildDynamicAgentSuggestions, dedupeSuggestions, mergeAgentSuggestions,
 export { clearChatStorage } from "../chat/storage.js";
 export { isAssistantChatHistoryVersion, coerceAssistantChatHistoryDate, } from "../chat/assistant-chat-history-version.js";
 export { ChatThreadListConfigError, useChatThreadList, } from "../use-chat-thread-list.js";
-export { ChatThreadListError, fetchChatThreadListPage, notifyChatThreadsUpdated, useChatThreads, } from "../use-chat-threads.js";
+export { ChatThreadListError, ChatThreadMutationError, hideChatThread, fetchChatThreadListPage, notifyChatThreadsUpdated, useChatThreads, } from "../use-chat-threads.js";
 export { useRunStuckDetection, useAbortRun, } from "../use-run-stuck-detection.js";
 export { AGENT_CHAT_HOME_HANDOFF_TTL_MS, AGENT_CHAT_VIEW_TRANSITION_CLASS, AGENT_CHAT_VIEW_TRANSITION_NAME, consumeAgentChatHomeHandoff, getAgentChatViewTransitionStyle, isAgentChatHomeHandoffActive, markAgentChatHomeHandoff, navigateWithAgentChatViewTransition, startAgentChatViewTransition, supportsAgentChatViewTransition, } from "../chat-view-transition.js";
 export { useAgentChatHomeHandoff, useAgentChatHomeHandoffLinks, } from "../use-agent-chat-home-handoff.js";
 export { AGENT_SIDEBAR_DEFAULT_MAX_WIDTH, AGENT_SIDEBAR_MIN_WIDTH, AGENT_SIDEBAR_WIDE_WIDTH_RATIO, clampAgentSidebarWidth, consumeAgentSidebarUrlOpenOverride, getAgentSidebarMaxWidth, getAgentSidebarWideWidth, dispatchAgentSidebarStateChange, getInitialAgentSidebarOpen, requestAgentSidebarOpen, subscribeAgentSidebarUrlChanges, SIDEBAR_STATE_CHANGE_EVENT, setAgentSidebarOpenPreference, } from "../agent-sidebar-state.js";
 export * from "../chat/agentkit-protocol.js";
 export { createAgentNativeAgentKitTransport, } from "../chat/agentkit-agent-native.js";
+export { trackTurnSubmitted } from "../chat/turn-submitted-telemetry.js";
 export { AGENT_CHAT_RUNNING_EVENT, dispatchAgentChatRunning, resolveAgentChatRunningThreadId, useAgentChatRunningThreads, } from "../use-agent-chat-running-threads.js";
 export { CHAT_FIRST_APP_LAYOUT_STORAGE_KEY, CHAT_FIRST_DEFAULT_APP_IDS, CHAT_FIRST_SURFACE_TABS_STORAGE_KEY, CHAT_FIRST_SURFACE_PANEL_STORAGE_KEY, CHAT_FIRST_SURFACE_WIDTH_DEFAULT, CHAT_FIRST_SURFACE_WIDTH_MIN, clampChatFirstSurfaceWidth, CHAT_FIRST_MODE_STORAGE_KEY, CHAT_FIRST_MODE_CHANGED_EVENT, CHAT_FIRST_OPEN_APP_EVENT, CHAT_FIRST_OPEN_BROWSER_EVENT, CHAT_FIRST_WATCH_SESSION_EVENT, CHAT_FIRST_SURFACE_CATALOG, chatFirstSurfaceTabId, closeChatFirstSessionWatch, emitChatFirstOpenApp, emitChatFirstOpenBrowser, emitChatFirstSessionWatch, getChatFirstSessionWatchStore, getChatFirstSurfaceTabsStore, getChatFirstSurfacePanelStore, orderChatFirstAppIds, readChatFirstAppLayout, resolveChatFirstAppTarget, resolveChatFirstBrowserTarget, resolveChatFirstSessionId, normalizeChatFirstSessionReference, readChatFirstMode, readChatFirstModeState, readChatFirstSurfaceWidth, subscribeChatFirstOpenApp, subscribeChatFirstOpenBrowser, subscribeChatFirstSessionWatch, useChatFirstSessionWatch, useChatFirstSurfaceResize, useChatFirstSurfacePanel, useChatFirstSurfaceTabs, writeChatFirstAppLayout, writeChatFirstMode, writeChatFirstSurfaceWidth, } from "../chat-first-state.js";
 export { useVoiceProviderStatus } from "../voice-provider-status.js";

package/dist/client/agent-chat.d.ts

@@ -182,6 +182,8 @@ export interface ParsedSubmitChat {
     submissionExpiresAt?: number;
     usageLabel?: string;
     approvedToolCalls?: string[];
+    /** The sender's `preset`, reported as the turn's analytics surface. */
+    surface?: string;
 }
 export declare function parseSubmitChatMessage(event: MessageEvent): ParsedSubmitChat | null;
 export declare function routesToCodeFrame(opts: Pick<AgentChatMessage, "type" | "requiresCode" | "approvedToolCalls">): boolean;

package/dist/client/agent-chat.js

@@ -4,6 +4,8 @@ import { trackEvent } from "./analytics.js";
 import { agentNativePath } from "./api-path.js";
 import { readClientAppState, writeClientAppState, } from "./application-state.js";
 import { isInBuilderFrame, isTrustedBuilderMessage, sendToBuilderChat, } from "./builder-frame.js";
+import { trackRoutedTurnSubmitted } from "./chat/turn-submitted-telemetry.js";
+import { DEFAULT_TURN_SURFACE } from "./chat/turn-submitted.js";
 import { isEmbedAuthActive, isEmbedMcpChatBridgeActive, markEmbedMcpChatBridgeActive, readEmbedMcpChatBridgeFlagFromUrl, } from "./embed-auth.js";
 import { getFramePostMessageTargetOrigin, isTrustedFrameMessage, } from "./frame.js";
 import { isOpenAiMcpAppHost, sendMcpAppHostMessage, } from "./mcp-app-host.js";
@@ -782,6 +784,7 @@ export function parseSubmitChatMessage(event) {
             : {}),
         usageLabel: nonEmptyString(raw.usageLabel),
         approvedToolCalls: parseSubmitChatApprovedToolCalls(raw.approvedToolCalls),
+        surface: nonEmptyString(raw.preset),
     };
 }
 function normalizeStoredAgentChatExecMode(value) {
@@ -826,6 +829,22 @@ export function routesToCodeFrame(opts) {
         return false;
     return !keepsApprovalInAppChat(opts);
 }
+/** A send that delivers a non-blank prompt; only these count as a turn. */
+function submitsMessage(opts) {
+    return opts.submit !== false && !!opts.message.trim();
+}
+/** A submitted prompt that leaves this page for Builder or an MCP host. */
+function trackRoutedSend(opts, routedTo, submitMessageId, requestMode) {
+    // Typed as a string, but JS callers reach this too; a tracker never throws.
+    if (typeof opts.message !== "string" || !submitsMessage(opts))
+        return;
+    trackRoutedTurnSubmitted({
+        routedTo,
+        surface: opts.preset ?? DEFAULT_TURN_SURFACE,
+        submitMessageId,
+        requestMode,
+    });
+}
 function sendToAgentChatInternal(opts, forceMcpAppWrapperRelay = false) {
     const tabId = opts.tabId ?? generateTabId();
     const actionScope = opts.actionScope === undefined
@@ -841,7 +860,7 @@ function sendToAgentChatInternal(opts, forceMcpAppWrapperRelay = false) {
         (mcpAppLocalPayload && !routesLocalToChatGpt);
     const requestMode = normalizeAgentChatRequestMode(opts.requestMode ?? opts.mode) ??
         readStoredAgentChatRequestMode();
-    if (opts.submit !== false && opts.message.trim()) {
+    if (submitsMessage(opts)) {
         trackEvent("app.first_action", {
             action: "chat_submit",
             surface: opts.preset ?? "chat",
@@ -851,6 +870,7 @@ function sendToAgentChatInternal(opts, forceMcpAppWrapperRelay = false) {
         });
     }
     if (isCodeRequest && isInBuilderFrame()) {
+        trackRoutedSend(opts, "builder", opts.submitMessageId, requestMode);
         sendToBuilderChat({
             message: opts.message,
             context: opts.context,
@@ -872,10 +892,12 @@ function sendToAgentChatInternal(opts, forceMcpAppWrapperRelay = false) {
         },
     };
     if (forceMcpAppWrapperRelay && mcpBridgeEnabled) {
+        trackRoutedSend(opts, "mcp_host", submitMessageId, requestMode);
         window.parent.postMessage(payload, getFramePostMessageTargetOrigin() || "*");
         return tabId;
     }
     if (opts.submit !== false && !localChatTarget && mcpBridgeEnabled) {
+        trackRoutedSend(opts, "mcp_host", submitMessageId, requestMode);
         if (opts.targetTabId) {
             window.parent.postMessage(payload, getFramePostMessageTargetOrigin() || "*");
             return tabId;
@@ -1004,13 +1026,17 @@ export function sendToAgentChatAndConfirm(opts, options) {
             return confirmAgentChatSubmit(opts, options, tabId, (submission) => sendToAgentChatInternal(submission, true));
         }
         return Promise.resolve(hostDelivery)
-            .then((delivered) => delivered === false
-            ? confirmAgentChatSubmit(opts, options, tabId, (submission) => sendToAgentChatInternal(submission, true))
-            : {
+            .then((delivered) => {
+            if (delivered === false) {
+                return confirmAgentChatSubmit(opts, options, tabId, (submission) => sendToAgentChatInternal(submission, true));
+            }
+            trackRoutedSend(opts, "mcp_host", options?.submitMessageId, requestMode);
+            return {
                 tabId,
                 delivered: delivered === true,
                 ...(delivered === true ? {} : { reason: "host-unconfirmed" }),
-            })
+            };
+        })
             .catch(() => ({ tabId, delivered: false, reason: "host-rejected" }));
     }
     return confirmAgentChatSubmit(opts, options, tabId, sendToAgentChat);

package/dist/client/chat/agentkit-agent-native.js

@@ -14,6 +14,7 @@ import { AGENT_NATIVE_PROTOCOL_METADATA_KEY, createAgentKitProtocolAdapter, } fr
 import { trackRunFeedback, trackRunOutcome } from "./run-outcome-telemetry.js";
 import { runOutcomeForCode } from "./run-outcome.js";
 import { createAgentNativeChatRuntime, isAgentNativeChatRuntime, } from "./runtime.js";
+import { trackTurnSubmitted } from "./turn-submitted-telemetry.js";
 const RUN_SLOT_POLL_INTERVAL_MS = 150;
 const RUN_SLOT_STABLE_POLLS = 2;
 const SAFE_BOUNDARY_POLL_INTERVAL_MS = 500;
@@ -3386,7 +3387,10 @@ export function createAgentNativeAgentKitTransport(options = {}) {
         Object.assign(error, { code: "queue_item_busy", retryable: true });
         throw error;
     }
-    const runtime = options.runtime ?? createAgentNativeChatRuntime(options);
+    const runtime = options.runtime ??
+        createAgentNativeChatRuntime(options, {
+            onTurnSubmitted: trackTurnSubmitted,
+        });
     const feedbackUrl = options.feedbackUrl ??
         agentNativePath("/_agent-native/observability/feedback");
     const onRunOutcome = options.adapter?.onRunOutcome ?? trackRunOutcome;
@@ -3827,6 +3831,9 @@ export function createAgentNativeAgentKitTransport(options = {}) {
             onRunOutcome({
                 runId: record.turnId,
                 threadId,
+                ...(typeof record.requestTurnId === "string"
+                    ? { turnId: record.requestTurnId }
+                    : {}),
                 outcome: runOutcomeForCode(code),
                 ...(code ? { code } : {}),
                 ...(error instanceof Error && error.message

package/dist/client/chat/agentkit-protocol.js

@@ -1804,6 +1804,7 @@ export function createAgentKitProtocolAdapter(runtime, options = {}) {
             options.onRunOutcome({
                 runId: run.turn.runId ?? run.runId,
                 threadId: run.threadId,
+                ...(run.turn.requestTurnId ? { turnId: run.turn.requestTurnId } : {}),
                 outcome: event.type === "run.completed"
                     ? "succeeded"
                     : event.type === "run.cancelled"
@@ -3005,7 +3006,12 @@ export function createAgentKitProtocolAdapter(runtime, options = {}) {
             run.quietAuthorityReads = 0;
             run.successorWaitStartedAtMs = undefined;
         }
-        run.turn = resumed;
+        // A resumed stream is the same turn; only the response that started it
+        // carries the turn the server stored the run under.
+        run.turn =
+            resumed.requestTurnId || !run.turn.requestTurnId
+                ? resumed
+                : { ...resumed, requestTurnId: run.turn.requestTurnId };
         indexRun(run, resumed.runId);
     }
     function ensurePump(run) {

package/dist/client/chat/run-outcome-telemetry.js

@@ -80,6 +80,7 @@ export function trackRunOutcome(report, send = trackEvent, random = Math.random)
             drain_attempts: report.drainAttempts,
             run_id: report.runId,
             thread_id: report.threadId,
+            ...(report.turnId ? { turn_id: report.turnId } : {}),
             sample_rate: rate,
             sample_weight: 1 / rate,
         });

package/dist/client/chat/run-outcome.d.ts

@@ -41,6 +41,11 @@ export type RunTerminalSource = "stream" | "authority" | "pipe" | "local";
 export interface RunOutcomeReport {
     readonly runId: string;
     readonly threadId: string;
+    /**
+     * The turn the server stored the run under; absent when this page did not
+     * start it, or for a replay whose turn the server did not name.
+     */
+    readonly turnId?: string;
     readonly outcome: RunOutcome;
     /** The legacy code that named this outcome one incident at a time. */
     readonly code?: string;

package/dist/client/chat/runtime.d.ts

@@ -3,6 +3,7 @@ import type { ActionChatUIConfig } from "../../action-ui.js";
 import type { AgentMcpAppPayload } from "../../mcp-client/app-result.js";
 import type { ReasoningEffort } from "../../shared/reasoning-effort.js";
 import { type ServerRunState } from "./run-outcome.js";
+import { type TurnSubmittedReport } from "./turn-submitted.js";
 export type { ServerRunState } from "./run-outcome.js";
 export type AgentChatRuntimeId = string;
 export type AgentChatRuntimeSessionId = string;
@@ -549,6 +550,13 @@ export type AgentChatRuntimeKnownEvent = AgentChatRuntimeMessageStartEvent | Age
 export type AgentChatRuntimeEvent<TCustomEvent extends AgentChatRuntimeCustomEvent = never> = AgentChatRuntimeKnownEvent | TCustomEvent;
 export interface AgentChatRuntimeTurn<TEvent extends AgentChatRuntimeEventBase = AgentChatRuntimeKnownEvent> {
     readonly id?: AgentChatRuntimeTurnId;
+    /**
+     * The turn the server stored the run under (its `X-Turn-Id`), else the one
+     * the request carried; absent for a replay the server did not name the turn
+     * of. A continuation sends the turn it continues, and an approval resume
+     * runs under its pending approval's turn, so this is not always `id`.
+     */
+    readonly requestTurnId?: AgentChatRuntimeTurnId;
     readonly sessionId: AgentChatRuntimeSessionId;
     readonly runId?: string;
     readonly metadata?: AgentChatRuntimeMetadata;
@@ -636,7 +644,25 @@ export interface CreateHttpAgentChatRuntimeOptions<TEvent extends AgentChatRunti
         session: AgentChatRuntimeSessionSummary;
         turn: AgentChatRuntimeTurnInput;
         turnId: AgentChatRuntimeTurnId;
+        requestTurnId: AgentChatRuntimeTurnId;
     }) => unknown;
+    /** The turn id a turn's request carries; the runtime's own id by default. */
+    readonly requestTurnId?: (input: {
+        turn: AgentChatRuntimeTurnInput;
+        turnId: AgentChatRuntimeTurnId;
+    }) => AgentChatRuntimeTurnId;
+    /**
+     * Told once the endpoint accepts a turn, before its events are read. It is
+     * not awaited and anything it throws is ignored.
+     */
+    readonly onTurnAccepted?: (input: {
+        session: AgentChatRuntimeSessionSummary;
+        turn: AgentChatRuntimeTurnInput;
+        turnId: AgentChatRuntimeTurnId;
+        /** The turn the server stored the run under, as on the returned turn. */
+        requestTurnId: AgentChatRuntimeTurnId;
+        runId: string;
+    }) => void;
     /** Called at the final client boundary before a new turn reaches the endpoint. */
     readonly beforeStartTurn?: (input: {
         session: AgentChatRuntimeSessionSummary;
@@ -682,5 +708,12 @@ export interface CreateAgentNativeChatRuntimeOptions {
 export declare function createHttpAgentChatRuntime<TEvent extends AgentChatRuntimeEventBase = AgentChatRuntimeKnownEvent>(options: CreateHttpAgentChatRuntimeOptions<TEvent>): AgentChatRuntime<TEvent>;
 export declare function loadedSkillSlugsFromMessages(messages: readonly AgentChatRuntimeMessage[] | undefined): string[];
 export declare const AGENT_CALL_FAILURE_REASON_KEYS: readonly string[];
-export declare function createAgentNativeChatRuntime(options?: CreateAgentNativeChatRuntimeOptions): AgentChatRuntime<AgentChatRuntimeKnownEvent>;
+/**
+ * Where the runtime reports telemetry. It is injected rather than imported so
+ * the runtime stays loadable without the browser analytics module.
+ */
+export interface AgentNativeChatRuntimeTelemetry {
+    readonly onTurnSubmitted?: (report: TurnSubmittedReport) => void;
+}
+export declare function createAgentNativeChatRuntime(options?: CreateAgentNativeChatRuntimeOptions, telemetry?: AgentNativeChatRuntimeTelemetry): AgentChatRuntime<AgentChatRuntimeKnownEvent>;
 export declare function isAgentNativeChatRuntime(runtime: AgentChatRuntime | undefined): boolean;