@agent-native/core 0.172.0 → 0.172.2

package/corpus/templates/calendar/changelog/2026-08-24-overlapping-events-use-space-better.md

@@ -2,4 +2,5 @@
 type: improved
 date: 2026-08-24
 ---
+
 Overlapping calendar events now use more of the available width while keeping same-time meetings readable.

package/dist/agent/production-agent.js

@@ -4431,6 +4431,12 @@ export async function runAgentLoop(opts) {
                         completedSideEffect: false,
                     });
                     recordToolResult(result, false);
+                    // Control is genuinely handed to the user here — the result above
+                    // tells the model "the turn is paused". `requestedActionStop` alone
+                    // does not stop anything until after the tool loop drains, so
+                    // without this the *rest* of this assistant message still executes
+                    // while the human is still looking at the approval card.
+                    turnYieldedToUser = true;
                     requestedActionStop ??= {
                         message: `Waiting for your approval to run ${toolCall.name}.`,
                         errorCode: "needs-approval",
@@ -5029,6 +5035,16 @@ export async function runAgentLoop(opts) {
             // call and break the model's intended sequencing.
             if (!entry)
                 return null;
+            // A call that can pause the turn must not share a batch. `flushParallelBatch`
+            // dispatches through `Promise.all`, so a gated call and its siblings all
+            // start before the gate is reached, and `turnYieldedToUser` would then be
+            // set too late to stop a sibling that already ran. Serializing here is what
+            // makes that flag mean anything for the calls after it. `needsApproval` may
+            // be an async predicate, so this cannot resolve whether approval is truly
+            // required — declaring it at all is enough to serialize.
+            if (entry.needsApproval !== undefined || entry.endsTurn === true) {
+                return null;
+            }
             if (entry.readOnly === true)
                 return "read";
             if (entry.parallelSafe === true)
@@ -5056,7 +5072,8 @@ export async function runAgentLoop(opts) {
         // as not executed rather than running them: a second `ask-question` would
         // overwrite the first one's card before anyone could answer it.
         const skipToolCallAfterYield = (toolCall) => {
-            const result = `Not executed: ${toolCall.name} was called after an action that ends the turn. ` +
+            const result = `Not executed: ${toolCall.name} was called after an action that paused the turn ` +
+                `(an action that ends the turn, or one waiting on the user's approval). ` +
                 `The turn is paused for the user's answer — call it again on a later turn if still needed.`;
             send({
                 type: "tool_start",

package/dist/agent-web/generator.d.ts

@@ -7,17 +7,40 @@ export interface AgentWebPage {
     markdownPath?: string;
     lastmod?: string | Date;
 }
+export interface AgentWebResource {
+    title: string;
+    url: string;
+    description?: string;
+}
+export interface AgentWebOrganization {
+    name: string;
+    url?: string;
+    sameAs?: string[];
+    contactPoint?: {
+        "@type": "ContactPoint";
+        contactType: string;
+        email?: string;
+        telephone?: string;
+        url?: string;
+    };
+    address?: {
+        "@type": "PostalAddress";
+        streetAddress?: string;
+        addressLocality?: string;
+        addressRegion?: string;
+        postalCode?: string;
+        addressCountry?: string;
+    };
+}
 export interface BuildAgentWebStaticFilesOptions {
     siteName: string;
     siteUrl: string;
     description?: string;
     pages: AgentWebPage[];
     config: AgentWebConfig;
-    organization?: {
-        name: string;
-        url?: string;
-        sameAs?: string[];
-    };
+    developerResources?: AgentWebResource[];
+    whenToUse?: string[];
+    organization?: AgentWebOrganization;
 }
 export interface AgentWebStaticFile {
     path: string;
@@ -43,17 +66,28 @@ export declare function buildBaseJsonLd(options: {
     siteName: string;
     siteUrl: string;
     description?: string;
-    organization?: {
-        name: string;
-        url?: string;
-        sameAs?: string[];
-    };
+    organization?: AgentWebOrganization;
 }): ({
     "@context": string;
     "@type": string;
     name: string;
     url: string;
     sameAs?: string[] | undefined;
+    contactPoint?: {
+        "@type": "ContactPoint";
+        contactType: string;
+        email?: string;
+        telephone?: string;
+        url?: string;
+    } | undefined;
+    address?: {
+        "@type": "PostalAddress";
+        streetAddress?: string;
+        addressLocality?: string;
+        addressRegion?: string;
+        postalCode?: string;
+        addressCountry?: string;
+    } | undefined;
 } | {
     "@context": string;
     "@type": string;

package/dist/agent-web/generator.js

@@ -91,11 +91,24 @@ ${entries}
 `;
 }
 export function buildLlmsTxt(options) {
+    const developerResources = options.developerResources ?? [];
+    const whenToUse = options.whenToUse ?? [];
     const lines = [
         `# ${options.siteName}`,
         "",
         options.description ? `> ${options.description}` : undefined,
         options.description ? "" : undefined,
+        whenToUse.length ? "## When to use this" : undefined,
+        ...whenToUse.map((instruction) => `- ${instruction}`),
+        whenToUse.length ? "" : undefined,
+        developerResources.length ? "## Developer resources" : undefined,
+        ...developerResources.map((resource) => {
+            const description = resource.description
+                ? `: ${resource.description}`
+                : "";
+            return `- [${resource.title}](${absoluteResourceUrl(options.siteUrl, resource.url)})${description}`;
+        }),
+        developerResources.length ? "" : undefined,
         "## Pages",
         ...options.pages.map((page) => {
             const description = page.description ? `: ${page.description}` : "";
@@ -110,11 +123,24 @@ export function buildLlmsTxt(options) {
     return `${lines.join("\n")}\n`;
 }
 export function buildLlmsFullTxt(options) {
+    const developerResources = options.developerResources ?? [];
+    const whenToUse = options.whenToUse ?? [];
     const lines = [
         `# ${options.siteName}`,
         "",
         options.description ?? "",
         "",
+        whenToUse.length ? "## When to use this" : undefined,
+        ...whenToUse.map((instruction) => `- ${instruction}`),
+        whenToUse.length ? "" : undefined,
+        developerResources.length ? "## Developer resources" : undefined,
+        ...developerResources.map((resource) => {
+            const description = resource.description
+                ? `: ${resource.description}`
+                : "";
+            return `- [${resource.title}](${absoluteResourceUrl(options.siteUrl, resource.url)})${description}`;
+        }),
+        developerResources.length ? "" : undefined,
         ...options.pages.flatMap((page) => [
             `## ${page.title}`,
             "",
@@ -141,6 +167,12 @@ export function buildBaseJsonLd(options) {
             ...(options.organization?.sameAs?.length
                 ? { sameAs: options.organization.sameAs }
                 : {}),
+            ...(options.organization?.contactPoint
+                ? { contactPoint: options.organization.contactPoint }
+                : {}),
+            ...(options.organization?.address
+                ? { address: options.organization.address }
+                : {}),
         },
         {
             "@context": "https://schema.org",
@@ -188,6 +220,7 @@ export function buildMarkdownResponseHeaders(options) {
     return {
         "content-type": "text/markdown; charset=utf-8",
         "x-markdown-tokens": String(estimateMarkdownTokens(options.markdown)),
+        vary: "Accept, Accept-Encoding",
         link: `<${absoluteUrl(options.siteUrl, "/llms.txt")}>; rel="llms-txt", <${absoluteUrl(options.siteUrl, markdownUrlForPage(options.pagePath, options.markdownPath))}>; rel="alternate"; type="text/markdown"`,
     };
 }
@@ -213,6 +246,11 @@ export function absoluteUrl(siteUrl, pagePath) {
     const path = normalizePagePath(pagePath);
     return `${base}${path}`;
 }
+function absoluteResourceUrl(siteUrl, resourceUrl) {
+    return /^https?:\/\//i.test(resourceUrl)
+        ? resourceUrl
+        : absoluteUrl(siteUrl, resourceUrl);
+}
 function normalizePagePath(pagePath) {
     const withSlash = pagePath.startsWith("/") ? pagePath : `/${pagePath}`;
     if (withSlash.length > 1 && withSlash.endsWith("/")) {

package/dist/agent-web/index.d.ts

@@ -1,2 +1,2 @@
 export { AGENT_WEB_CRAWLER_CATEGORIES, DEFAULT_AGENT_WEB_CRAWLER_POLICY, agentWebConfigFromPackageJson, deriveAgentWebPublicRoutes, normalizeAgentWebConfig, pathPatternMatches, resolveAgentWebCrawlerPolicy, type AgentWebConfig, type AgentWebCrawlerCategory, type AgentWebCrawlerDecision, type AgentWebCrawlerOverrides, type AgentWebCrawlerPolicy, type AgentWebInputConfig, type DeriveAgentWebPublicRoutesOptions, } from "./config.js";
-export { AGENT_WEB_CRAWLER_USER_AGENTS, absoluteUrl, buildAgentWebStaticFiles, buildBaseJsonLd, buildLlmsFullTxt, buildLlmsTxt, buildMarkdownResponseHeaders, buildPageJsonLd, buildRobotsTxt, buildSitemapXml, estimateMarkdownTokens, markdownFilePathForPage, markdownUrlForPage, type AgentWebPage, type AgentWebStaticFile, type BuildAgentWebStaticFilesOptions, type MarkdownResponseHeadersOptions, } from "./generator.js";
+export { AGENT_WEB_CRAWLER_USER_AGENTS, absoluteUrl, buildAgentWebStaticFiles, buildBaseJsonLd, buildLlmsFullTxt, buildLlmsTxt, buildMarkdownResponseHeaders, buildPageJsonLd, buildRobotsTxt, buildSitemapXml, estimateMarkdownTokens, markdownFilePathForPage, markdownUrlForPage, type AgentWebPage, type AgentWebOrganization, type AgentWebResource, type AgentWebStaticFile, type BuildAgentWebStaticFilesOptions, type MarkdownResponseHeadersOptions, } from "./generator.js";

package/dist/collab/routes.d.ts

@@ -26,8 +26,8 @@ export declare const getCollabState: import("h3").EventHandlerWithFetch<import("
  * Body: { update: string (base64), requestSource?: string }
  */
 export declare const postCollabUpdate: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
+    ok?: undefined;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/collab/struct-routes.d.ts

@@ -13,8 +13,8 @@
  * Body: { json: any, fieldName?: string, type?: "map"|"array", requestSource?: string }
  */
 export declare const postCollabJson: import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

package/dist/resources/handlers.d.ts

@@ -51,8 +51,8 @@ export declare function handleDeleteResource(event: any): Promise<{
     error: string;
     ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
+    error?: undefined;
 }>;
 /** POST /_agent-native/resources/upload — upload a file as a resource */
 export declare function handleUploadResource(event: any): Promise<import("./store.js").Resource | {
@@ -73,10 +73,10 @@ export declare function handleUploadResource(event: any): Promise<import("./stor
     runId: string | null;
     expiresAt: number | null;
     metadata: string | null;
-    error?: undefined;
     url: string;
     provider: string;
     storageSetupRequired?: undefined;
+    error?: undefined;
 } | {
     error: string;
     storageSetupRequired: 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;
 } | {
+    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;
 } | {
+    error?: undefined;
     ok: boolean;
     removed: boolean;
-    error?: undefined;
 }>>;

package/dist/vite/agent-web-plugin.d.ts

@@ -1,16 +1,14 @@
 import type { Plugin } from "vite";
-import { type AgentWebInputConfig, type AgentWebPage } from "../agent-web/index.js";
+import { type AgentWebInputConfig, type AgentWebOrganization, type AgentWebPage, type AgentWebResource } from "../agent-web/index.js";
 export interface AgentWebVitePluginOptions {
     siteName: string;
     siteUrl: string;
     description?: string;
     pages: AgentWebPage[] | (() => AgentWebPage[]);
+    developerResources?: AgentWebResource[];
+    whenToUse?: string[];
     agentWeb?: AgentWebInputConfig | boolean;
     outputDirs?: string[];
-    organization?: {
-        name: string;
-        url?: string;
-        sameAs?: string[];
-    };
+    organization?: AgentWebOrganization;
 }
 export declare function createAgentWebVitePlugin(options: AgentWebVitePluginOptions): Plugin;

package/dist/vite/agent-web-plugin.js

@@ -22,6 +22,8 @@ export function createAgentWebVitePlugin(options) {
                 description: options.description,
                 pages,
                 config,
+                developerResources: options.developerResources,
+                whenToUse: options.whenToUse,
                 organization: options.organization,
             });
             const outputDirs = options.outputDirs ?? [

package/package.json

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