@agent-native/core 0.176.4 → 0.176.5-nightly-20260902205402

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

@@ -329,8 +329,8 @@ export declare function createProviderApiActions(runtime: Pick<ProviderApiRuntim
         label?: undefined;
         message?: undefined;
     } | {
-        count?: undefined;
         id?: undefined;
+        count?: undefined;
         providers?: undefined;
         found: boolean;
         provider: import("../custom-registry.js").CustomProviderConfig;

package/dist/secrets/routes.d.ts

@@ -34,37 +34,37 @@ export declare function createListSecretsHandler(): import("h3").EventHandlerWit
 /** POST /_agent-native/secrets/:key — write a secret. */
 export declare function createWriteSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
     error: string;
-    ok?: undefined;
     status?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     status: string;
+    error?: undefined;
 } | {
-    ok?: undefined;
     error: string;
     removed?: undefined;
+    ok?: undefined;
 } | {
-    error?: undefined;
     ok: boolean;
     removed: boolean;
+    error?: undefined;
 }>>;
 /**
  * POST /_agent-native/secrets/:key/test — validate an optional candidate value
  * or the current stored value without changing anything.
  */
 export declare function createTestSecretHandler(): import("h3").EventHandlerWithFetch<import("h3").EventHandlerRequest, Promise<{
-    ok?: undefined;
     error: string;
     note?: undefined;
+    ok?: 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/action-routes.d.ts

@@ -65,6 +65,7 @@ export interface WebMcpManifestOptions {
     name: string;
     description: string;
     title?: string;
+    instructions?: string;
     version?: string;
     websiteUrl?: string;
     icons?: Array<{

package/dist/server/action-routes.js

@@ -6,6 +6,7 @@ import { declaresFeatureFlagDelegation } from "../feature-flags/a2a-action-route
 import { isFeatureFlagAdminEmail } from "../feature-flags/permissions.js";
 import { resolveOrgByDomain, resolveOrgIdForEmail } from "../org/context.js";
 import { readBody } from "../server/h3-helpers.js";
+import { agentNativeMcpInstructions, agentNativeToolTitle, } from "../shared/agent-mcp-metadata.js";
 import { EMBED_TARGET_HEADER } from "../shared/embed-auth.js";
 import { isMcpEmbedCorsOrigin, MCP_EMBED_CORS_ALLOW_HEADERS, shouldAllowMcpEmbedCredentials, } from "../shared/mcp-embed-headers.js";
 import { actionCallIsReadOnly, notifyActionChange } from "./action-change.js";
@@ -619,6 +620,7 @@ function buildWebMcpCompatibilityManifest(event, actions, options) {
         };
         return {
             name,
+            title: agentNativeToolTitle(name, entry.tool.title),
             description: entry.tool.description,
             parameters: inputSchema,
             inputSchema,
@@ -634,6 +636,7 @@ function buildWebMcpCompatibilityManifest(event, actions, options) {
         name: options?.name ?? "Agent",
         ...(options?.title ? { title: options.title } : {}),
         description: options?.description ?? "Agent-Native app agent",
+        instructions: agentNativeMcpInstructions(options?.instructions),
         version: options?.version ?? "1.0.0",
         ...(options?.websiteUrl ? { website_url: options.websiteUrl } : {}),
         ...(options?.icons ? { icons: options.icons } : {}),
@@ -684,6 +687,7 @@ export function mountWebMcpActionRoutes(nitroApp, actions, options) {
         setResponseHeader(event, "Cache-Control", "no-store");
         return Object.entries(eligible).map(([name, entry]) => ({
             name,
+            title: agentNativeToolTitle(name, entry.tool.title),
             description: entry.tool.description,
             inputSchema: entry.tool.parameters,
             readOnly: entry.readOnly === true,

package/dist/server/agent-chat/mcp-options.d.ts

@@ -70,6 +70,8 @@ export interface AgentChatMcpOptions {
     websiteUrl?: string;
     /** App icons. Relative `src` values are resolved against the request origin. */
     icons?: AgentChatMcpIcon[];
+    /** Additional host-facing guidance included in MCP initialization metadata. */
+    instructions?: string;
 }
 /** The legacy top-level keys `mcp` replaces. */
 export interface AgentChatMcpLegacyInput {
@@ -81,6 +83,7 @@ export interface AgentChatMcpLegacyInput {
         description?: string;
         websiteUrl?: string;
         icons?: AgentChatMcpIcon[];
+        instructions?: string;
     };
     /** @deprecated Use `mcp.connectorCatalog`. */
     connectorCatalog?: string[];
@@ -98,6 +101,7 @@ export interface ResolvedAgentChatMcp {
     description: string | undefined;
     websiteUrl: string | undefined;
     icons: AgentChatMcpIcon[] | undefined;
+    instructions: string | undefined;
 }
 /**
  * Collapse the nested `mcp` option and the legacy top-level keys into the one

package/dist/server/agent-chat/mcp-options.js

@@ -61,5 +61,6 @@ export function resolveAgentChatMcpOptions(input) {
         description: pick("description", "mcpServerInfo.description", legacyInfo?.description, mcp.description),
         websiteUrl: pick("websiteUrl", "mcpServerInfo.websiteUrl", legacyInfo?.websiteUrl, mcp.websiteUrl),
         icons: pick("icons", "mcpServerInfo.icons", legacyInfo?.icons, mcp.icons),
+        instructions: pick("instructions", "mcpServerInfo.instructions", legacyInfo?.instructions, mcp.instructions),
     };
 }

package/dist/server/agent-chat-plugin.js

@@ -1932,6 +1932,7 @@ export function createAgentChatPlugin(options) {
                     appId: options?.appId,
                     description: mcpOptions.description ??
                         `Agent-Native ${options?.appId ?? "app"} agent`,
+                    instructions: mcpOptions.instructions,
                     websiteUrl: mcpOptions.websiteUrl,
                     icons: mcpOptions.icons,
                     actions: externalActions,
@@ -2187,6 +2188,7 @@ export function createAgentChatPlugin(options) {
                     title: mcpOptions.title,
                     description: mcpOptions.description ??
                         `Agent-Native ${options?.appId ?? "app"} agent`,
+                    instructions: mcpOptions.instructions,
                     websiteUrl: mcpOptions.websiteUrl,
                     icons: mcpOptions.icons,
                 },

package/dist/server/realtime-token.d.ts

@@ -59,8 +59,8 @@ export declare function createRealtimeTokenHandler(): import("h3").EventHandlerW
     expiresAt?: undefined;
     ttlSeconds?: undefined;
 } | {
-    error?: undefined;
     token: string;
     expiresAt: string;
     ttlSeconds: number;
+    error?: undefined;
 }>>;

package/dist/server/social-og-image.js

@@ -10,11 +10,9 @@ export const AGENT_NATIVE_OG_IMAGE_CACHE_CONTROL = "public, max-age=60, stale-wh
 export const AGENT_NATIVE_OG_IMAGE_NETLIFY_CACHE_CONTROL = "public, durable, max-age=60, stale-while-revalidate=604800, stale-if-error=3600";
 const WIDTH = AGENT_NATIVE_OG_IMAGE_WIDTH;
 const HEIGHT = AGENT_NATIVE_OG_IMAGE_HEIGHT;
-const BRAND_BLUE = "#00B5FF";
-const BRAND_MINT = "#48FFE4";
-const BG = "#000000";
-const FG = "#f5f5f5";
-const GRID_SIZE = 48;
+const BG = "#0A0A0A";
+const FG = "#FAF9F5";
+const ACCENT_FG = "#9A9997";
 const DEFAULT_FONT_FAMILY = `${OG_FONT_FAMILY}, Arial, Helvetica, system-ui, sans-serif`;
 const ARABIC_FONT_FAMILY = `${OG_ARABIC_FONT_FAMILY}, ${OG_FONT_FAMILY}, Arial, Helvetica, system-ui, sans-serif`;
 const DEFAULT_ACCENT_TEXT = "100% free and open source";
@@ -23,8 +21,8 @@ const MAX_LOGO_BYTES = 2_000_000;
 const LOGO_CONTENT_TYPE_RE = /^image\/(?:png|jpe?g|gif|webp|svg\+xml)$/i;
 const LOGO_DATA_URL_RE = new RegExp(`^data:image\\/(?:png|jpe?g|gif|webp|svg\\+xml);base64,[A-Za-z0-9+/]+={0,2}$`, "i");
 const LOGO_MARK = `
-  <path d="M24.5537 65.7695H0L15.0859 39.4619L37.708 0L60.4912 39.4619H39.6396L24.5537 65.7695Z" fill="white"/>
-  <path d="M89.446 0H114L76.2921 65.7704H51.7383L89.446 0Z" fill="url(#brand)"/>
+  <path d="M26.8789 71.999H0L16.5146 43.1992L41.2793 0L66.2197 43.1992H43.3945L26.8789 71.999Z" fill="white"/>
+  <path d="M97.914 0H124.794L83.5143 72H56.6348L97.914 0Z" fill="white"/>
 `;
 function escapeSvg(value) {
     return value
@@ -399,19 +397,7 @@ export function renderAgentNativeOgImageSvg(input = {}) {
             : "";
     return `<svg xmlns="http://www.w3.org/2000/svg" width="${WIDTH}" height="${HEIGHT}" viewBox="0 0 ${WIDTH} ${HEIGHT}">
   <title>${escapeSvg(title)}${mode === "agent-native" ? " - Agent-Native preview" : " preview"}</title>
-  <defs>
-    ${mode === "agent-native"
-        ? `<linearGradient id="brand" x1="101.702" y1="67.4791" x2="113.672" y2="-37.4275" gradientUnits="userSpaceOnUse">
-      <stop stop-color="${BRAND_BLUE}"/>
-      <stop offset="1" stop-color="${BRAND_MINT}"/>
-    </linearGradient>`
-        : ""}
-    <pattern id="grid" width="${GRID_SIZE}" height="${GRID_SIZE}" patternUnits="userSpaceOnUse">
-      <path d="M 0 0.5 H ${GRID_SIZE} M 0.5 0 V ${GRID_SIZE}" fill="none" stroke="#ffffff" stroke-opacity="0.07" stroke-width="1"/>
-    </pattern>
-  </defs>
   <rect width="${WIDTH}" height="${HEIGHT}" fill="${BG}"/>
-  <rect width="${WIDTH}" height="${HEIGHT}" fill="url(#grid)"/>
   ${logo ? `<g transform="translate(80 116) scale(0.94)">${logo}</g>` : ""}
   <g>
     ${textBlock({
@@ -437,7 +423,7 @@ export function renderAgentNativeOgImageSvg(input = {}) {
             fontSize: 34,
             lineHeight: 40,
             weight: 800,
-            fill: BRAND_BLUE,
+            fill: ACCENT_FG,
             anchor: textAnchor,
             fontFamily: fontFamilyForText(accentText),
         })

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

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

package/dist/shared/agent-mcp-metadata.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_AGENT_NATIVE_MCP_INSTRUCTIONS = "This Agent-Native app exposes focused action tools. When the host supports page-local WebMCP, prefer the page's named tools over browser click/type automation for supported actions. For state-dependent work, call the app's current-screen or context read first; use the smallest matching mutation, then read back to verify the result.";
+export declare function agentNativeMcpInstructions(custom?: string): string;
+export declare function agentNativeToolTitle(name: string, title?: string): string;

package/dist/shared/agent-mcp-metadata.js

@@ -0,0 +1,18 @@
+export const DEFAULT_AGENT_NATIVE_MCP_INSTRUCTIONS = "This Agent-Native app exposes focused action tools. When the host supports page-local WebMCP, prefer the page's named tools over browser click/type automation for supported actions. For state-dependent work, call the app's current-screen or context read first; use the smallest matching mutation, then read back to verify the result.";
+export function agentNativeMcpInstructions(custom) {
+    const extra = custom?.trim();
+    return extra
+        ? `${DEFAULT_AGENT_NATIVE_MCP_INSTRUCTIONS}\n\nApp-specific guidance:\n${extra}`
+        : DEFAULT_AGENT_NATIVE_MCP_INSTRUCTIONS;
+}
+export function agentNativeToolTitle(name, title) {
+    const explicit = title?.trim();
+    if (explicit)
+        return explicit;
+    const readable = name
+        .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+        .replace(/[_.-]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    return readable ? readable[0].toUpperCase() + readable.slice(1) : name;
+}

package/dist/shared/social-meta.d.ts

@@ -7,7 +7,7 @@ export type SocialMetaDescriptor = {
     name: string;
     content: string;
 };
-export declare const AGENT_NATIVE_DEFAULT_SOCIAL_IMAGE = "https://cdn.builder.io/api/v1/image/assets%2FYJIGb4i01jvw0SRdL5Bt%2F9c533fed169648069bffaed652ec0897";
+export declare const AGENT_NATIVE_DEFAULT_SOCIAL_IMAGE = "https://cdn.builder.io/api/v1/image/assets%2FYJIGb4i01jvw0SRdL5Bt%2F9ff332b274a147229544c2bf5877a10d";
 export declare const AGENT_NATIVE_SOCIAL_IMAGE_PATH = "/_agent-native/og-image.png";
 export declare const AGENT_NATIVE_SOCIAL_IMAGE_CACHE_BUSTER = "font-text-v2";
 export declare const AGENT_NATIVE_SOCIAL_IMAGE_WIDTH = "1200";

package/dist/shared/social-meta.js

@@ -1,4 +1,4 @@
-export const AGENT_NATIVE_DEFAULT_SOCIAL_IMAGE = "https://cdn.builder.io/api/v1/image/assets%2FYJIGb4i01jvw0SRdL5Bt%2F9c533fed169648069bffaed652ec0897";
+export const AGENT_NATIVE_DEFAULT_SOCIAL_IMAGE = "https://cdn.builder.io/api/v1/image/assets%2FYJIGb4i01jvw0SRdL5Bt%2F9ff332b274a147229544c2bf5877a10d";
 export const AGENT_NATIVE_SOCIAL_IMAGE_PATH = "/_agent-native/og-image.png";
 export const AGENT_NATIVE_SOCIAL_IMAGE_CACHE_BUSTER = "font-text-v2";
 export const AGENT_NATIVE_SOCIAL_IMAGE_WIDTH = "1200";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-native/core",
-  "version": "0.176.4",
+  "version": "0.176.5-nightly-20260902205402",
   "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": {