@agent-native/core 0.206.0 → 0.206.1-nightly-20261009213000

package/dist/client/analytics.js

@@ -14,6 +14,7 @@ import { getAnalyticsPageLoadId, getOrCreateAnalyticsAnonymousId, getOrCreateAna
 import { injectedAgentNativeConfig } from "./app-config.js";
 import { clientBuildId } from "./build-compatibility.js";
 import { clientFailureContext } from "./failure-report.js";
+import { replayEndpointFromAnalyticsEndpoint } from "./session-replay-endpoint.js";
 import { scheduleAfterPaint } from "./use-after-paint.js";
 export { clearAnalyticsSessionId, setAnalyticsSessionId, } from "./analytics-session.js";
 import { fetchAgentEngineStatus, fetchAuthSessionStatus, } from "./client-status-requests.js";
@@ -62,6 +63,7 @@ const APP_ENTRY_TRACKING_STATE_KEY = Symbol.for("agent-native.client.appEntryTra
 const AGENT_CHAT_TRACKING_STATE_KEY = Symbol.for("agent-native.client.agentChatTracking");
 const AGENT_CHAT_LIFECYCLE_DEDUPE_TTL_MS = 10 * 60 * 1_000;
 const MAX_AGENT_CHAT_LIFECYCLE_DEDUPE_KEYS = 1_000;
+const PAGEVIEW_STARTUP_WAIT_MS = 250;
 const LLM_CONNECTION_STORAGE_KEY = "agent-native.llm_connection_status";
 const LLM_CONNECTION_CACHE_TTL_MS = 5 * 60 * 1000;
 const FIRST_TOUCH_STORAGE_KEY = "an_attribution";
@@ -1113,15 +1115,15 @@ export function configureTracking(options) {
         if (options.authSessionRefresh !== false) {
             installTrackingAuthSessionRefresh();
         }
+        maybeInstallSessionReplay(options.sessionReplay, {
+            endpoint: options.endpoint,
+            publicKey,
+        }, _trackingContentCaptureEnabled);
         if (options.pageviewTracking !== false) {
             installPageviewTracking();
             if (options.webVitals !== false)
                 installWebVitalsTracking();
         }
-        maybeInstallSessionReplay(options.sessionReplay, {
-            endpoint: options.endpoint,
-            publicKey,
-        }, _trackingContentCaptureEnabled);
         maybeInstallErrorCapture(options.errorCapture);
     }
 }
@@ -1354,15 +1356,18 @@ function sessionReplayRequiresSignedInUserFromEnv() {
 }
 function configuredSessionReplayOptions(config, tracking = {}) {
     const env = import.meta.env ?? {};
+    const runtimeConfig = typeof window === "undefined" ? undefined : window.__AGENT_NATIVE_CONFIG__;
     const publicKey = tracking.publicKey ||
         _agentNativeAnalyticsPublicKey ||
+        runtimeConfig?.agentNativeAnalyticsPublicKey ||
         env.VITE_AGENT_NATIVE_ANALYTICS_PUBLIC_KEY;
     const trackingEndpoint = tracking.endpoint ||
         _agentNativeAnalyticsEndpoint ||
+        runtimeConfig?.agentNativeAnalyticsEndpoint ||
         env.VITE_AGENT_NATIVE_ANALYTICS_ENDPOINT ||
         (publicKey ? AGENT_NATIVE_ANALYTICS_DEFAULT_ENDPOINT : undefined);
     const endpoint = trackingEndpoint
-        ? replayEndpointFromTrackingEndpoint(trackingEndpoint)
+        ? (replayEndpointFromAnalyticsEndpoint(trackingEndpoint, typeof document === "undefined" ? undefined : document.baseURI) ?? undefined)
         : undefined;
     const withTrackingDefaults = (options) => {
         const extraProperties = replayExtraPropertiesWithDefaults(options.extraProperties);
@@ -1439,29 +1444,6 @@ function replayExtraPropertiesWithDefaults(source) {
         return applyTrackingIdentity(withDefaults, isQaTrackingIdentity(identity) ? null : identity);
     };
 }
-function replayEndpointFromTrackingEndpoint(value) {
-    try {
-        const url = new URL(value);
-        if (url.pathname.endsWith("/api/analytics/track")) {
-            url.pathname = url.pathname.replace(/\/api\/analytics\/track$/, "/api/analytics/replay");
-            return url.toString();
-        }
-        if (url.pathname.endsWith("/track")) {
-            url.pathname = url.pathname.replace(/\/track$/, "/api/analytics/replay");
-            return url.toString();
-        }
-    }
-    catch {
-        // Fall through to relative-path handling below.
-    }
-    if (value.endsWith("/api/analytics/track")) {
-        return value.replace(/\/api\/analytics\/track$/, "/api/analytics/replay");
-    }
-    if (value.endsWith("/track")) {
-        return value.replace(/\/track$/, "/api/analytics/replay");
-    }
-    return undefined;
-}
 function maybeInstallSessionReplay(config, tracking, start = true) {
     if (typeof window === "undefined")
         return;
@@ -1674,24 +1656,21 @@ function sessionReplayTrackingProperties() {
             : {}),
     };
 }
-function pageviewKey() {
-    return window.location.href;
-}
-function pageviewProperties(reason) {
+function snapshotPageview(reason) {
+    const { href, origin, pathname, hostname, search } = window.location;
+    const contentCaptureEnabled = _trackingContentCaptureEnabled;
     const properties = {
-        url: !_trackingContentCaptureEnabled
-            ? window.location.origin + window.location.pathname
-            : scrubUrl(window.location.href),
-        path: window.location.pathname,
-        hostname: window.location.hostname,
+        url: !contentCaptureEnabled ? origin + pathname : scrubUrl(href),
+        path: pathname,
+        hostname,
         navigation_type: reason,
         [AGENT_SIGNALS_PAGEVIEW_PROPERTY]: AGENT_SIGNALS_VERSION,
         [PAGE_LOAD_PAGEVIEW_PROPERTY]: getAnalyticsPageLoadId(),
     };
-    if (_trackingContentCaptureEnabled && window.location.search) {
-        properties.search = scrubUrl(window.location.search);
+    if (contentCaptureEnabled && search) {
+        properties.search = scrubUrl(search);
     }
-    if (_trackingContentCaptureEnabled && typeof document !== "undefined") {
+    if (contentCaptureEnabled && typeof document !== "undefined") {
         if (document.referrer) {
             properties.referrer = scrubUrl(document.referrer);
         }
@@ -1699,7 +1678,7 @@ function pageviewProperties(reason) {
             properties.title = document.title;
         }
     }
-    return properties;
+    return { key: href, pathname, hostname, properties };
 }
 function readAppEntryKeys() {
     const stored = safeStorageGet(APP_ENTRY_STORAGE_KEY);
@@ -1744,7 +1723,7 @@ function rememberLastAppEntry(appName, now) {
     return Number.isFinite(previous) ? previous : null;
 }
 let _appEntryAuthRetry = null;
-function waitForTrackingIdentityBeforeAppEntry() {
+function waitForTrackingIdentityBeforeAppEntry(entryPath) {
     const pending = _trackingSessionRefresh;
     if (!pending || _trackingIdentityResolved)
         return false;
@@ -1753,18 +1732,19 @@ function waitForTrackingIdentityBeforeAppEntry() {
             .catch(() => { })
             .then(() => {
             _appEntryAuthRetry = null;
-            emitAppEntered();
+            emitAppEntered(entryPath);
         });
     }
     return true;
 }
-function emitAppEntered() {
+function emitAppEntered(entryPath) {
     if (typeof window === "undefined" || !_getDefaultProps)
         return;
-    if (waitForTrackingIdentityBeforeAppEntry())
+    const scheduledEntryPath = entryPath ?? window.location.pathname;
+    if (waitForTrackingIdentityBeforeAppEntry(scheduledEntryPath))
         return;
     const properties = resolveProps(AGENT_NATIVE_LIFECYCLE_EVENTS.appEntered, {
-        entry_path: window.location.pathname,
+        entry_path: scheduledEntryPath,
     });
     const appName = normalizeTrackingDimension(properties.app_name ?? properties.app);
     const sessionId = typeof properties.session_id === "string"
@@ -1780,7 +1760,7 @@ function emitAppEntered() {
     const attribution = getFirstTouchAttribution();
     trackEvent(AGENT_NATIVE_LIFECYCLE_EVENTS.appEntered, {
         app_name: appName,
-        entry_path: window.location.pathname,
+        entry_path: scheduledEntryPath,
         ...(attribution?.ref ? { source: attribution.ref } : {}),
         ...(attribution?.landing_referrer
             ? { referrer: attribution.landing_referrer }
@@ -1796,27 +1776,28 @@ function emitAppEntered() {
         }
     }
 }
-function emitPageview(reason) {
+function emitPageview(snapshot) {
     if (typeof window === "undefined")
         return;
-    if (isLocalAnalyticsHostname(window.location.hostname))
+    if (isLocalAnalyticsHostname(snapshot.hostname))
         return;
     const state = getPageviewTrackingState();
-    const key = pageviewKey();
-    if (state.lastPageviewKey === key)
+    if (state.lastPageviewKey === snapshot.key)
         return;
-    state.lastPageviewKey = key;
-    trackEvent("pageview", pageviewProperties(reason));
-    emitAppEntered();
+    state.lastPageviewKey = snapshot.key;
+    trackEvent("pageview", snapshot.properties);
+    emitAppEntered(snapshot.pathname);
 }
 function schedulePageview(reason) {
     if (!_trackingContentCaptureEnabled) {
         void stopSessionReplay("local-plan-privacy");
     }
-    const run = () => emitPageview(reason);
+    const snapshot = snapshotPageview(reason);
+    const run = () => emitPageview(snapshot);
     const deferredBootRefresh = _llmConnectionBootRefresh && !_llmConnectionStatus
         ? _llmConnectionBootRefresh
         : null;
+    const replayStart = _sessionReplayStartPromise;
     const pendingStartupContext = [];
     if (_llmConnectionRefresh && !_llmConnectionStatus) {
         pendingStartupContext.push(_llmConnectionRefresh);
@@ -1825,17 +1806,26 @@ function schedulePageview(reason) {
         pendingStartupContext.push(_trackingSessionRefresh);
     }
     if (deferredBootRefresh !== null) {
-        if (pendingStartupContext.length > 0) {
-            const timeout = new Promise((resolve) => window.setTimeout(resolve, 250));
+        if (pendingStartupContext.length > 0 || replayStart) {
+            const timeout = new Promise((resolve) => window.setTimeout(resolve, PAGEVIEW_STARTUP_WAIT_MS));
+            const startupContext = [
+                ...pendingStartupContext,
+                ...(replayStart ? [replayStart.then(() => undefined)] : []),
+            ];
             void Promise.all([
                 deferredBootRefresh,
-                Promise.race([Promise.allSettled(pendingStartupContext), timeout]),
+                Promise.race([Promise.allSettled(startupContext), timeout]),
             ]).finally(run);
             return;
         }
         void deferredBootRefresh.finally(run);
         return;
     }
+    if (replayStart) {
+        const timeout = new Promise((resolve) => window.setTimeout(resolve, PAGEVIEW_STARTUP_WAIT_MS));
+        void Promise.race([replayStart.then(() => undefined), timeout]).finally(run);
+        return;
+    }
     if (typeof queueMicrotask === "function") {
         queueMicrotask(run);
         return;

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

@@ -1,5 +1,5 @@
 import { AgentKitRunSlotBusyError } from "@agent-native/agentkit/client";
-import { isAgentKitProtocolVersion, parseAgentQueuedMessage, parseAgentRunOptions, parseAgentThreadSnapshot, } from "@agent-native/agentkit/protocol";
+import { isAgentKitProtocolVersion, parseAgentQueuedMessage, parseAgentRunOptions, parseAgentThreadSnapshot, persistableFilePart, } from "@agent-native/agentkit/protocol";
 import { projectRootAssistantMessages } from "../../agent/thread-message-projection.js";
 import { RUN_NOT_STARTED_METADATA_KEY, retryContextFromRequest, } from "../../shared/agent-chat-run-not-started.js";
 import { agentEngineStatusUrlForChatApi, requireAgentEngineConfiguredForDispatch, } from "../agent-engine-readiness.js";
@@ -167,6 +167,9 @@ function messagePart(value, fallbackTextFormat) {
                 : typeof part.mimeType === "string"
                     ? { mediaType: part.mimeType }
                     : {}),
+            ...(part.omitted === "inline-bytes"
+                ? { omitted: "inline-bytes" }
+                : {}),
         };
     }
     return {
@@ -1046,9 +1049,6 @@ function assistantMessageIdsByRun(events) {
     }
     return uniqueMessageIdsByRun;
 }
-function persistedFileUrl(url) {
-    return url && !/^\s*data:/i.test(url) ? url : undefined;
-}
 function persistedHistoryEvents(events = []) {
     const sequenceByRun = new Map();
     return events.flatMap((event) => {
@@ -1154,16 +1154,17 @@ function persistedMessages(messages) {
                 ];
             }
             if (part.type === "file") {
-                const url = persistedFileUrl(part.url);
-                if (!url && !part.fileId)
+                const stored = persistableFilePart(part);
+                if (!stored.url && !stored.fileId && !stored.omitted)
                     return [];
                 return [
                     {
                         type: "file",
-                        name: part.name,
-                        ...(part.mediaType ? { mediaType: part.mediaType } : {}),
-                        ...(url ? { url } : {}),
-                        ...(part.fileId ? { fileId: part.fileId } : {}),
+                        name: stored.name,
+                        ...(stored.mediaType ? { mediaType: stored.mediaType } : {}),
+                        ...(stored.url ? { url: stored.url } : {}),
+                        ...(stored.fileId ? { fileId: stored.fileId } : {}),
+                        ...(stored.omitted ? { omitted: stored.omitted } : {}),
                     },
                 ];
             }

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

@@ -1,4 +1,4 @@
-import { AGENT_TOOL_CALL_HISTORY_MEDIA_TYPE, AGENT_TOOL_RESULT_HISTORY_MEDIA_TYPE, AGENTKIT_PROTOCOL_VERSION, AgentProtocolValidationError, approvalResponseFromResume, createCapabilityUnavailableError, createCapabilityUnsupportedError, inferAgentActivityKind, negotiateAgentKitProtocolVersion, resumeEntryFromApproval, resumeOptionId, } from "@agent-native/agentkit/protocol";
+import { AGENT_TOOL_CALL_HISTORY_MEDIA_TYPE, AGENT_TOOL_RESULT_HISTORY_MEDIA_TYPE, AGENTKIT_PROTOCOL_VERSION, AgentProtocolValidationError, approvalResponseFromResume, createCapabilityUnavailableError, createCapabilityUnsupportedError, inferAgentActivityKind, isInlineDataUrl, negotiateAgentKitProtocolVersion, resumeEntryFromApproval, resumeOptionId, } from "@agent-native/agentkit/protocol";
 import { AUTO_CONTINUE_OF_RUN_METADATA_KEY, AUTO_CONTINUE_PROMPT, AUTO_CONTINUE_REFUSAL_CODES, CONTINUE_OF_RUN_METADATA_KEY, CONTINUE_UNAVAILABLE_CODE, } from "../../agent/auto-continue.js";
 import { parseBase64DataUrl } from "../../shared/data-url.js";
 import { emitChatFirstOpenApp, emitChatFirstOpenBrowser, } from "../chat-first-state.js";
@@ -3255,10 +3255,14 @@ export function createAgentKitProtocolAdapter(runtime, options = {}) {
             if (state.status === "missing" || !state.turnId) {
                 throw Object.assign(new Error(`Agent run ${input.runId} cannot be continued.`), { code: CONTINUE_UNAVAILABLE_CODE, retryable: false });
             }
+            const attachments = (input.attachments ?? [])
+                .filter((part) => !isInlineDataUrl(part.url))
+                .map(runtimeAttachmentFromFilePart);
             const turn = await session.continueTurn({
                 turnId: state.turnId,
                 prompt: AUTO_CONTINUE_PROMPT,
                 metadata: { [CONTINUE_OF_RUN_METADATA_KEY]: state.runId },
+                ...(attachments.length ? { attachments } : {}),
                 abortSignal: readers.signal,
             });
             const runId = await openStartedRun(input.threadId, session, turn, undefined, { continuedRunId: input.runId });

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

@@ -1,4 +1,4 @@
-import type { AgentSuggestion } from "@agent-native/agentkit/protocol";
+import { type AgentSuggestion } from "@agent-native/agentkit/protocol";
 import type { ActionChatUIConfig } from "../../action-ui.js";
 import type { AgentMcpAppPayload } from "../../mcp-client/app-result.js";
 import type { ReasoningEffort } from "../../shared/reasoning-effort.js";
@@ -240,6 +240,8 @@ export interface AgentChatRuntimeContinueInput {
     readonly prompt?: string;
     readonly approval?: AgentChatRuntimeApprovalResponse;
     readonly connection?: AgentChatRuntimeConnectionResponse;
+    /** Durable references to the continued turn's attachments; never bytes. */
+    readonly attachments?: readonly AgentChatRuntimeAttachment[];
     readonly metadata?: AgentChatRuntimeMetadata;
     readonly abortSignal?: AbortSignal;
 }
@@ -654,5 +656,6 @@ export interface CreateAgentNativeChatRuntimeOptions {
     readonly scope?: unknown;
 }
 export declare function createHttpAgentChatRuntime<TEvent extends AgentChatRuntimeEventBase = AgentChatRuntimeKnownEvent>(options: CreateHttpAgentChatRuntimeOptions<TEvent>): AgentChatRuntime<TEvent>;
+export declare function loadedSkillSlugsFromMessages(messages: readonly AgentChatRuntimeMessage[] | undefined): string[];
 export declare function createAgentNativeChatRuntime(options?: CreateAgentNativeChatRuntimeOptions): AgentChatRuntime<AgentChatRuntimeKnownEvent>;
 export declare function isAgentNativeChatRuntime(runtime: AgentChatRuntime | undefined): boolean;

package/dist/client/chat/runtime.js

@@ -1,4 +1,5 @@
 import { AgentKitRunSlotBusyError } from "@agent-native/agentkit/client";
+import { isInlineDataUrl, } from "@agent-native/agentkit/protocol";
 import { AUTO_CONTINUE_OF_RUN_METADATA_KEY, CONTINUE_OF_RUN_METADATA_KEY, } from "../../agent/auto-continue.js";
 import { agentEngineStatusUrlForChatApi, requireAgentEngineConfiguredForDispatch, } from "../agent-engine-readiness.js";
 import { getOrCreateAnalyticsSessionId } from "../analytics-session.js";
@@ -667,12 +668,39 @@ export function createHttpAgentChatRuntime(options) {
     };
     return runtime;
 }
+/**
+ * What an earlier user turn's file or image becomes in replayed history: its
+ * name, type, and durable URL, so a later turn can still refer to it. Inline
+ * bytes are never replayed.
+ */
+function historyAttachmentStub(message, part) {
+    if (message.role !== "user")
+        return undefined;
+    if (part.type !== "file" && part.type !== "image")
+        return undefined;
+    const name = part.type === "file" ? part.filename : part.alt;
+    const url = typeof part.url === "string" && !isInlineDataUrl(part.url)
+        ? part.url
+        : undefined;
+    return `[attached: ${[name || part.type, part.mediaType, url].filter(Boolean).join(" ")}]`;
+}
+/** Reasoning is the model's own scratch work and is never replayed as history. */
 function runtimeMessageText(message) {
     return message.content
-        .map((part) => part.type === "text" || part.type === "reasoning" ? part.text : "")
+        .map((part) => part.type === "text"
+        ? part.text
+        : (historyAttachmentStub(message, part) ?? ""))
         .filter(Boolean)
         .join("\n");
 }
+function isUserAsk(message) {
+    return (message.role === "user" &&
+        message.content.some((part) => (part.type === "text" && part.text.trim()) ||
+            historyAttachmentStub(message, part) !== undefined));
+}
+function hasHistoryAttachment(message) {
+    return message.content.some((part) => historyAttachmentStub(message, part) !== undefined);
+}
 function isSyntheticToolHistoryOmissionMessage(message) {
     return (message.role === "assistant" &&
         (message.id === AGENTKIT_TOOL_HISTORY_OMISSION_MESSAGE_ID_PREFIX ||
@@ -708,6 +736,38 @@ function nativeHistoryFromMessages(messages, currentPrompt) {
     }))
         .filter((message) => message.content.trim());
 }
+const MAX_LOADED_SKILL_SLUGS = 16;
+function runtimeToolResultText(part) {
+    if (typeof part.resultText === "string")
+        return part.resultText;
+    return typeof part.result === "string" ? part.result : "";
+}
+// Scans the whole thread because structured history is capped and drops older
+// skill reads; the server rebuilds those pages from these slugs.
+export function loadedSkillSlugsFromMessages(messages) {
+    const slugByCallId = new Map();
+    const loaded = [];
+    for (const message of messages ?? []) {
+        for (const part of message.content) {
+            if (part.type === "tool-call" && part.toolName === "docs-search") {
+                const slug = part.input?.slug;
+                if (typeof slug === "string" && slug.startsWith("skill-")) {
+                    slugByCallId.set(part.toolCallId, slug);
+                }
+            }
+            else if (part.type === "tool-result" && !part.isError) {
+                const slug = slugByCallId.get(part.toolCallId);
+                if (slug && runtimeToolResultText(part).startsWith("# Skill:")) {
+                    const index = loaded.indexOf(slug);
+                    if (index >= 0)
+                        loaded.splice(index, 1);
+                    loaded.push(slug);
+                }
+            }
+        }
+    }
+    return loaded.slice(-MAX_LOADED_SKILL_SLUGS);
+}
 const MAX_TOOL_HISTORY_VALUE_BYTES = 64 * 1024;
 const MAX_TOOL_HISTORY_SERIALIZATION_STEPS = 64 * 1024;
 const MAX_TOOL_HISTORY_SERIALIZATION_DEPTH = 512;
@@ -719,6 +779,9 @@ const MAX_STRUCTURED_HISTORY_TEXT_SOURCE_PARTS = MAX_TOOL_HISTORY_CALLS * 2;
 const MAX_STRUCTURED_HISTORY_SOURCE_PARTS = MAX_STRUCTURED_HISTORY_TOOL_SOURCE_PARTS +
     MAX_STRUCTURED_HISTORY_TEXT_SOURCE_PARTS;
 const MAX_STRUCTURED_HISTORY_SOURCE_MESSAGES = 1024;
+const MAX_PINNED_ATTACHMENT_PROMPTS = 32;
+/** Above every other candidate, so the byte budget drops pinned asks last. */
+const PINNED_USER_PROMPT_TEXT_PRIORITY = 4;
 const MAX_STRUCTURED_HISTORY_SOURCE_SCAN_STEPS = MAX_STRUCTURED_HISTORY_SOURCE_PARTS * 4;
 const TOOL_INPUT_OMISSION_TEXT = "Tool input omitted from history because it could not be serialized.";
 const TOOL_INPUT_SIZE_OMISSION_TEXT = "Tool input omitted from history because it exceeds 64 KiB.";
@@ -1177,7 +1240,7 @@ function runtimeMessageTextMatches(message, expected) {
             return { matches: true, complete: false };
         }
         scannedParts++;
-        if (part.type !== "text" && part.type !== "reasoning")
+        if (part.type !== "text")
             continue;
         if (!part.text)
             continue;
@@ -1229,16 +1292,19 @@ function boundedStructuredHistorySources(messages, currentPrompt, supplementalMe
         }
     }
     let firstUserPromptMessageIndex;
+    const attachmentPromptMessageIndices = [];
     const historyWindowStart = Math.max(0, historyMessages.length - MAX_STRUCTURED_HISTORY_SOURCE_MESSAGES);
     for (let index = historyWindowStart; index < historyMessages.length; index++) {
         if (index === currentPromptMessageIndex)
             continue;
         const message = historyMessages[index];
-        if (message.role === "user" &&
-            message.content.some((part) => (part.type === "text" || part.type === "reasoning") &&
-                part.text.trim())) {
+        if (message.role !== "user")
+            continue;
+        if (firstUserPromptMessageIndex === undefined && isUserAsk(message)) {
             firstUserPromptMessageIndex = index;
-            break;
+        }
+        if (hasHistoryAttachment(message)) {
+            attachmentPromptMessageIndices.push(index);
         }
     }
     let previousUserPromptMessageIndex;
@@ -1246,25 +1312,43 @@ function boundedStructuredHistorySources(messages, currentPrompt, supplementalMe
         for (let index = historyMessages.length - 1; index >= 0; index--) {
             if (index === currentPromptMessageIndex)
                 continue;
-            const message = historyMessages[index];
-            if (message.role === "user" &&
-                message.content.some((part) => (part.type === "text" || part.type === "reasoning") &&
-                    part.text.trim())) {
+            if (isUserAsk(historyMessages[index])) {
                 previousUserPromptMessageIndex = index;
                 break;
             }
         }
     }
-    const protectedUserPromptMessageIndices = new Set([firstUserPromptMessageIndex, previousUserPromptMessageIndex].filter((index) => index !== undefined));
+    // The first ask ("LinkedIn ad 1200x627 PNG") and every turn that attached a
+    // file stay in the window however long the agentic tail after them grows.
+    // ponytail: only the newest 32 attachment turns are pinned; older ones fall
+    // back to the newest-first window.
+    const pinnedUserPromptMessageIndices = new Set([
+        firstUserPromptMessageIndex,
+        previousUserPromptMessageIndex,
+        ...attachmentPromptMessageIndices.slice(-MAX_PINNED_ATTACHMENT_PROMPTS),
+    ].filter((index) => index !== undefined));
     const regularTextPartLimit = MAX_STRUCTURED_HISTORY_TEXT_SOURCE_PARTS -
-        protectedUserPromptMessageIndices.size;
+        pinnedUserPromptMessageIndices.size;
     const selectedReversed = [];
+    const pinnedPromptsAdded = new Set();
     let selectedToolPartCount = 0;
     let selectedTextPartCount = 0;
     let scannedPartCount = 0;
     let visitedMessageCount = 0;
     let toolBoundary;
     let stop = false;
+    const addPinnedPromptText = (parts, messageIndex) => {
+        pinnedPromptsAdded.add(messageIndex);
+        const text = runtimeMessageText(historyMessages[messageIndex]);
+        if (!text.trim())
+            return;
+        if (selectedTextPartCount >= MAX_STRUCTURED_HISTORY_TEXT_SOURCE_PARTS) {
+            omitted = true;
+            return;
+        }
+        selectedTextPartCount++;
+        parts.push({ type: "text", text });
+    };
     const visitMessage = (message, list, messageIndex) => {
         if (visitedMessageCount >= MAX_STRUCTURED_HISTORY_SOURCE_MESSAGES) {
             omitted = true;
@@ -1280,12 +1364,12 @@ function boundedStructuredHistorySources(messages, currentPrompt, supplementalMe
         visitedMessageCount++;
         if (message.role !== "user" && message.role !== "assistant")
             return;
-        const isFirstUserPrompt = list === "messages" && messageIndex === firstUserPromptMessageIndex;
-        const isPreviousUserPrompt = list === "messages" && messageIndex === previousUserPromptMessageIndex;
-        const isProtectedUserPrompt = isFirstUserPrompt || isPreviousUserPrompt;
+        const isPinnedUserPrompt = list === "messages" && pinnedUserPromptMessageIndices.has(messageIndex);
         const partsReversed = [];
-        let protectedPromptTextAdded = false;
         for (let partIndex = message.content.length - 1; partIndex >= 0; partIndex--) {
+            const part = message.content[partIndex];
+            if (part.type === "reasoning")
+                continue;
             if (scannedPartCount >= MAX_STRUCTURED_HISTORY_SOURCE_SCAN_STEPS) {
                 omitted = true;
                 toolHistoryOmitted = true;
@@ -1294,30 +1378,15 @@ function boundedStructuredHistorySources(messages, currentPrompt, supplementalMe
                 break;
             }
             scannedPartCount++;
-            const part = message.content[partIndex];
+            const attachmentStub = historyAttachmentStub(message, part);
             const isToolPart = (part.type === "tool-call" && message.role === "assistant") ||
                 part.type === "tool-result";
-            const isTextPart = part.type === "text" || part.type === "reasoning";
+            const isTextPart = part.type === "text" || attachmentStub !== undefined;
             if (!isToolPart && !isTextPart)
                 continue;
-            if (isProtectedUserPrompt && isTextPart) {
-                if (!protectedPromptTextAdded) {
-                    const text = message.content
-                        .filter((candidate) => candidate.type === "text" || candidate.type === "reasoning")
-                        .map((candidate) => candidate.type === "text" || candidate.type === "reasoning"
-                        ? candidate.text
-                        : "")
-                        .join("\n");
-                    if (text.trim()) {
-                        if (selectedTextPartCount >= MAX_STRUCTURED_HISTORY_TEXT_SOURCE_PARTS) {
-                            omitted = true;
-                        }
-                        else {
-                            selectedTextPartCount++;
-                            partsReversed.push({ type: "text", text });
-                        }
-                    }
-                    protectedPromptTextAdded = true;
+            if (isPinnedUserPrompt && isTextPart) {
+                if (!pinnedPromptsAdded.has(messageIndex)) {
+                    addPinnedPromptText(partsReversed, messageIndex);
                 }
                 continue;
             }
@@ -1345,15 +1414,17 @@ function boundedStructuredHistorySources(messages, currentPrompt, supplementalMe
                 }
                 selectedTextPartCount++;
             }
-            partsReversed.push(part);
+            partsReversed.push(attachmentStub === undefined
+                ? part
+                : { type: "text", text: attachmentStub });
         }
         if (partsReversed.length) {
             selectedReversed.push({
                 message,
                 parts: partsReversed.reverse(),
                 priority: list === "supplemental",
-                textPriority: isPreviousUserPrompt
-                    ? 2
+                textPriority: isPinnedUserPrompt
+                    ? PINNED_USER_PROMPT_TEXT_PRIORITY
                     : list === "supplemental"
                         ? 1
                         : 0,
@@ -1370,6 +1441,22 @@ function boundedStructuredHistorySources(messages, currentPrompt, supplementalMe
             continue;
         visitMessage(historyMessages[index], "messages", index);
     }
+    // The newest-first scan stops long before the first turns of a long agentic
+    // thread; the pinned asks it never reached are replayed anyway.
+    for (const index of [...pinnedUserPromptMessageIndices].sort((left, right) => right - left)) {
+        if (pinnedPromptsAdded.has(index))
+            continue;
+        const parts = [];
+        addPinnedPromptText(parts, index);
+        if (parts.length) {
+            selectedReversed.push({
+                message: historyMessages[index],
+                parts,
+                priority: false,
+                textPriority: PINNED_USER_PROMPT_TEXT_PRIORITY,
+            });
+        }
+    }
     return {
         messages: selectedReversed.reverse(),
         omitted,
@@ -1520,7 +1607,7 @@ function nativeStructuredHistoryFromMessages(messages, currentPrompt, supplement
             results = [];
         };
         for (const part of parts) {
-            if (part.type === "text" || part.type === "reasoning") {
+            if (part.type === "text") {
                 if (jsonStringByteLengthWithinLimit(part.text, MAX_ADDED_TOOL_HISTORY_BYTES) === undefined ||
                     part.text.trim()) {
                     flushResults();
@@ -2625,6 +2712,7 @@ export function createAgentNativeChatRuntime(options = {}) {
                 ? turnEngine
                 : options.engine;
             const history = nativeHistoryFromMessages(turn.messages, prompt);
+            const loadedSkillSlugs = loadedSkillSlugsFromMessages(turn.messages);
             const pendingApprovalHistory = approvedToolCalls && continuationMessageState
                 ? pendingApprovalRuntimeMessages(continuationMessageState)
                 : { messages: [], omitted: false, toolHistoryOmitted: false };
@@ -2638,6 +2726,7 @@ export function createAgentNativeChatRuntime(options = {}) {
                 displayMessage: prompt,
                 history,
                 ...(structuredHistory?.length ? { structuredHistory } : {}),
+                ...(loadedSkillSlugs.length ? { loadedSkillSlugs } : {}),
                 turnId: continuationTurnId ?? turn.queuePromotion?.turnId ?? turnId,
                 threadId: session.threadId ?? options.threadId,
                 ...(turn.queuePromotion
@@ -2700,6 +2789,9 @@ export function createAgentNativeChatRuntime(options = {}) {
             // Only the continuation that names a stopped run continues it; an approval
             // or connection answered later is not another continuation of that run.
             const { [AUTO_CONTINUE_OF_RUN_METADATA_KEY]: _autoContinueOf, [CONTINUE_OF_RUN_METADATA_KEY]: _continueOf, ...previousMetadata } = previousTurn?.metadata ?? {};
+            const turnToContinue = continuation.attachments?.length
+                ? { ...previousTurn, attachments: continuation.attachments }
+                : previousTurn;
             const approval = continuation.approval;
             const connection = continuation.connection;
             const messageStateKey = continuation.turnId ?? session.id;
@@ -2716,7 +2808,7 @@ export function createAgentNativeChatRuntime(options = {}) {
                 if (messageState)
                     messageState.message.connectionPending = false;
                 return startTurn({
-                    ...previousTurn,
+                    ...turnToContinue,
                     prompt: continuation.prompt ??
                         `The ${connection.id} connection is now available. Continue the requested work.`,
                     metadata: {
@@ -2736,7 +2828,7 @@ export function createAgentNativeChatRuntime(options = {}) {
                 if (messageState)
                     messageState.message.approvalPending = false;
                 return startTurn({
-                    ...previousTurn,
+                    ...turnToContinue,
                     prompt: continuation.prompt,
                     metadata: {
                         ...previousMetadata,
@@ -2759,7 +2851,7 @@ export function createAgentNativeChatRuntime(options = {}) {
             if (messageState)
                 messageState.message.approvalPending = false;
             return startTurn({
-                ...previousTurn,
+                ...turnToContinue,
                 prompt: continuation.prompt ??
                     "Approved. Go ahead and run the requested action.",
                 metadata: {

package/dist/client/session-replay-endpoint.d.ts

@@ -0,0 +1 @@
+export declare function replayEndpointFromAnalyticsEndpoint(endpoint: string, baseUrl?: string): string | null;