@agent-native/core 0.172.0 → 0.172.1

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/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/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/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<{
-    error: string;
     ok?: undefined;
+    error: string;
 } | {
     error?: undefined;
     ok: boolean;

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/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.1",
   "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": {