@agent-native/core 0.172.10 → 0.173.0

package/dist/collab/awareness.d.ts

@@ -62,11 +62,11 @@ export declare const postAwareness: import("h3").EventHandlerWithFetch<import("h
     error: string;
     states?: undefined;
 } | {
+    error?: undefined;
     states: {
         clientId: number;
         state: string;
     }[];
-    error?: undefined;
 }>>;
 /**
  * GET /_agent-native/collab/:docId/users
@@ -77,9 +77,9 @@ export declare const getActiveUsers: import("h3").EventHandlerWithFetch<import("
     error: string;
     users?: undefined;
 } | {
+    error?: undefined;
     users: {
         clientId: number;
         lastSeen: number;
     }[];
-    error?: undefined;
 }>>;

package/dist/file-upload/actions/upload-image.d.ts

@@ -17,11 +17,11 @@ declare const _default: import("../../action.js").ActionDefinition<{
     id?: undefined;
     provider?: undefined;
 } | {
-    error?: undefined;
     configured?: undefined;
     connectPath?: undefined;
     url: string;
     id: string;
     provider: string;
+    error?: undefined;
 }>;
 export default _default;

package/dist/localization/core-messages/ar-SA.js

@@ -535,6 +535,10 @@ const messages = {
     "tool.repeated": "تكرر {{count}} مرة",
     "tool.result": "النتيجة",
     "tool.subAgentTask": "مهمة الوكيل الفرعي",
+    "thinking.collapsed": "مطوي",
+    "thinking.display": "عرض التفكير",
+    "thinking.expanded": "موسّع",
+    "thinking.hidden": "مخفي",
     "tool.thought": "فكرة",
     "tool.thoughtFor": "فكّر لمدة {{duration}}",
     "tool.viewOutput": "عرض مخرجات {{tool}}",

package/dist/localization/core-messages/de-DE.js

@@ -181,6 +181,10 @@ const messages = {
     "tool.repeated": "{{count}}-mal wiederholt",
     "tool.result": "Ergebnis",
     "tool.subAgentTask": "Unteragenten-Aufgabe",
+    "thinking.collapsed": "Eingeklappt",
+    "thinking.display": "Gedankengang",
+    "thinking.expanded": "Ausgeklappt",
+    "thinking.hidden": "Ausgeblendet",
     "tool.thought": "Gedankengang",
     "tool.thoughtFor": "{{duration}} nachgedacht",
     "tool.viewOutput": "Ausgabe von {{tool}} anzeigen",

package/dist/localization/core-messages/en-US.d.ts

@@ -515,6 +515,10 @@ declare const messages: {
     readonly "tool.repeated": "Repeated {{count}} times";
     readonly "tool.result": "Result";
     readonly "tool.subAgentTask": "Sub-agent task";
+    readonly "thinking.collapsed": "Collapsed";
+    readonly "thinking.display": "Thinking";
+    readonly "thinking.expanded": "Expanded";
+    readonly "thinking.hidden": "Hidden";
     readonly "tool.thought": "Thought";
     readonly "tool.thoughtFor": "Thought for {{duration}}";
     readonly "tool.viewOutput": "View {{tool}} output";

package/dist/localization/core-messages/en-US.js

@@ -515,6 +515,10 @@ const messages = {
     "tool.repeated": "Repeated {{count}} times",
     "tool.result": "Result",
     "tool.subAgentTask": "Sub-agent task",
+    "thinking.collapsed": "Collapsed",
+    "thinking.display": "Thinking",
+    "thinking.expanded": "Expanded",
+    "thinking.hidden": "Hidden",
     "tool.thought": "Thought",
     "tool.thoughtFor": "Thought for {{duration}}",
     "tool.viewOutput": "View {{tool}} output",

package/dist/localization/core-messages/es-ES.js

@@ -181,6 +181,10 @@ const messages = {
     "tool.repeated": "Repetido {{count}} veces",
     "tool.result": "Resultado",
     "tool.subAgentTask": "Tarea del subagente",
+    "thinking.collapsed": "Contraído",
+    "thinking.display": "Razonamiento",
+    "thinking.expanded": "Expandido",
+    "thinking.hidden": "Oculto",
     "tool.thought": "Razonamiento",
     "tool.thoughtFor": "Razonó durante {{duration}}",
     "tool.viewOutput": "Ver la salida de {{tool}}",

package/dist/localization/core-messages/fr-FR.js

@@ -181,6 +181,10 @@ const messages = {
     "tool.repeated": "Répété {{count}} fois",
     "tool.result": "Résultat",
     "tool.subAgentTask": "Tâche du sous-agent",
+    "thinking.collapsed": "Replié",
+    "thinking.display": "Réflexion",
+    "thinking.expanded": "Développé",
+    "thinking.hidden": "Masqué",
     "tool.thought": "Réflexion",
     "tool.thoughtFor": "Réflexion pendant {{duration}}",
     "tool.viewOutput": "Afficher la sortie de {{tool}}",

package/dist/localization/core-messages/hi-IN.js

@@ -515,6 +515,10 @@ const messages = {
     "tool.repeated": "{{count}} बार दोहराया गया",
     "tool.result": "परिणाम",
     "tool.subAgentTask": "सब-एजेंट कार्य",
+    "thinking.collapsed": "संक्षिप्त",
+    "thinking.display": "विचार प्रदर्शन",
+    "thinking.expanded": "विस्तृत",
+    "thinking.hidden": "छिपा हुआ",
     "tool.thought": "विचार",
     "tool.thoughtFor": "{{duration}} तक सोचा",
     "tool.viewOutput": "{{tool}} का आउटपुट देखें",

package/dist/localization/core-messages/ja-JP.js

@@ -510,6 +510,10 @@ const messages = {
     "tool.repeated": "{{count}} 回繰り返しました",
     "tool.result": "結果",
     "tool.subAgentTask": "サブエージェントのタスク",
+    "thinking.collapsed": "折りたたみ",
+    "thinking.display": "思考の表示",
+    "thinking.expanded": "展開",
+    "thinking.hidden": "非表示",
     "tool.thought": "思考",
     "tool.thoughtFor": "{{duration}} 思考しました",
     "tool.viewOutput": "{{tool}} の出力を表示",

package/dist/localization/core-messages/ko-KR.js

@@ -510,6 +510,10 @@ const messages = {
     "tool.repeated": "{{count}}회 반복",
     "tool.result": "결과",
     "tool.subAgentTask": "하위 에이전트 작업",
+    "thinking.collapsed": "접음",
+    "thinking.display": "생각 표시",
+    "thinking.expanded": "펼침",
+    "thinking.hidden": "숨김",
     "tool.thought": "생각",
     "tool.thoughtFor": "{{duration}} 동안 생각함",
     "tool.viewOutput": "{{tool}} 출력 보기",

package/dist/localization/core-messages/pt-BR.js

@@ -181,6 +181,10 @@ const messages = {
     "tool.repeated": "Repetido {{count}} vezes",
     "tool.result": "Resultado",
     "tool.subAgentTask": "Tarefa do subagente",
+    "thinking.collapsed": "Recolhido",
+    "thinking.display": "Raciocínio",
+    "thinking.expanded": "Expandido",
+    "thinking.hidden": "Oculto",
     "tool.thought": "Raciocínio",
     "tool.thoughtFor": "Raciocinou por {{duration}}",
     "tool.viewOutput": "Ver saída de {{tool}}",

package/dist/localization/core-messages/zh-CN.js

@@ -510,6 +510,10 @@ const messages = {
     "tool.repeated": "重复了 {{count}} 次",
     "tool.result": "结果",
     "tool.subAgentTask": "子智能体任务",
+    "thinking.collapsed": "折叠",
+    "thinking.display": "思考显示",
+    "thinking.expanded": "展开",
+    "thinking.hidden": "隐藏",
     "tool.thought": "思考",
     "tool.thoughtFor": "思考了 {{duration}}",
     "tool.viewOutput": "查看 {{tool}} 输出",

package/dist/localization/core-messages/zh-TW.js

@@ -510,6 +510,10 @@ const messages = {
     "tool.repeated": "重複了 {{count}} 次",
     "tool.result": "結果",
     "tool.subAgentTask": "子代理任務",
+    "thinking.collapsed": "收合",
+    "thinking.display": "思考顯示",
+    "thinking.expanded": "展開",
+    "thinking.hidden": "隱藏",
     "tool.thought": "思考",
     "tool.thoughtFor": "思考了 {{duration}}",
     "tool.viewOutput": "檢視 {{tool}} 輸出",

package/dist/localization/core-messages.d.ts

@@ -517,6 +517,10 @@ export declare const englishAgentChatMessages: {
     readonly "tool.repeated": "Repeated {{count}} times";
     readonly "tool.result": "Result";
     readonly "tool.subAgentTask": "Sub-agent task";
+    readonly "thinking.collapsed": "Collapsed";
+    readonly "thinking.display": "Thinking";
+    readonly "thinking.expanded": "Expanded";
+    readonly "thinking.hidden": "Hidden";
     readonly "tool.thought": "Thought";
     readonly "tool.thoughtFor": "Thought for {{duration}}";
     readonly "tool.viewOutput": "View {{tool}} output";

package/dist/observability/posthog-ai.d.ts

@@ -12,6 +12,12 @@
  * PostHog's `$session_id`: the latter is the browser session used for session
  * replay, and the two are different lifetimes.
  *
+ * Events are stamped when the operation BEGAN, which is what every backend
+ * except PostHog reads verbatim. PostHog alone treats an AI event's timestamp
+ * as the moment the operation ended and recovers the start by subtracting
+ * `$ai_latency`; that shift lives in its provider, not here, so one backend's
+ * convention cannot move everyone else's clock.
+ *
  * PostHog DERIVES a trace's latency, tokens and cost from its children — its
  * trace query sums `$ai_latency` over every event whose `$ai_parent_id` is the
  * trace or absent, and sums tokens/cost over `$ai_generation` / `$ai_embedding`

package/dist/observability/posthog-ai.js

@@ -12,6 +12,12 @@
  * PostHog's `$session_id`: the latter is the browser session used for session
  * replay, and the two are different lifetimes.
  *
+ * Events are stamped when the operation BEGAN, which is what every backend
+ * except PostHog reads verbatim. PostHog alone treats an AI event's timestamp
+ * as the moment the operation ended and recovers the start by subtracting
+ * `$ai_latency`; that shift lives in its provider, not here, so one backend's
+ * convention cannot move everyone else's clock.
+ *
  * PostHog DERIVES a trace's latency, tokens and cost from its children — its
  * trace query sums `$ai_latency` over every event whose `$ai_parent_id` is the
  * trace or absent, and sums tokens/cost over `$ai_generation` / `$ai_embedding`

package/dist/observability/routes.d.ts

@@ -41,16 +41,16 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     thumbsUpRate: number;
     avgEvalScore: number;
 } | {
+    error?: undefined;
     summary: import("./types.js").TraceSummary;
     spans: import("./types.js").TraceSpan[];
     id?: undefined;
-    error?: undefined;
     ok?: undefined;
 } | {
+    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id: string;
-    error?: undefined;
     ok?: undefined;
 } | {
     summary?: undefined;
@@ -59,9 +59,9 @@ export declare function createObservabilityHandler(): import("h3").EventHandlerW
     error: any;
     ok?: undefined;
 } | {
+    error?: undefined;
     summary?: undefined;
     spans?: undefined;
     id?: undefined;
     ok: boolean;
-    error?: undefined;
 }>>;

package/dist/provider-api/actions/custom-provider-registration.d.ts

@@ -76,6 +76,7 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     }>>;
 }, z.core.$strip>>, {
     id?: undefined;
+    provider?: undefined;
     deleted?: undefined;
     providers: {
         id: string;
@@ -87,7 +88,6 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
         updatedAt: number;
     }[];
     count: number;
-    provider?: undefined;
     found?: undefined;
     registered?: undefined;
     label?: undefined;
@@ -103,19 +103,19 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
+    provider?: undefined;
     deleted?: undefined;
     providers?: undefined;
     count?: undefined;
-    provider?: undefined;
     found: boolean;
     id: string;
     registered?: undefined;
     label?: undefined;
     message?: undefined;
 } | {
+    provider?: undefined;
     providers?: undefined;
     count?: undefined;
-    provider?: undefined;
     found?: undefined;
     deleted: boolean;
     id: string;
@@ -123,10 +123,10 @@ export declare function createCustomProviderRegistrationAction<TSchema extends Z
     label?: undefined;
     message?: undefined;
 } | {
+    provider?: undefined;
     deleted?: undefined;
     providers?: undefined;
     count?: undefined;
-    provider?: undefined;
     found?: undefined;
     registered: boolean;
     id: string;

package/dist/provider-api/actions/provider-api.d.ts

@@ -312,8 +312,6 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         scope?: "org" | "user" | undefined;
     }, {
         id?: undefined;
-        provider?: undefined;
-        deleted?: undefined;
         providers: {
             id: string;
             label: string;
@@ -324,34 +322,36 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
             updatedAt: number;
         }[];
         count: number;
+        provider?: undefined;
         found?: undefined;
+        deleted?: undefined;
         registered?: undefined;
         label?: undefined;
         message?: undefined;
     } | {
         id?: undefined;
-        deleted?: undefined;
         providers?: undefined;
         count?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;
+        deleted?: undefined;
         registered?: undefined;
         label?: undefined;
         message?: undefined;
     } | {
-        provider?: undefined;
-        deleted?: undefined;
         providers?: undefined;
         count?: undefined;
+        provider?: undefined;
         found: boolean;
         id: string;
+        deleted?: undefined;
         registered?: undefined;
         label?: undefined;
         message?: undefined;
     } | {
-        provider?: undefined;
         providers?: undefined;
         count?: undefined;
+        provider?: undefined;
         found?: undefined;
         deleted: boolean;
         id: string;
@@ -359,11 +359,11 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         label?: undefined;
         message?: undefined;
     } | {
-        provider?: undefined;
-        deleted?: undefined;
         providers?: undefined;
         count?: undefined;
+        provider?: undefined;
         found?: undefined;
+        deleted?: undefined;
         registered: boolean;
         id: string;
         label: string;

package/dist/provider-api/corpus-jobs.d.ts

@@ -73,6 +73,7 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
     offset?: unknown;
     limit?: unknown;
 }, {
+    deleted?: undefined;
     jobs: {
         id: string;
         name: string;
@@ -83,7 +84,6 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
         updatedAt: string;
     }[];
     total: number;
-    deleted?: undefined;
     jobId?: undefined;
 } | {
     jobs?: undefined;
@@ -91,9 +91,9 @@ export declare function createProviderCorpusJobAction(options: CreateProviderCor
     deleted: boolean;
     jobId: string;
 } | {
+    deleted?: undefined;
     jobs?: undefined;
     total?: undefined;
-    deleted?: undefined;
     jobId?: undefined;
     hits: Record<string, unknown>[];
     offset: number;

package/dist/resources/handlers.d.ts

@@ -48,8 +48,8 @@ export declare function handleUpdateResource(event: any): Promise<import("./stor
 }>;
 /** DELETE /_agent-native/resources/:id — delete a resource */
 export declare function handleDeleteResource(event: any): Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/secrets/routes.d.ts

@@ -37,17 +37,17 @@ export declare function createWriteSecretHandler(): import("h3").EventHandlerWit
     ok?: undefined;
     status?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     status: string;
+    error?: undefined;
 } | {
     ok?: undefined;
     error: string;
     removed?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;
 /**
  * POST /_agent-native/secrets/:key/test — validate an optional candidate value
@@ -58,13 +58,13 @@ export declare function createTestSecretHandler(): import("h3").EventHandlerWith
     error: string;
     note?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     note?: undefined;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     note: string;
+    error?: undefined;
 } | {
     note?: undefined;
     ok: boolean;
@@ -95,11 +95,11 @@ export interface AdHocSecretPayload {
 export declare function createAdHocSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<AdHocSecretPayload[] | {
     error: string;
 } | {
-    error?: undefined;
     ok: boolean;
     key: string;
-} | {
     error?: undefined;
+} | {
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;

package/dist/server/transcribe-voice.d.ts

@@ -20,6 +20,6 @@ export declare function createTranscribeVoiceHandler(): import("h3").EventHandle
     error: string;
     text?: undefined;
 } | {
-    text: string;
     error?: undefined;
+    text: string;
 }>>;

package/dist/shared/thinking-display.d.ts

@@ -0,0 +1,23 @@
+/**
+ * How much of the model's reasoning the chat surface shows.
+ *
+ * This is presentation only. It never changes what the engine requests or
+ * what is persisted — a hidden thought was still thought, and switching back
+ * to `expanded` reveals the same text on the same historical turns.
+ */
+export declare const THINKING_DISPLAY_MODES: readonly ["expanded", "collapsed", "hidden"];
+export type ThinkingDisplay = (typeof THINKING_DISPLAY_MODES)[number];
+/**
+ * Collapsed by default: a live reasoning cell that auto-opens pushes the
+ * answer out of the viewport on every turn, which is the noise users report.
+ * The label and its "Thought for Xs" timing stay visible, one click from the
+ * full text.
+ */
+export declare const DEFAULT_THINKING_DISPLAY: ThinkingDisplay;
+export declare function isThinkingDisplay(value: unknown): value is ThinkingDisplay;
+/**
+ * Returns null for both "nothing stored" and "stored value is not a mode".
+ * Callers substitute the default; the distinction does not survive here
+ * because there is no repair a caller could make with it.
+ */
+export declare function parseThinkingDisplay(value: unknown): ThinkingDisplay | null;

package/dist/shared/thinking-display.js

@@ -0,0 +1,31 @@
+/**
+ * How much of the model's reasoning the chat surface shows.
+ *
+ * This is presentation only. It never changes what the engine requests or
+ * what is persisted — a hidden thought was still thought, and switching back
+ * to `expanded` reveals the same text on the same historical turns.
+ */
+export const THINKING_DISPLAY_MODES = [
+    "expanded",
+    "collapsed",
+    "hidden",
+];
+/**
+ * Collapsed by default: a live reasoning cell that auto-opens pushes the
+ * answer out of the viewport on every turn, which is the noise users report.
+ * The label and its "Thought for Xs" timing stay visible, one click from the
+ * full text.
+ */
+export const DEFAULT_THINKING_DISPLAY = "collapsed";
+const modeSet = new Set(THINKING_DISPLAY_MODES);
+export function isThinkingDisplay(value) {
+    return typeof value === "string" && modeSet.has(value);
+}
+/**
+ * Returns null for both "nothing stored" and "stored value is not a mode".
+ * Callers substitute the default; the distinction does not survive here
+ * because there is no repair a caller could make with it.
+ */
+export function parseThinkingDisplay(value) {
+    return isThinkingDisplay(value) ? value : null;
+}

package/dist/tracking/providers.js

@@ -135,6 +135,27 @@ function isPostHogAiObservabilityEvent(eventName) {
  * `$exception_list` — the framework's own `captureException()` emits camelCase
  * fields that PostHog would otherwise render as an empty, ungroupable issue.
  */
+/**
+ * PostHog reads an AI event's timestamp as the moment the operation ENDED and
+ * recovers its start by subtracting `$ai_latency` (its `operationStartMs`).
+ * The framework stamps events when the operation began — which Mixpanel,
+ * Amplitude, webhooks and Agent Native Analytics consume verbatim — so the
+ * shift belongs here, in the one backend that reads it that way. Events with no
+ * `$ai_latency` (a trace, an exception) are unshifted: there is nothing for
+ * PostHog to subtract.
+ */
+function postHogAiEndTimestamp(event) {
+    const latencySeconds = Number(event.properties?.["$ai_latency"]);
+    if (!event.timestamp ||
+        !Number.isFinite(latencySeconds) ||
+        latencySeconds <= 0) {
+        return event.timestamp;
+    }
+    const startedAt = Date.parse(event.timestamp);
+    if (Number.isNaN(startedAt))
+        return event.timestamp;
+    return new Date(startedAt + Math.round(latencySeconds * 1000)).toISOString();
+}
 function createPostHogProvider(apiKey, host, errorTracking) {
     const sendToEventsEndpoint = (event, properties, distinctId) => {
         enqueue(`${host}/i/v0/e/`, JSON.stringify({
@@ -145,7 +166,7 @@ function createPostHogProvider(apiKey, host, errorTracking) {
             // custom property, stamping the event with its ingestion time instead.
             // An agent run emits its whole tree in one burst at the end, so that
             // collapsed a five-minute waterfall into the 100ms it took to flush.
-            timestamp: event.timestamp,
+            timestamp: postHogAiEndTimestamp(event),
             properties: {
                 distinct_id: distinctId,
                 ...properties,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.172.10",
+  "version": "0.173.0",
   "description": "Framework for agent-native application development — where AI agents and UI share SQL state, actions, and context",
   "homepage": "https://github.com/BuilderIO/agent-native#readme",
   "bugs": {
@@ -429,8 +429,8 @@
     "y-protocols": "^1.0.7",
     "yjs": "^13.6.32",
     "zod": "^4.3.6",
-    "@agent-native/recap-cli": "0.5.8",
-    "@agent-native/toolkit": "^0.16.11"
+    "@agent-native/recap-cli": "0.5.9",
+    "@agent-native/toolkit": "^0.16.12"
   },
   "devDependencies": {
     "@ai-sdk/anthropic": "^3.0.71",