@pylonsync/sdk 0.4.28 → 0.5.0

package/dist/index.d.ts

@@ -405,7 +405,7 @@ export interface RouteDefinition {
      * POST/PUT/PATCH/DELETE) — matched on its `path` for non-GET requests only,
      * never rendered as a page.
      */
-    kind?: "page" | "not-found" | "error" | "route" | "sitemap" | "robots" | "og-image";
+    kind?: "page" | "not-found" | "error" | "route" | "sitemap" | "robots" | "llms" | "og-image";
 }
 export declare function defineRoute(route: RouteDefinition): RouteDefinition;
 export interface InputFieldDefinition {
@@ -595,7 +595,7 @@ export interface ManifestRoute {
     component?: string;
     layouts?: string[];
     /** "not-found" / "error" boundaries, or "route" form handlers; omitted for normal pages. */
-    kind?: "page" | "not-found" | "error" | "route" | "sitemap" | "robots" | "og-image";
+    kind?: "page" | "not-found" | "error" | "route" | "sitemap" | "robots" | "llms" | "og-image";
 }
 export interface ManifestInputField {
     name: string;

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.4.28",
+  "version": "0.5.0",
   "type": "module",
   "main": "./src/index.ts",
   "types": "./dist/index.d.ts",

package/src/index.ts

@@ -533,6 +533,7 @@ export interface RouteDefinition {
     | "route"
     | "sitemap"
     | "robots"
+    | "llms"
     | "og-image";
 }
 
@@ -784,6 +785,7 @@ export interface ManifestRoute {
     | "route"
     | "sitemap"
     | "robots"
+    | "llms"
     | "og-image";
 }
 
@@ -1337,6 +1339,19 @@ export async function discoverAppRoutes(opts?: {
       kind: "robots",
     });
   }
+  // `app/llms.ts` → `/llms.txt` (llmstxt.org). Same shape as sitemap/robots:
+  // a default export returning structured data, serialized by the SSR runtime.
+  // It is the file an agent reads FIRST to decide whether this site is worth
+  // its context, so it earns a convention rather than a hand-written route.
+  const llmsMod = findModule(appDir, "llms");
+  if (llmsMod) {
+    dataRoutes.push({
+      path: "/llms.txt",
+      mode: "ssr",
+      component: llmsMod,
+      kind: "llms",
+    });
+  }
 
   // Dynamic OG image routes: `<segment>/opengraph-image` (root → just
   // `/opengraph-image`). Matched like a page (params flow through) but

package/src/route-discovery.test.ts

@@ -94,14 +94,38 @@ describe("discoverAppRoutes — opengraph-image convention", () => {
       "opengraph-image.tsx": OG,
       "sitemap.ts": "export default function S(){ return []; }",
       "robots.ts": "export default function R(){ return {}; }",
+      "llms.ts": "export default function L(){ return { title: 'x' }; }",
     });
     const routes = await discoverAppRoutes();
     const idx = (p: string) => routes.findIndex((r) => r.path === p);
     const dynamic = idx("/:orgSlug");
     expect(dynamic).toBeGreaterThan(-1);
-    for (const literal of ["/opengraph-image", "/sitemap.xml", "/robots.txt"]) {
+    for (const literal of [
+      "/opengraph-image",
+      "/sitemap.xml",
+      "/robots.txt",
+      "/llms.txt",
+    ]) {
       expect(idx(literal)).toBeGreaterThan(-1);
       expect(idx(literal)).toBeLessThan(dynamic);
     }
   });
+
+  test("app/llms.ts → /llms.txt", async () => {
+    app({
+      "page.tsx": PAGE,
+      "llms.ts": "export default function L(){ return { title: 'Acme' }; }",
+    });
+    const routes = await discoverAppRoutes();
+    const llms = routes.find((r) => r.kind === "llms");
+    expect(llms?.path).toBe("/llms.txt");
+    expect(llms?.mode).toBe("ssr");
+    expect(llms?.component).toMatch(/llms$/);
+  });
+
+  test("no app/llms.ts → no /llms.txt route", async () => {
+    app({ "page.tsx": PAGE });
+    const routes = await discoverAppRoutes();
+    expect(routes.some((r) => r.kind === "llms")).toBe(false);
+  });
 });