@agent-native/core 0.77.4 → 0.77.6

package/corpus/README.md

@@ -28,4 +28,4 @@ rg -n "defineAction|useActionQuery" node_modules/@agent-native/core/corpus
 ## Generated Counts
 
 - core files: 1932
-- template files: 4278
+- template files: 4279

package/corpus/core/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @agent-native/core
 
+## 0.77.6
+
+### Patch Changes
+
+- 1fab043: Localize shared extension sidebar chrome and changelog labels/dates.
+
+## 0.77.5
+
+### Patch Changes
+
+- 355be37: Add diagnostic-only worker-side progressive setup-stage diagnostics
+  (`worker_setup_step`) to localize where a durable background worker hangs between
+  `auth_passed` and `claimBackgroundRun`. For the background worker only (gated on
+  `isBackgroundWorker`, using the marker's early-available runId), emit the last
+  setup stage reached — `db_request_ctx`, `env_config`, `context_all`,
+  `action_tool_setup`, `owner_thread`, `prestart` — as the run's `diag_stage`, so a
+  worker that stalls leaves a breadcrumb at the stage it stopped in. Best-effort and
+  fire-and-forget; no control-flow change.
+
 ## 0.77.4
 
 ### Patch Changes

package/corpus/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.77.4",
+  "version": "0.77.6",
   "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": {

package/corpus/core/src/agent/production-agent.ts

@@ -3934,6 +3934,22 @@ export function createProductionAgentHandler(
         ? body[AGENT_CHAT_BACKGROUND_RUN_FIELD]!
         : null;
     const isBackgroundWorker = backgroundRunMarker !== null;
+    // DIAGNOSTIC-ONLY: progressive per-stage hang localizer for the bg worker.
+    // The worker's runId is available EARLY on the marker (the general `runId`
+    // var resolves much later), so capture it now and emit the LAST setup stage
+    // reached as the run's `diag_stage`. Best-effort, gated on the worker, never
+    // blocks or alters control flow.
+    const bgRunId = isBackgroundWorker
+      ? (backgroundRunMarker?.runId as string)
+      : null;
+    const workerStep = (s: string) => {
+      if (bgRunId)
+        void recordRunDiagnostic(
+          bgRunId,
+          RUN_DIAG_STAGE.workerSetupStep,
+          `${s}=${Date.now() - setupT0}ms`,
+        ).catch(() => {});
+    };
     // Whether this worker is REALLY executing inside a 15-min Netlify
     // `-background` function (proven by the runtime function name), not merely a
     // `_process-run` re-entry that may have landed on the ~60s synchronous
@@ -4002,6 +4018,10 @@ export function createProductionAgentHandler(
         requestAttachments = preparedRequest.attachments;
       }
     }
+    // DIAGNOSTIC-ONLY: owner/request context prep (resolveAgentOwnerEmail +
+    // prepareRequest) finished. A worker stuck before this points at the
+    // owner/request-context awaits.
+    workerStep("db_request_ctx");
 
     // Pre-upload chat attachments (images AND files/PDFs) through the framework
     // file-upload provider (Builder.io by default). The model still sees the
@@ -4164,6 +4184,10 @@ export function createProductionAgentHandler(
     }
 
     setupMark("prepDone");
+    // DIAGNOSTIC-ONLY: engine/model/api-key resolution finished. A worker that
+    // reached db_request_ctx but not env_config hung in attachment upload or
+    // engine/model resolution.
+    workerStep("env_config");
     // Run all independent pre-send steps in parallel. Each of these hits
     // the DB or invokes an action; running them sequentially was the
     // single biggest contributor to pre-LLM latency.
@@ -4418,6 +4442,9 @@ export function createProductionAgentHandler(
       enrichedMessagePromise,
     ]);
     setupMark("ctxAll");
+    // DIAGNOSTIC-ONLY: all parallel context gathering (system prompt, screen,
+    // files, loop settings, enriched message) resolved.
+    workerStep("context_all");
 
     if (systemPromptError) {
       setResponseHeader(event, "Content-Type", "text/event-stream");
@@ -4446,6 +4473,8 @@ export function createProductionAgentHandler(
       options.initialToolNames,
     );
     setupMark("actions");
+    // DIAGNOSTIC-ONLY: action/tool resolution + engine-tool filtering finished.
+    workerStep("action_tool_setup");
     const requestSystemPrompt =
       requestMode === "plan"
         ? `${systemPrompt}\n\n${PLAN_MODE_SYSTEM_PROMPT}`
@@ -4557,6 +4586,9 @@ export function createProductionAgentHandler(
       }
     }
     setupMark("depsThread");
+    // DIAGNOSTIC-ONLY: owner/thread resolution + runId/effectiveThreadId +
+    // chained-continuation thread fetch finished.
+    workerStep("owner_thread");
 
     // Persist the user's turn exactly once. The foreground POST does this
     // before dispatching; the background worker must NOT repeat it (it re-enters
@@ -4971,6 +5003,9 @@ export function createProductionAgentHandler(
     // startRun's callback below — the run row does not exist until startRun
     // inserts it, so a pre-startRun write would no-op on the inline path.
     setupMark("preStart");
+    // DIAGNOSTIC-ONLY: last stage before startRun fires. A worker that reaches
+    // prestart but never workerStarted is hanging inside startRun itself.
+    workerStep("prestart");
     const setupDetail =
       Object.entries(setupMarks)
         .map(([k, v]) => `${k}=${v}`)

package/corpus/core/src/agent/run-store.ts

@@ -540,6 +540,8 @@ export const RUN_DIAG_STAGE = {
   workerClaimLost: "worker_claim_lost",
   /** The agent loop started (startRun fired). */
   workerStarted: "worker_started",
+  /** Last worker setup stage reached before startRun (progressive hang localizer). */
+  workerSetupStep: "worker_setup_step",
   /** Pre-claim setup timing breakdown (diagnostic). */
   setupTimings: "setup_timings",
   /** The worker threw before/while running the loop (message carried in detail). */

package/corpus/core/src/client/changelog/Changelog.tsx

@@ -24,16 +24,17 @@ import {
   useMarkdownReady,
   markdownUrlTransform,
 } from "../chat/markdown-renderer.js";
+import { DEFAULT_LOCALE, useOptionalLocale, type LocaleCode } from "../i18n.js";
 import { cn } from "../utils.js";
 
 // ─── Date formatting ──────────────────────────────────────────────────────────
 
-function formatEntryHeading(entry: ChangelogEntry): string {
+function formatEntryHeading(entry: ChangelogEntry, locale: LocaleCode): string {
   if (entry.date) {
     // Parse as a plain calendar date (avoid TZ shifting YYYY-MM-DD back a day).
     const [y, m, d] = entry.date.split("-").map(Number);
     if (y && m && d) {
-      const formatted = new Date(y, m - 1, d).toLocaleDateString(undefined, {
+      const formatted = new Date(y, m - 1, d).toLocaleDateString(locale, {
         year: "numeric",
         month: "long",
         day: "numeric",
@@ -170,6 +171,8 @@ function ChangelogEntries({
   entries: ChangelogEntry[];
   emptyText: string;
 }) {
+  const locale = useOptionalLocale()?.locale ?? DEFAULT_LOCALE;
+
   if (entries.length === 0) {
     return <p className="text-sm text-muted-foreground">{emptyText}</p>;
   }
@@ -178,7 +181,7 @@ function ChangelogEntries({
       {entries.map((entry) => (
         <section key={entry.id}>
           <h4 className="mb-2 text-sm font-semibold text-foreground">
-            {formatEntryHeading(entry)}
+            {formatEntryHeading(entry, locale)}
           </h4>
           <ChangelogBody markdown={entry.body} />
         </section>
@@ -196,6 +199,8 @@ export interface ChangelogDialogProps {
   markdown: string;
   /** Dialog heading. Default: "What's new". */
   title?: string;
+  closeLabel?: string;
+  emptyText?: string;
 }
 
 export function ChangelogDialog({
@@ -203,6 +208,8 @@ export function ChangelogDialog({
   onOpenChange,
   markdown,
   title = "What's new",
+  closeLabel = "Close",
+  emptyText = "No updates have been published yet.",
 }: ChangelogDialogProps) {
   const entries = useMemo(() => parseChangelog(markdown), [markdown]);
 
@@ -241,17 +248,14 @@ export function ChangelogDialog({
           <button
             type="button"
             onClick={() => onOpenChange(false)}
-            aria-label="Close"
+            aria-label={closeLabel}
             className="rounded-sm p-1 text-muted-foreground transition-colors hover:bg-accent hover:text-accent-foreground"
           >
             <IconX className="h-4 w-4" />
           </button>
         </div>
         <div className="overflow-y-auto px-5 py-4">
-          <ChangelogEntries
-            entries={entries}
-            emptyText="No updates have been published yet."
-          />
+          <ChangelogEntries entries={entries} emptyText={emptyText} />
         </div>
       </div>
     </div>
@@ -267,6 +271,9 @@ export interface ChangelogSettingsCardProps {
   limit?: number;
   /** Card heading. Default: "What's new". */
   title?: string;
+  closeLabel?: string;
+  emptyText?: string;
+  viewAllLabel?: string;
   className?: string;
 }
 
@@ -274,6 +281,9 @@ export function ChangelogSettingsCard({
   markdown,
   limit = 2,
   title = "What's new",
+  closeLabel = "Close",
+  emptyText = "No updates yet.",
+  viewAllLabel = "View all updates",
   className,
 }: ChangelogSettingsCardProps) {
   const entries = useMemo(() => parseChangelog(markdown), [markdown]);
@@ -296,14 +306,14 @@ export function ChangelogSettingsCard({
         <h3 className="text-sm font-semibold">{title}</h3>
       </div>
       <div className="px-5 py-4">
-        <ChangelogEntries entries={shown} emptyText="No updates yet." />
+        <ChangelogEntries entries={shown} emptyText={emptyText} />
         {hasMore && (
           <button
             type="button"
             onClick={() => setDialogOpen(true)}
             className="mt-4 text-sm font-medium text-foreground underline underline-offset-2"
           >
-            View all updates
+            {viewAllLabel}
           </button>
         )}
       </div>
@@ -312,6 +322,8 @@ export function ChangelogSettingsCard({
         onOpenChange={setDialogOpen}
         markdown={markdown}
         title={title}
+        closeLabel={closeLabel}
+        emptyText={emptyText}
       />
     </div>
   );