From fc57dc39469b71a337712ab2f17db122082eae0f Mon Sep 17 00:00:00 2001 From: Lexirieru Date: Fri, 13 Nov 2026 04:37:32 +0700 Subject: [PATCH 1/9] chore(docs): scaffold apps/docs, a Next.js app for docs.hellonear.xyz and trust.hellonear.xyz Next 16.4.4, React 19.3.1, TypeScript 6.0.3, every dependency pinned; bun.lock in format 1 like the rest of the repo. Stone & Lime tokens from apps/status, light and dark. scripts/build-content.mjs turns content/*.md into one JSON bundle so no route reads files at request time, and copies docs/openapi.json into public/. Tests: added later in this branch (bun run test, typecheck and next build all pass at the end of it). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e --- apps/docs/.gitignore | 5 + apps/docs/AGENTS.md | 9 + apps/docs/app/apple-icon.png | Bin 0 -> 2723 bytes apps/docs/app/favicon.ico | Bin 0 -> 2914 bytes apps/docs/app/globals.css | 187 +++++++++ apps/docs/app/icon.svg | 1 + apps/docs/app/layout.tsx | 23 ++ apps/docs/bun.lock | 599 ++++++++++++++++++++++++++++ apps/docs/lib/site.ts | 7 + apps/docs/next-env.d.ts | 7 + apps/docs/next.config.ts | 18 + apps/docs/package.json | 35 ++ apps/docs/scripts/build-content.mjs | 42 ++ apps/docs/tsconfig.json | 41 ++ 14 files changed, 974 insertions(+) create mode 100644 apps/docs/.gitignore create mode 100644 apps/docs/AGENTS.md create mode 100644 apps/docs/app/apple-icon.png create mode 100644 apps/docs/app/favicon.ico create mode 100644 apps/docs/app/globals.css create mode 100644 apps/docs/app/icon.svg create mode 100644 apps/docs/app/layout.tsx create mode 100644 apps/docs/bun.lock create mode 100644 apps/docs/lib/site.ts create mode 100644 apps/docs/next-env.d.ts create mode 100644 apps/docs/next.config.ts create mode 100644 apps/docs/package.json create mode 100644 apps/docs/scripts/build-content.mjs create mode 100644 apps/docs/tsconfig.json diff --git a/apps/docs/.gitignore b/apps/docs/.gitignore new file mode 100644 index 00000000..96538e7a --- /dev/null +++ b/apps/docs/.gitignore @@ -0,0 +1,5 @@ +tsconfig.tsbuildinfo +.vercel +.env* +lib/generated/ +public/openapi.json diff --git a/apps/docs/AGENTS.md b/apps/docs/AGENTS.md new file mode 100644 index 00000000..af3b7c84 --- /dev/null +++ b/apps/docs/AGENTS.md @@ -0,0 +1,9 @@ + + +## This is NOT the Next.js you know + +This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices. + +This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean. + + diff --git a/apps/docs/app/apple-icon.png b/apps/docs/app/apple-icon.png new file mode 100644 index 0000000000000000000000000000000000000000..7df2cef06b235dd062062eab4d86fe5df4a983aa GIT binary patch literal 2723 zcmd6p`#TegAICYj_2l-gL|AUq+^INdBgM=nrd*1dOGIwXq1bR(xz2>SC8l_CJ8~ko z%_Wp;i5A(hVPrFR6V3gyuYNlJ!g-$e=kk0$&-41}^L(Cn%5{{r#BurKA|fIZNCeE` zs5bnFV?Q0`x|&R15s~9ANZ3^;eBm-X(l!UD*tfQ7DVk~7ps3a;Rt>W%aXDpo&)KxO z_LVI97K>lq=;EmB!Maobp_=-FadU*Rd}9^HegzPJtcSIB?9M zkYl=6A1vWJ8}zVq8(4H}KYsstvL`TduW-PC{}0+g)PxHc5$_h&`OgYBoSb|oN}0g6 z5N7_B0We$D{1vx2PT|!71dX;gamNMZ=Y*u)Y{_|5$^3%$`Wh^B{jq5=O;A@Py#PP7 z--bgO%$b3xOKuH}h?cntNyN-mbVaI(+9D4X?>0~A14&hmffW{K>MuLwbTqtW@fjW< zf`huyu^g}>LzKu+>{mVj-p3=kKtPYwB)EdIJnkEKxQ5S0PJ(4FJy|<&;v$s<;>X$~L6GSec1_{0x8S0C2V>y7h97z+3fiUl z@ED}hg9lnm`nsFNSFn}Nmo+!RoD659KbD9k5(HXLsRD##sY(~cc5IO23iTQtecJW| zp8YwbM+JStBg~b)ZbAA00YY7sq(}xHyY0{WKpZWiv7I1Om0fnV)Ett=1#J3h#V8XT^$Fm1 zyy+sctF7#V;;@&!eEA$y95NOU;m#sKre!B|oftZ_6iazNXi%Bmm1gXvBKfZt_Jess zTL!hiAZe^XW-VNauq8sE2(SEf;4$~wg|Cp-D-h>0s&1Xlv&k~N-I>4&t-Wz0lYV(m zXCX_GtD)K420F*v-w`{DAZsdk0ioT{1u zNvVwaQTvUMkQ+FlU#jnDHQPEvF?#!(ie^f3a^LW|4wvRI->LS)QnXe&_uDjRoJw%= z^t86&ak=%_m4bwXvQpH`$0e1Okq5gHy#{v?65c-E)DYp@FOD&*kvBYnH><(}I`vaY zB&1nyQj#L%!CN{#!^z6GqK-pltq>gduoO!EO2v+Yu%S|Yp~vPq=Cn5S~GKKe&uGaym8$Q$btKZ*7i&O z4s_RUnp~j~qtgR9CK3B40dXV`B82llS)=vu-;t-n!otvKG(uwJgf*6*tJv1DXv0aw zw7pFK%sA0^tE{Y4rA#aG(ju{h`p;MOJ!qZcB4 zEg@Zte^bY^y-*sNg7Y;W%dERg_gKvOm}h>Pg6mszqhV9(Qwj?9ychmu{#0=k~>Xuzmj6#DuN8>L>ljz4h(w?e-pne)T=Q@VuNH@<;Ut zFLA4r!j?a42?XC5$Wu;)wmPbCIZRG4|4!#zs%(cI3i$kWx=FEXgGPJ2`FrdUKPf3G zy8@NnsiBuHCaXVWe{@nP7v{{hJUxiJR&Q5lInnH=a2J~W`+@uU((usM+-VRzVw7^d zJ78|2`FmV^JU~L;$<FSe9DF ztwMp!9^T&GDLqe01t}|g z^^jo0`NmV2^0!>wbCdX>z`!UTW3<1YPrm#MK+4YeOw@+Mgn@hx{-ejl-efCIY76?i zJeSM;KH9PG`pB2;O<<|x=RbEPO9dX*>vW5mhHaC*m8dlno~M9Yonmqe0beTYKxqY+ zd|L32eEO2I94fz_5Km0B0!S$iKyV%tqga~%`V5le*K)ClcTyhGOQ-8Y_oh~Qd-xYG zs&dkdPr@@4?fT0L=I#?Ol1QZGh@G|f-=@2|{hD9C4CKGrnTp*ztNG#UJNh%oPKt?W zWpy<+`p(KMI58=Sr0}}*H#A-{ATn|%=>9B&p~|g5Nlp$a|KeT7$ZPbgg@s=FWuYk)+RA=JY~mOOj%b8>jWd~uXDa*{ zVsO&hDsg>{D0bj%6ZXc|*6LITVad61oYrB(YSz}) zu8Plw!C-$Q(Yl+Mi3D`nl+;;0U0pU!_>d{V7#)SWzZ)M{H!|8a?l^P~l7W;?nV?e+ zuKCS2Q;a(d^Sj~GL*|LhGeq6arx$!U9B<^5KoMa2Xw&@c$rkZY5wZV_mIy}ugt|T1* literal 0 HcmV?d00001 diff --git a/apps/docs/app/favicon.ico b/apps/docs/app/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..ebdc91c3513c45925fb8a20da0438a6d1d692169 GIT binary patch literal 2914 zcmaJ>c{J2*8~%-DNM@mtHO9X0>rnP(P`1#7WZ&YoX2>@7$d)7{%h)2jN|;PzNy2N- zR_;6bcP^ zY|Z5`ZajkBt8Hyy@0Iu6*^i3c!R{=a6BUfucwo~uZM-mrwU69AiM%N$!}%Lja=;P{ z*%WbaHiE8hU)TozJ??-9)L2;8ys2GY*Y-(TyD))Nku^fJ3e?H6Ec;bg~qn z65MA5Xf#l%5>fSev3z3IBsfByElSo5#>ww|)Qs zea=5Tezm`jzHH4!9U)yg<2|{q)`EvSNRn>bjOQnTUCoT(mB>d2XI=GRB%>txJ;dGY z`$i1fwjMqZ0b7}YcueKvIdf#UTK_tEIG`lzaC>@M4U65$A2-)&pARMPXf5tw$w$SZ zFeWOOzGgQ?T3i|zQf*jLTJsi~(SPW5rSQ+B^wg*A!|_jkmoc`Y(%$K&0fxbOz^OZ4 zUt6E+`mA?Z&hwXL!+lurAUeLXR;KR_YO0ZTS8!~YWuY~}&9xtcN~C_SQVu~F9`xjt zczx|~9g!{rq`u=D9j`oM8~}vVW%R0~aJ{DtCUjH$D79z5nKS$%&Ieuds1#Je=d6;` z=G39HiO0VJ1Ko`Z-WBStyn zTbc29I5nn)eXkNmIyTMRbf0Tl?h`%jl40HXAz1U8`YylKJ=+GL+eL!UWX0ff4}N$# z=xR{&W5hrr3-Xt&NFaC$DV8b5IXy!XPQPmgxbGl=z z+G8M5Pbb-~CV>IL$!QR{bEc-2<%O8Icv;1&(Ck*Y-AM#U;bWMb-4L@xbjGDAuu{%# z36AdNX74rFX%|=vU9l1!OD!{-w(j~DXOIk>HC?q`;G&64@THBgTiWSD0sUnH&jn(m zkESspryNgGoOfP_{n0p<+89%VseNT3B>R&Ud7SetWhiNhO*;sDJxE4T%yXq&XiVV| zHKUi5a~HsLrQFk;l;*tmT|V_vXBG!4;caCVgO#qNA+ zwW~h2uz|U`xz5BcwFO5`eg@;AGWx5>()}gv)wSqJno$3h_LUonUT`C zpzyb}uh9KU1pr3vf2EDTagomsfg3H30n9&d_l%ecp#3Vg3T+fBnNMZr+utkq$=DRQ zoOuGcKlG8wt}OI<==T|xhp9M@?^bzj)8gyijDe`KHy0S^=@La$6W+0$e%g6mRs@gNBxSd2`l-@Axp_!~zj%W-&p z-J)9n6?dPhdjIW8-9q;Rd_@$2?CnrZ2{p9@Y|965Y!1G=!-nggTGc;%&6qDAo<`w^ zrxle2NrF~skGL=%Wftj=uip92I;?jQ<&es0{iq|!W>#)eth|l{ z;u-hH4c%IH%u0`vtg>nJ5Ki)VZLf6oXU5RaVJv~|l45g#-u1p?zGQ=Pw7MG*rI0&A zFX(wXGcSDg;mPaqH_IAIGVB`b#JXdt4cs5#S4tXo!Ca8YJ0B`mOq_oH?9E|N`2>>W zgPK@hUfpZBQJ<3h{p&>^={m|S5{aNp%*0LNBh{-mn^v|c8~b0XJjV8$mOpwRgD3~{ z^F@Fr;SR{6x&kDxYF47>zQB=`WjD8Rz{)2A(c}DvMy@v=k=LO+|KjtjPJ;mBh!)d#mw|B$}}j=t@Slaq$iiqF#uy zl1xP``TDL*)$8Pmh=pCIlTZ{vc*CqBVac=3!RUr?pWG|TRm;tW^YlkfU&6d}KrGg5 z^d2w~$j6wvH?P+8(Ch`gh<#E$SC^-*YJa!zM)jAV8iABGwl1ubSkg*QwlgAWV7-bT z?bAgLy|B+cqH#ZmeWSw)9UbiF=Vxr8KMgz_&i7X0CR+c3JoxV{@Ev4nx7A@wrn$=Dn?O6f9&lUP1)Jm8N|fMj>s9_jaJ~wsO|q0dP!{cQ-mX! z9i0UnMnevx6Kx%1Pt-Ox+7II9w!(Wyig#VDZERSyOJS_wM4`yGBNnt^x?ARq)~{H9 z(wa(oT;bQjiH{*h_fu0-MLwpaq*#UDaf?JTFZ)$}US)N8IhxDzMnP>oO^TCKhvDoU zQH#dTPCjE}V~(N3dQh{PwDgVMT=0@m0|Wcm+}tVtQQ4}9lGI0!EX(txq@)s#k6^l% zqoRG^(-e426=ghuCu>S&EsF0rusg8`;tToi@rpo$P)haKbU437(E+BlldnK{#TY4f z`{~oCSZ>xz`h1tgm!Ak_%cSJ1UW#1)LEn~cj7@}?-Rnf$W&WV5sJMGULCvrb!V#;jiY!Yj~u=J!bmNBS8A0GW7 zje%n;?Oay9Ix0(x&Xj>8?i{Q$OZJNM?jwHh8a2L5&+TiQs0`8HboANs=7keaYkn&e zfWCeyE?#fhd{(UytG*lzKHCZ}l^1A-9L@3*A^@tN^w}~p!_W7-dTYR5l~}nDsmbtN z#(8M$L8+42M~ h3 { margin: 0 0 8px; font-size: 13px; text-transform: uppercase; letter-spacing: 0.6px; color: var(--muted); } +.faq-q { background: var(--card); border: 1px solid var(--border); border-radius: 12px; margin-bottom: 8px; } +.faq-q summary { cursor: pointer; padding: 14px 16px; font-weight: 600; list-style: none; display: flex; justify-content: space-between; gap: 12px; } +.faq-q summary::-webkit-details-marker { display: none; } +.faq-q summary::after { content: "+"; color: var(--muted); font-weight: 400; } +.faq-q[open] summary::after { content: "−"; } +.faq-q summary .anchor { position: static; opacity: 0; margin-left: auto; } +.faq-q summary:hover .anchor { opacity: 1; } +.faq-q .prose { padding: 0 16px 6px; } + +@media (max-width: 860px) { + .docs { display: block; } + .sidebar { display: none; } + .mobile-nav { display: block; border-bottom: 1px solid var(--border); padding: 0 16px; } + .mobile-nav summary { cursor: pointer; padding: 12px 0; font-weight: 600; } + .mobile-nav nav { padding-bottom: 12px; } + .doc { padding: 24px 16px 48px; } + .doc h1 { font-size: 26px; } + .anchor { display: none; } + .topbar-links { gap: 12px; } + .hero h1 { font-size: 28px; } +} +@media (max-width: 520px) { + .topbar-links:not(.buttons) a:last-child { display: none; } + .trust .topbar-links .btn:nth-child(2) { display: none; } + .brand-sub { display: none; } + .cards { grid-template-columns: 1fr; } +} diff --git a/apps/docs/app/icon.svg b/apps/docs/app/icon.svg new file mode 100644 index 00000000..0f11bfa2 --- /dev/null +++ b/apps/docs/app/icon.svg @@ -0,0 +1 @@ + diff --git a/apps/docs/app/layout.tsx b/apps/docs/app/layout.tsx new file mode 100644 index 00000000..8c0ebbe3 --- /dev/null +++ b/apps/docs/app/layout.tsx @@ -0,0 +1,23 @@ +import type { Metadata } from "next"; +import { Geist, Geist_Mono } from "next/font/google"; +import { SITE_URL } from "@/lib/site"; +import "./globals.css"; + +const geist = Geist({ subsets: ["latin"], variable: "--font-geist" }); +const geistMono = Geist_Mono({ subsets: ["latin"], variable: "--font-geist-mono" }); + +export const metadata: Metadata = { + metadataBase: new URL(SITE_URL), + title: { default: "HelloNear Docs", template: "%s · HelloNear" }, + description: "Documentation for HelloNear: AI agents on NEAR whose money rules sit outside the model.", + openGraph: { type: "website", siteName: "HelloNear" }, + alternates: { types: { "text/plain": "/llms.txt" } }, +}; + +export default function RootLayout({ children }: { children: React.ReactNode }) { + return ( + + {children} + + ); +} diff --git a/apps/docs/bun.lock b/apps/docs/bun.lock new file mode 100644 index 00000000..bc03d7a5 --- /dev/null +++ b/apps/docs/bun.lock @@ -0,0 +1,599 @@ +{ + "lockfileVersion": 1, + "configVersion": 1, + "workspaces": { + "": { + "name": "@hellonear/docs", + "dependencies": { + "marked": "18.1.2", + "next": "16.4.4", + "react": "19.3.1", + "react-dom": "19.3.1", + "swagger-ui-react": "5.34.0", + }, + "devDependencies": { + "@types/node": "26.6.6", + "@types/react": "19.3.0", + "@types/react-dom": "19.3.0", + "@types/swagger-ui-react": "5.18.0", + "tsx": "4.23.15", + "typescript": "6.0.3", + }, + }, + }, + "packages": { + "@babel/runtime": ["@babel/runtime@7.29.14", "", {}, "sha512-Y5tqevQaUAZhhj82BpYMNC1ssvLQTVAfwKdm8iy8qwmhvC2/CpcAu8OC+QEtjM7pMk7knx83u1Qj8gzkicyelw=="], + + "@babel/runtime-corejs3": ["@babel/runtime-corejs3@7.29.14", "", { "dependencies": { "core-js-pure": "^3.48.0" } }, "sha512-uMYNeB6qoKZZBjbjFglzmViaPlIIbmsP70tsaVWUc9bNLZP0btWlnKTY7cEf3mgsaVLe/vby2kfdptiVkpA1vw=="], + + "@emnapi/runtime": ["@emnapi/runtime@1.11.3", "", { "dependencies": { "tslib": "^2.4.0" } }, "sha512-Xz4Tpyki7XyrpbUK1jR1AhdAdaXyhhY4lZ3neLodmhpuWfy2PAQN5B46sAiU4liOXGLkHypn/qU+jvfWSCYYLA=="], + + "@esbuild/aix-ppc64": ["@esbuild/aix-ppc64@0.28.2", "", { "os": "aix", "cpu": "ppc64" }, "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ=="], + + "@esbuild/android-arm": ["@esbuild/android-arm@0.28.2", "", { "os": "android", "cpu": "arm" }, "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg=="], + + "@esbuild/android-arm64": ["@esbuild/android-arm64@0.28.2", "", { "os": "android", "cpu": "arm64" }, "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A=="], + + "@esbuild/android-x64": ["@esbuild/android-x64@0.28.2", "", { "os": "android", "cpu": "x64" }, "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q=="], + + "@esbuild/darwin-arm64": ["@esbuild/darwin-arm64@0.28.2", "", { "os": "darwin", "cpu": "arm64" }, "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw=="], + + "@esbuild/darwin-x64": ["@esbuild/darwin-x64@0.28.2", "", { "os": "darwin", "cpu": "x64" }, "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw=="], + + "@esbuild/freebsd-arm64": ["@esbuild/freebsd-arm64@0.28.2", "", { "os": "freebsd", "cpu": "arm64" }, "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw=="], + + "@esbuild/freebsd-x64": ["@esbuild/freebsd-x64@0.28.2", "", { "os": "freebsd", "cpu": "x64" }, "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg=="], + + "@esbuild/linux-arm": ["@esbuild/linux-arm@0.28.2", "", { "os": "linux", "cpu": "arm" }, "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w=="], + + "@esbuild/linux-arm64": ["@esbuild/linux-arm64@0.28.2", "", { "os": "linux", "cpu": "arm64" }, "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug=="], + + "@esbuild/linux-ia32": ["@esbuild/linux-ia32@0.28.2", "", { "os": "linux", "cpu": "ia32" }, "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ=="], + + "@esbuild/linux-loong64": ["@esbuild/linux-loong64@0.28.2", "", { "os": "linux", "cpu": "none" }, "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ=="], + + "@esbuild/linux-mips64el": ["@esbuild/linux-mips64el@0.28.2", "", { "os": "linux", "cpu": "none" }, "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA=="], + + "@esbuild/linux-ppc64": ["@esbuild/linux-ppc64@0.28.2", "", { "os": "linux", "cpu": "ppc64" }, "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ=="], + + "@esbuild/linux-riscv64": ["@esbuild/linux-riscv64@0.28.2", "", { "os": "linux", "cpu": "none" }, "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA=="], + + "@esbuild/linux-s390x": ["@esbuild/linux-s390x@0.28.2", "", { "os": "linux", "cpu": "s390x" }, "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg=="], + + "@esbuild/linux-x64": ["@esbuild/linux-x64@0.28.2", "", { "os": "linux", "cpu": "x64" }, "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ=="], + + "@esbuild/netbsd-arm64": ["@esbuild/netbsd-arm64@0.28.2", "", { "os": "none", "cpu": "arm64" }, "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw=="], + + "@esbuild/netbsd-x64": ["@esbuild/netbsd-x64@0.28.2", "", { "os": "none", "cpu": "x64" }, "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw=="], + + "@esbuild/openbsd-arm64": ["@esbuild/openbsd-arm64@0.28.2", "", { "os": "openbsd", "cpu": "arm64" }, "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ=="], + + "@esbuild/openbsd-x64": ["@esbuild/openbsd-x64@0.28.2", "", { "os": "openbsd", "cpu": "x64" }, "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw=="], + + "@esbuild/openharmony-arm64": ["@esbuild/openharmony-arm64@0.28.2", "", { "os": "none", "cpu": "arm64" }, "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q=="], + + "@esbuild/sunos-x64": ["@esbuild/sunos-x64@0.28.2", "", { "os": "sunos", "cpu": "x64" }, "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g=="], + + "@esbuild/win32-arm64": ["@esbuild/win32-arm64@0.28.2", "", { "os": "win32", "cpu": "arm64" }, "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ=="], + + "@esbuild/win32-ia32": ["@esbuild/win32-ia32@0.28.2", "", { "os": "win32", "cpu": "ia32" }, "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA=="], + + "@esbuild/win32-x64": ["@esbuild/win32-x64@0.28.2", "", { "os": "win32", "cpu": "x64" }, "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g=="], + + "@img/colour": ["@img/colour@1.1.0", "", {}, "sha512-Td76q7j57o/tLVdgS746cYARfSyxk8iEfRxewL9h4OMzYhbW4TAcppl0mT4eyqXddh6L/jwoM75mo7ixa/pCeQ=="], + + "@img/sharp-darwin-arm64": ["@img/sharp-darwin-arm64@0.35.5", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-arm64": "1.3.4" }, "os": "darwin", "cpu": "arm64" }, "sha512-QRUlFQ0WxvdWyqqG/WtI3iupfD5rBzmCHXSdPsY91sAtVtTo7Q4cb6zOccZ3gqEqkr0f1As1ehLqmEpDsRf+lg=="], + + "@img/sharp-darwin-x64": ["@img/sharp-darwin-x64@0.35.5", "", { "optionalDependencies": { "@img/sharp-libvips-darwin-x64": "1.3.4" }, "os": "darwin", "cpu": "x64" }, "sha512-+BR255RhDlpygUpOc/Jdt1nT6DQ3XG/ERo5wbcdOf5Q320dKtPCKPLR1LJs9VGXRaMa8l1uUa0tkCNOXiAxZUw=="], + + "@img/sharp-freebsd-wasm32": ["@img/sharp-freebsd-wasm32@0.35.5", "", { "dependencies": { "@img/sharp-wasm32": "0.35.5" }, "os": "freebsd" }, "sha512-Y/z91nEZ4uIBX5X3nfTovjU9lHNKFYbL2lpHCLVNmXQK03VIZvXBBt0KxbPGp2SdGSF+2mQU4e+hQaWOt86iAw=="], + + "@img/sharp-libvips-darwin-arm64": ["@img/sharp-libvips-darwin-arm64@1.3.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-5R89nBYiRdUlSWJxPhO+GVtaXzXSxKnRu/xqMn3KTA3L9EB9Oy/P+Nn2f2vlhPuUdy/Zusb2DarbyTpGCfEDuw=="], + + "@img/sharp-libvips-darwin-x64": ["@img/sharp-libvips-darwin-x64@1.3.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-iR2OKH80yi0U+dUplyh3/xdpFvps6YkCwsXenIJxqxR1v9o+xtKTGbS9H7cps+2Vxjc8B1j96p75NmTGjIhtpQ=="], + + "@img/sharp-libvips-linux-arm": ["@img/sharp-libvips-linux-arm@1.3.4", "", { "os": "linux", "cpu": "arm" }, "sha512-LmRtTsOHuvM2+wlO2Db37dx5MiZhB0FvSunciw48YjdOkZz9KAiRbm8ujeMOA1INqmei5NapFxYEK1D1ZSidmw=="], + + "@img/sharp-libvips-linux-arm64": ["@img/sharp-libvips-linux-arm64@1.3.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-Y3dgX/6lE2QhQb+Gxy0WZxfg9MEm/JBjamZpS2IklP7xIQoKN4hzAm7KcMVGtaVDt3neE9OKBC7vAfonA/Lr1A=="], + + "@img/sharp-libvips-linux-ppc64": ["@img/sharp-libvips-linux-ppc64@1.3.4", "", { "os": "linux", "cpu": "ppc64" }, "sha512-Le6boB8Tai0Nis+gIxIpKx68UDVVIqdR8Tin5Yf1z2LJJQLDJvCDRqRu+jC2qCoD+eIomonmOwB4smBRxfVpYQ=="], + + "@img/sharp-libvips-linux-riscv64": ["@img/sharp-libvips-linux-riscv64@1.3.4", "", { "os": "linux", "cpu": "none" }, "sha512-aHkkIEHPRdQEegJN20MLmGtxYD9R2wQr3Cwpddnu5+YKMt6Uzax7S9h5gpZTo8wyrGuZSlfQ63OevL5mTyOC7Q=="], + + "@img/sharp-libvips-linux-s390x": ["@img/sharp-libvips-linux-s390x@1.3.4", "", { "os": "linux", "cpu": "s390x" }, "sha512-ra/mB6MikESDUO7Yg+Mi95bFBb9GsObURuhnOv3OqknjGe9sZrG8tCe9q0xSIGrtLgvgw0gKnFWcK4blSgQOuQ=="], + + "@img/sharp-libvips-linux-x64": ["@img/sharp-libvips-linux-x64@1.3.4", "", { "os": "linux", "cpu": "x64" }, "sha512-GJ//SSXbnwSDes02umB3nDJLFcQzw8a18V8fyhqr6tV515tOEMdImjjxj1AoafMRz56F3PHgftnj1QEKSU1zkw=="], + + "@img/sharp-libvips-linuxmusl-arm64": ["@img/sharp-libvips-linuxmusl-arm64@1.3.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-hvulFwtjUcagsis6BBxHwGFwWoNZjgYmULGVrZcyfNbjA8hKILbRxGg15/7w5HDyXHXUos/j6baAWqnCyQ2DWA=="], + + "@img/sharp-libvips-linuxmusl-x64": ["@img/sharp-libvips-linuxmusl-x64@1.3.4", "", { "os": "linux", "cpu": "x64" }, "sha512-6zXKeE/p39I1AmA3cJG35eyBGNqNddLnUXjhwBnsGjFPWqf5VKkDBEqaEkPDoTEtkxwi2vv8Tcr2mDyP4So7Fg=="], + + "@img/sharp-linux-arm": ["@img/sharp-linux-arm@0.35.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm": "1.3.4" }, "os": "linux", "cpu": "arm" }, "sha512-LEaXK2WdXVK5ykcw0buWyPMsmLLL2vpHLD6yrNSW+JGEL3BZPA4tpKN6iaMc4AxTTAoaX/sU1rOL51lcIz48ZQ=="], + + "@img/sharp-linux-arm64": ["@img/sharp-linux-arm64@0.35.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-arm64": "1.3.4" }, "os": "linux", "cpu": "arm64" }, "sha512-LYVx5JTsOM2CBzmxreh+nl64/3H6Xb09iSLknqH47z2T2DFFxDeFLP5y4dJwe6H7uGQlHPyEEtIqyo3DYsRwdQ=="], + + "@img/sharp-linux-ppc64": ["@img/sharp-linux-ppc64@0.35.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-ppc64": "1.3.4" }, "os": "linux", "cpu": "ppc64" }, "sha512-QVxAAq8evVRI9ia2vqgwrmWucn5Dfv+JdWzj75pD8omHLPSP7f8p20O8jxzjCcuCEQEOtYOZUmX1hkiZ0kdevA=="], + + "@img/sharp-linux-riscv64": ["@img/sharp-linux-riscv64@0.35.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-riscv64": "1.3.4" }, "os": "linux", "cpu": "none" }, "sha512-LtdreXguaavKODPIfzJ4kffx7UNt1omwtK0rch4EBbbSTXPnxWmYSayXdLJw0fJzQ97kHt1gL/yh4tvU+nCyRQ=="], + + "@img/sharp-linux-s390x": ["@img/sharp-linux-s390x@0.35.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-s390x": "1.3.4" }, "os": "linux", "cpu": "s390x" }, "sha512-UZasTOFiYzotTsGOCu42BfUzP6Tu6Do/947iRm1RsLKvlllxwGcn4RN27LibGWceix4Y+Pmw3jsnTcCQIgWjqA=="], + + "@img/sharp-linux-x64": ["@img/sharp-linux-x64@0.35.5", "", { "optionalDependencies": { "@img/sharp-libvips-linux-x64": "1.3.4" }, "os": "linux", "cpu": "x64" }, "sha512-SxFtLTeJInhAA9Q836kux2vZNeOBQEx658qvbboZScr0wIARym3IcGmW7KpVD5sbVg0Ojy+udFQdayYIZyoNog=="], + + "@img/sharp-linuxmusl-arm64": ["@img/sharp-linuxmusl-arm64@0.35.5", "", { "optionalDependencies": { "@img/sharp-libvips-linuxmusl-arm64": "1.3.4" }, "os": "linux", "cpu": "arm64" }, "sha512-9HbMclmI1zlNkFRs3z9/eBtDjfD0sGlrX1z6b1qwmiFY5ElDLh4BC0LPBdVp7z1DXFiKlIcznf+ZlsuZzLxQqg=="], + + "@img/sharp-linuxmusl-x64": ["@img/sharp-linuxmusl-x64@0.35.5", "", { "optionalDependencies": { "@img/sharp-libvips-linuxmusl-x64": "1.3.4" }, "os": "linux", "cpu": "x64" }, "sha512-4KOphqB035HrVdqLZfCgMzzERrQkkzOwRhl4OAkRO1YCldbaFjySXMaK534Mo0V+LndnlJk+sbUyLeU0ULyD1A=="], + + "@img/sharp-wasm32": ["@img/sharp-wasm32@0.35.5", "", { "dependencies": { "@emnapi/runtime": "^1.11.3" } }, "sha512-Ptsga1su4tQx+LLF1ECS9U6nz5kmrXKo6XVbtR48Ke3ZRxxgaWBu7IDtEe1quo8hiupwm6WFqxVlXaSf7IINGQ=="], + + "@img/sharp-webcontainers-wasm32": ["@img/sharp-webcontainers-wasm32@0.35.5", "", { "dependencies": { "@img/sharp-wasm32": "0.35.5" }, "cpu": "none" }, "sha512-hfhF/FmoQyTUkA0bIKFOtw536BQSeBMe6BF6QyWlrPxT754+TFLaZ7sKKTfvvM0yJgKgaYTwnFCIZ/GuDw5SUA=="], + + "@img/sharp-win32-arm64": ["@img/sharp-win32-arm64@0.35.5", "", { "os": "win32", "cpu": "arm64" }, "sha512-X4t7g+7ZA5DKblCBEXGjUqqemj4vczING/5viFwAL8h4N3qYeyjwdCvRLHi4EdOUI+2Z7UFlp1VM+p/AuEtm6Q=="], + + "@img/sharp-win32-ia32": ["@img/sharp-win32-ia32@0.35.5", "", { "os": "win32", "cpu": "ia32" }, "sha512-5Zm82LoBc43nhwNybZlG7Y1KO//Zhsn306fQl29ZOuStHLGTo3BWL83q3cznX0poxSAMuYL1On/BHBxkBeKr6A=="], + + "@img/sharp-win32-x64": ["@img/sharp-win32-x64@0.35.5", "", { "os": "win32", "cpu": "x64" }, "sha512-x76eH0vEiHlcMQu8Y8IenntaACtddpT6W0wmXtWrnKcnKI7ME5DdgqhAD6SEWOEl1v2zDvkZDhFA9KnURwpfqg=="], + + "@next/env": ["@next/env@16.4.4", "", {}, "sha512-6/3ZuELR0tPLgNigvv8d/LAmfLIo1IpNfvrI/AHCAl9w9D0DNVGQGvo+OLPzAWR+WMW3vVyO7HaW0kfL97huBg=="], + + "@next/swc-darwin-arm64": ["@next/swc-darwin-arm64@16.4.4", "", { "os": "darwin", "cpu": "arm64" }, "sha512-1KlZ5IJ7zcLBZvqG1q7nuRWm2LAAN4C3iBqqoBCRRl1UEv0A4k6Rek+x3j23UiWf8Gz+VsN+M/LylAWkxpm2mg=="], + + "@next/swc-darwin-x64": ["@next/swc-darwin-x64@16.4.4", "", { "os": "darwin", "cpu": "x64" }, "sha512-Tb7efFdhbS/ph74RS7wob84gXGM58qxoO/WrkiMsTmy/JZktKOKBeiM45W0E/b8JfBzZJdexQqSmvedBwDK0PA=="], + + "@next/swc-linux-arm64-gnu": ["@next/swc-linux-arm64-gnu@16.4.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-wojSfLnH8RRImhtbcn3Dlx9JICh6aQHgDA33XDr+EPua2tt7Q/yjDn0FTAbqfNlLrBmOASAGhLh6NvBk9L3gzw=="], + + "@next/swc-linux-arm64-musl": ["@next/swc-linux-arm64-musl@16.4.4", "", { "os": "linux", "cpu": "arm64" }, "sha512-zgxpGOZaR+2O6dOk5ZAUkKgH92ZtqNg3ohzyg2HmWc2N+AZH4dEpTwdpB0e5MR9YRVdVDUkEM5g6c3TWWn8g1g=="], + + "@next/swc-linux-x64-gnu": ["@next/swc-linux-x64-gnu@16.4.4", "", { "os": "linux", "cpu": "x64" }, "sha512-fg3Wr030Y3BDkCXi6HGsPz0BUPTGZJS8TZSrCO0tS3O/KBsCyx4eP6aeaizCpGmcUKhtb4l7JoMc88QO2qBl2g=="], + + "@next/swc-linux-x64-musl": ["@next/swc-linux-x64-musl@16.4.4", "", { "os": "linux", "cpu": "x64" }, "sha512-40cr71PSdCV9zU2g0B1XG27af10tYU+9g8F+FtF3qSguQg0jSZDoxn0NrAvgFQ0cy9s0ZBA/00P9g/XL1O43xg=="], + + "@next/swc-win32-arm64-msvc": ["@next/swc-win32-arm64-msvc@16.4.4", "", { "os": "win32", "cpu": "arm64" }, "sha512-vFMiEbRZ+LYNeswslf4LuGuoPHE8JbtqV0GnmzbpnGNMs0uWaR2q98hu8M/UWGycNJERBXIUss+BGd3PIJ8VZg=="], + + "@next/swc-win32-x64-msvc": ["@next/swc-win32-x64-msvc@16.4.4", "", { "os": "win32", "cpu": "x64" }, "sha512-jy2P4V8BDZ+CFCzYABHYRZ1CmyFhfmYe22i8KA4uEafdYPrUjJ3Ot+lx265mLWLHiZRIfBzCn3V1F17m0vzl9Q=="], + + "@scarf/scarf": ["@scarf/scarf@1.4.0", "", {}, "sha512-xxeapPiUXdZAE3che6f3xogoJPeZgig6omHEy1rIY5WVsB3H2BHNnZH+gHG6x91SCWyQCzWGsuL2Hh3ClO5/qQ=="], + + "@swagger-api/apidom-ast": ["@swagger-api/apidom-ast@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-error": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "unraw": "^3.0.0" } }, "sha512-yzKA1z63/YL/bT50axexISPwQpQC7Vtl+OBVGMktz9lQgKpQTudKEp/k4c3D61jOS5YWKtu2UzcB65l/AY+0mQ=="], + + "@swagger-api/apidom-core": ["@swagger-api/apidom-core@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-ast": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@types/ramda": "~0.30.0", "minim": "~0.23.8", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "short-unique-id": "^5.3.2", "ts-mixer": "^6.0.3" } }, "sha512-4BCnyq7P7ZJZawZpIt0tw/OGgiTYsfZ5nCq+9az0hHQWyQ/C7nbYzjeCoY+gMGlO33S/CIlzkJL7nL7xv4rijA=="], + + "@swagger-api/apidom-error": ["@swagger-api/apidom-error@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.20.7" } }, "sha512-LiuN9xv+qM1w+zrYXTg94uZSKtzMQp64fiKxU8CZW/psfyj+/5RUt3bn+tHzoVuaN8XPLyvCafCchZ8MKTcvEA=="], + + "@swagger-api/apidom-json-pointer": ["@swagger-api/apidom-json-pointer@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@swaggerexpert/json-pointer": "^2.10.1" } }, "sha512-lxBGROkikKtqe8WyXSczRSttwKp79jqNiJ2KK6OsuWxe+3ehic2dzvC+xKXgIiSkGjYRV3saSa2OcwvcqSWOuQ=="], + + "@swagger-api/apidom-ns-a2a-1": ["@swagger-api/apidom-ns-a2a-1@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.3" } }, "sha512-Dz/z444nTMr2n4cGHhf7fuBdX6dI+rsS65651NLmD52oFENRkklMgWcfwZqBWp8u87oLsCf8ZS0vqiaU6myLfQ=="], + + "@swagger-api/apidom-ns-api-design-systems": ["@swagger-api/apidom-ns-api-design-systems@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-1": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.3" } }, "sha512-p9GfaYZvNGMVuSy89IGeeyod+RFfKma+znrv1N4Id/QLBe0VLisnmqf/wKNWCpK8FE0uZqxvuFRUMj2eOuGnfQ=="], + + "@swagger-api/apidom-ns-arazzo-1": ["@swagger-api/apidom-ns-arazzo-1@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-json-schema-2020-12": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.3" } }, "sha512-UIjdwgBCkOJYXxjmCulnvRjocJW0uhg2OXUS7FzKMXf0O3EeK3ChUoyOYgfSsQ8x6oF7uWbpSy4geSezCikj1Q=="], + + "@swagger-api/apidom-ns-asyncapi-2": ["@swagger-api/apidom-ns-asyncapi-2@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-json-schema-draft-7": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.3" } }, "sha512-MTJZk9Dpg9maey3eHg7D4t1Hl8i0pK8PrqXhmMGNiyKGMLSVmZeIZMC89fJVUZFn6zEcYAGE9dq0oAR4V17n5Q=="], + + "@swagger-api/apidom-ns-asyncapi-3": ["@swagger-api/apidom-ns-asyncapi-3@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-asyncapi-2": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.3" } }, "sha512-oxRxbEaZ019N2hYQh7TQT5JyyWFaenwx0nCE8wGUCYVeXAnH5BH8SCOxJgi51++N1Ro+mFtP6+D26GyFLl1asA=="], + + "@swagger-api/apidom-ns-json-schema-2019-09": ["@swagger-api/apidom-ns-json-schema-2019-09@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@swagger-api/apidom-ns-json-schema-draft-7": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.4" } }, "sha512-jHE49ethyReHw0krjIx+pi0gEESNCCjVxuEp1ZvdVun7a+KIBJwp9koHVxO+GPlXBeg/accV2WK0ASGiwXffQA=="], + + "@swagger-api/apidom-ns-json-schema-2020-12": ["@swagger-api/apidom-ns-json-schema-2020-12@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@swagger-api/apidom-ns-json-schema-2019-09": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.4" } }, "sha512-HGBVG+JlAQbHmLunjDlmNw80NUN6DVyy4p+VMs9JZH2oACSKaOxNmHhertk0Szg0xdNXVEJiVvOKkjeLI+iADw=="], + + "@swagger-api/apidom-ns-json-schema-draft-4": ["@swagger-api/apidom-ns-json-schema-draft-4@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-ast": "^1.14.0", "@swagger-api/apidom-core": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.4" } }, "sha512-Un0xLcfALPM9NWavUPL5LCU2kEYjhnkhqTxQolbXqE/BbQzBdiSFTlXys56L4tz6UyH8v1LjE2Af63UCY4kKmQ=="], + + "@swagger-api/apidom-ns-json-schema-draft-6": ["@swagger-api/apidom-ns-json-schema-draft-6@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@swagger-api/apidom-ns-json-schema-draft-4": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.4" } }, "sha512-lVLknAwGZEyjWbFCQg8ZUVQetN8I5hGmcGb3bnURxglXpneFGsf6vFg1ptBRF4W6PO3okeOAyKvE93gZB4F5Jg=="], + + "@swagger-api/apidom-ns-json-schema-draft-7": ["@swagger-api/apidom-ns-json-schema-draft-7@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@swagger-api/apidom-ns-json-schema-draft-6": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.4" } }, "sha512-XECPBJyJRj6QKvNGwWumagSRIQhu0WGpYlnLNxyXPTFbDt52GBdz1k5qA4F+cJIBtOMKqZH+TSsMiRKjHs0PxA=="], + + "@swagger-api/apidom-ns-openapi-2": ["@swagger-api/apidom-ns-openapi-2@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@swagger-api/apidom-ns-json-schema-draft-4": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.3" } }, "sha512-ithVOQNsgUbA4o4Gsyv5IXvXGk2EVFSzRb79L+fUNb2kBn2NThyG3IBLaHVkdLxzD5AtNiqw7canD1+osJLgZg=="], + + "@swagger-api/apidom-ns-openapi-3-0": ["@swagger-api/apidom-ns-openapi-3-0@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@swagger-api/apidom-ns-json-schema-draft-4": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.3" } }, "sha512-sWd0ck8wG6dJZRhUEXENZWJwU4zdT8mPeGyNaaCwN0T7ShATg3RXL3eMJuRqP1liQmZuf+A5Ho/IxmS98ZgWYw=="], + + "@swagger-api/apidom-ns-openapi-3-1": ["@swagger-api/apidom-ns-openapi-3-1@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-ast": "^1.14.0", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-json-pointer": "^1.14.0", "@swagger-api/apidom-ns-json-schema-2020-12": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-0": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.3" } }, "sha512-HCTmFPzQumKTrcs+4eaTMfhWgkx6dJ30Zh/VOkZOtVgQDUzezKKUm1+NIdFZEIaQ0ZmRGvdXZ+RZnF6v1U6hUQ=="], + + "@swagger-api/apidom-ns-openapi-3-2": ["@swagger-api/apidom-ns-openapi-3-2@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-ast": "^1.14.0", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-json-pointer": "^1.14.0", "@swagger-api/apidom-ns-json-schema-2020-12": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-0": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-1": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "ts-mixer": "^6.0.3" } }, "sha512-tFBqwD4t3ChezZ6oM7gNEbTFpNsb5xxg7ozhfgc34xdak1/MIQkRNLH/GgvpztG81pERIqrQLGcbWm5iH8wqFg=="], + + "@swagger-api/apidom-parser-adapter-a2a-json-1": ["@swagger-api/apidom-parser-adapter-a2a-json-1@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-a2a-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-161dG8D7BP7ejwNKLRweemGw4cpJjVMixXos/67PCnr2Hg+MV+vEhh0VtBJoSf2NMNnfhO9g1wKAnj2pDCYWNA=="], + + "@swagger-api/apidom-parser-adapter-a2a-yaml-1": ["@swagger-api/apidom-parser-adapter-a2a-yaml-1@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-a2a-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-osK6KbCLUS12fMtjIQ/GZ8SbVZVoe0t9Lhb9IO4WSQz75R2YUdU/iB8Jx93SciiHjCQ/1iRI+EBfUZkmyzbeIw=="], + + "@swagger-api/apidom-parser-adapter-api-design-systems-json": ["@swagger-api/apidom-parser-adapter-api-design-systems-json@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-api-design-systems": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-Ga4ibi3XL4QPVKInUID5mbsX6wfDZ0awHHtLPktxkEauZdh/O/VAnvL7s559wJcFltNaHAQkHq0c2WPVkwxjZw=="], + + "@swagger-api/apidom-parser-adapter-api-design-systems-yaml": ["@swagger-api/apidom-parser-adapter-api-design-systems-yaml@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-api-design-systems": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-6FWu5PsI/0YJts0GCF3+0EcBHteoV1oVVaKhf9cT2ZehG3fXHtgmz3lviG+CtdolIQ5+k4NNPvWXmECzZo96fg=="], + + "@swagger-api/apidom-parser-adapter-arazzo-json-1": ["@swagger-api/apidom-parser-adapter-arazzo-json-1@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-arazzo-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-CBSyZX+g3A7x9WPzve97gRNibgVXobPgEYaRBMkfEun51rsygI33yMOpmEBi7xu3FV7h8SQiB268krhCjfKaYw=="], + + "@swagger-api/apidom-parser-adapter-arazzo-yaml-1": ["@swagger-api/apidom-parser-adapter-arazzo-yaml-1@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-arazzo-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-zDjsCgVDcFS/+YWZgSD3vJK4rzOZCg+HvcNEsCV9lO7FfN/jXykWFlFTkWDfSrSEoltRbWAzV5hd/etEvpjbjQ=="], + + "@swagger-api/apidom-parser-adapter-asyncapi-json-2": ["@swagger-api/apidom-parser-adapter-asyncapi-json-2@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-asyncapi-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-DwQpgYw8s9cLbxUtrP8psFzqoR52Bn1+r7a2khLxTebUgfUYLn8orffvq/xppx3lf2Rnvqgey7wPy0eI5WUoag=="], + + "@swagger-api/apidom-parser-adapter-asyncapi-json-3": ["@swagger-api/apidom-parser-adapter-asyncapi-json-3@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-asyncapi-3": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-V4BA10W8x0z/ZRpcRGjVdjKAxLC9eByrGDJjMYRQrEBOKGnUSkIE/xg3N7adp+SHSFem76H4Ez8+e4op67RQsw=="], + + "@swagger-api/apidom-parser-adapter-asyncapi-yaml-2": ["@swagger-api/apidom-parser-adapter-asyncapi-yaml-2@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-asyncapi-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-w5+0L5sZKbmjcx06Y1me6nK8v+q9n013hL19DzmU0EhVn9rWrqWg891irWwkOqmfJmCcuz8NVBIwqNMxDJy5Fg=="], + + "@swagger-api/apidom-parser-adapter-asyncapi-yaml-3": ["@swagger-api/apidom-parser-adapter-asyncapi-yaml-3@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-asyncapi-3": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-TQpWTTJNg0eSxv8xpTJGOwMlftuHY/YeVpBphA9Ssk22K8ImmB/pZQGhE5oUJ7M7mbgXvlJOtkbuBFDQ7ji3Eg=="], + + "@swagger-api/apidom-parser-adapter-json": ["@swagger-api/apidom-parser-adapter-json@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-ast": "^1.14.0", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "tree-sitter": "=0.21.1", "tree-sitter-json": "=0.24.8", "web-tree-sitter": "=0.24.5" } }, "sha512-6dUeLKjA/h62ost0ZMXAUBdfFvSRINuDh1U+9VVHkERq9ZsOmetLon+7T9UGkJPIi2R0r/Qr49LjuMGtnAE5JA=="], + + "@swagger-api/apidom-parser-adapter-json-schema-json-2020-12": ["@swagger-api/apidom-parser-adapter-json-schema-json-2020-12@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-json-schema-2020-12": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-PYB86bWah0dYBVnsFk7yi9E6clRLn45VaBWSE418c2kCI8q7Bpm+URSnR0LUYLHV573BMY7UKpi7/W8fP23f6A=="], + + "@swagger-api/apidom-parser-adapter-json-schema-yaml-2020-12": ["@swagger-api/apidom-parser-adapter-json-schema-yaml-2020-12@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-json-schema-2020-12": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-S869/DexEyiZsybmNvNJW5q/+JMP2PkufKCBjwpxqWCcFFGaJenwjaIvTJX1tfKrpc/cuBlviaKeyNA+cCaWBA=="], + + "@swagger-api/apidom-parser-adapter-openapi-json-2": ["@swagger-api/apidom-parser-adapter-openapi-json-2@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-openapi-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-50dRHYztd1DxZTrKjjoBxvWskRAqn9OdP5JtfO3UkARxG0tNsQrNzcYFuO39OZnBxpE3h+1WChmHNL+c3jvTNw=="], + + "@swagger-api/apidom-parser-adapter-openapi-json-3-0": ["@swagger-api/apidom-parser-adapter-openapi-json-3-0@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-0": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-Q96xoMKQ+tg1/bVD2XmRgFU1HW/T+gb8MtR+UDkpRMEyylPi2ODJE8sfoL/oKlo2RuzHSi0giJ2RnFVkZLZFTg=="], + + "@swagger-api/apidom-parser-adapter-openapi-json-3-1": ["@swagger-api/apidom-parser-adapter-openapi-json-3-1@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-sXzDeTnY/VHH5Fd0gxS9JiOISU/U/YEWwdL+wYXXJPjDr0dddhTSad7+QMxP1BkqBJEIuS87Jmfv5qOAFV79Mw=="], + + "@swagger-api/apidom-parser-adapter-openapi-json-3-2": ["@swagger-api/apidom-parser-adapter-openapi-json-3-2@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-vgcy8rsMwxcsS8xtJ0qJwy93zrHZ85YooHtc8ny2zCAKEv7QlKjXYdX1bDUskdxOV3Xh8ZaS5XPBqvL4DFS8/g=="], + + "@swagger-api/apidom-parser-adapter-openapi-yaml-2": ["@swagger-api/apidom-parser-adapter-openapi-yaml-2@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-openapi-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-oQS4SEjBfoEp0MMs2m6+4YIh+tqgs/PklSW9vdIhMbc4tbluM7Ro8tJXeIh3aS5lSyeN7ReJg9aJhzDooeWoAg=="], + + "@swagger-api/apidom-parser-adapter-openapi-yaml-3-0": ["@swagger-api/apidom-parser-adapter-openapi-yaml-3-0@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-0": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-WCyBR8Ca1ge8XT54nDvHnoYbGCOpOOb6VOLlzrMOy/ikF7JKR+A9IuqRkqPEuhUjjxr5Dc1Edv4NlivFykEdqA=="], + + "@swagger-api/apidom-parser-adapter-openapi-yaml-3-1": ["@swagger-api/apidom-parser-adapter-openapi-yaml-3-1@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-m1CwUYTgK0zvs0AndrdzKuL5FNfez6lag9nEsKfumoJJ1T/kev7Yo3jmPC++lLGsnJGbagIAkZ2nIBC5BuVKvQ=="], + + "@swagger-api/apidom-parser-adapter-openapi-yaml-3-2": ["@swagger-api/apidom-parser-adapter-openapi-yaml-3-2@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" } }, "sha512-4G6gEAp742YgXUocebXTDitiDkVvK30ceZFLvCmKaeuw1VsQJ/yNWGzTxkB25F0qbgdFGzceGJlX9eJx/svlGg=="], + + "@swagger-api/apidom-parser-adapter-yaml-1-2": ["@swagger-api/apidom-parser-adapter-yaml-1-2@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-ast": "^1.14.0", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@tree-sitter-grammars/tree-sitter-yaml": "=0.7.1", "@types/ramda": "~0.30.0", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0", "tree-sitter": "=0.22.4", "web-tree-sitter": "=0.24.5" } }, "sha512-ckzyyfgJUH+rEajzlrFaCwqc/K19KIIN1V9/zaVugDdxe1LLbtk11RQQa6AetkpeQdYVPzTMHIpKGluGyhZ1Bg=="], + + "@swagger-api/apidom-reference": ["@swagger-api/apidom-reference@1.14.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.26.10", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@types/ramda": "~0.30.0", "axios": "^1.20.0", "minimatch": "^10.2.6", "ramda": "~0.30.0", "ramda-adjunct": "^5.0.0" }, "optionalDependencies": { "@swagger-api/apidom-json-pointer": "^1.14.0", "@swagger-api/apidom-ns-a2a-1": "^1.14.0", "@swagger-api/apidom-ns-arazzo-1": "^1.14.0", "@swagger-api/apidom-ns-asyncapi-2": "^1.14.0", "@swagger-api/apidom-ns-json-schema-2020-12": "^1.14.0", "@swagger-api/apidom-ns-openapi-2": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-0": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-1": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-a2a-json-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-a2a-yaml-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-api-design-systems-json": "^1.14.0", "@swagger-api/apidom-parser-adapter-api-design-systems-yaml": "^1.14.0", "@swagger-api/apidom-parser-adapter-arazzo-json-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-arazzo-yaml-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-asyncapi-json-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-asyncapi-json-3": "^1.14.0", "@swagger-api/apidom-parser-adapter-asyncapi-yaml-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-asyncapi-yaml-3": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@swagger-api/apidom-parser-adapter-json-schema-json-2020-12": "^1.14.0", "@swagger-api/apidom-parser-adapter-json-schema-yaml-2020-12": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-json-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-json-3-0": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-json-3-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-json-3-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-yaml-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-yaml-3-0": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-yaml-3-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-yaml-3-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0" } }, "sha512-LCp15dZ61tEEMYsZY65qbRTx0KEqwO8j2qNowV3rADQa91x3QKPo8V1mcGAh+DUGun3m3hjh72c5rLsJCb6zSg=="], + + "@swaggerexpert/cookie": ["@swaggerexpert/cookie@2.1.1", "", { "dependencies": { "apg-lite": "^1.0.7" } }, "sha512-JakpJ28ieo/axwdRJ8Yb1Yae52YDPswvOUIsLT5cTMB1+7GXcC4nk+UjfpvlCVrRPHJc1vK+O1ylr3Al1KXBAA=="], + + "@swaggerexpert/json-pointer": ["@swaggerexpert/json-pointer@2.10.2", "", { "dependencies": { "apg-lite": "^1.0.4" } }, "sha512-qMx1nOrzoB+PF+pzb26Q4Tc2sOlrx9Ba2UBNX9hB31Omrq+QoZ2Gly0KLrQWw4Of1AQ4J9lnD+XOdwOdcdXqqw=="], + + "@swc/helpers": ["@swc/helpers@0.5.23", "", { "dependencies": { "tslib": "^2.8.0" } }, "sha512-5lSsMOTXURePglDfvuAQUqkGek9Hg2kksOYay2m0+XR++b2NWYL/4sWyuvVBIs8oKnJaxkdi9whaL/sqN13afw=="], + + "@tanstack/react-virtual": ["@tanstack/react-virtual@3.14.10", "", { "dependencies": { "@tanstack/virtual-core": "3.17.8" }, "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0", "react-dom": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-SRyoUbdFMRHuYXMijV5H4ZarQWpXkj3iANq8OFre+pybeVap8ZJjZ3Nz9bVjx4d8PfobVUQUdKyyyHYk3E+djw=="], + + "@tanstack/virtual-core": ["@tanstack/virtual-core@3.17.8", "", {}, "sha512-BfEvehNpOT75r5Ksc5xW6NZuXujTfb7nlSEyVu4XHG3gdxNg1KqXruWbDewXOUaUYIo4oRbSfkjIajz4MAT8tA=="], + + "@tree-sitter-grammars/tree-sitter-yaml": ["@tree-sitter-grammars/tree-sitter-yaml@0.7.1", "", { "dependencies": { "node-addon-api": "^8.3.1", "node-gyp-build": "^4.8.4" }, "peerDependencies": { "tree-sitter": "^0.22.4" }, "optionalPeers": ["tree-sitter"] }, "sha512-AynBwkIoQCTgjDR33bDUp9Mqq+YTco0is3n5hRApMqG9of/6A4eQsfC1/uSEeHSUyMQSYawcAWamsexnVpIP4Q=="], + + "@types/hast": ["@types/hast@3.0.5", "", { "dependencies": { "@types/unist": "*" } }, "sha512-rp/ezSWaD1m44dPKICGhiskI13nVr7qTloFwDa/IYkhhf5nzwP+zIQcIJh3WIFSBOy/H1PzB40jPjMDksN4F+g=="], + + "@types/node": ["@types/node@26.6.6", "", { "dependencies": { "undici-types": "~8.9.0" } }, "sha512-MzQj+8Kx3XI40OmUAE6Qoh58ZMNstNNMwn2nfd3qWsfe7nDNSqJNzes4njhz6AHwrSHOffSLwXU6yb474Q4aog=="], + + "@types/prismjs": ["@types/prismjs@1.26.6", "", {}, "sha512-vqlvI7qlMvcCBbVe0AKAb4f97//Hy0EBTaiW8AalRnG/xAN5zOiWWyrNqNXeq8+KAuvRewjCVY1+IPxk4RdNYw=="], + + "@types/ramda": ["@types/ramda@0.30.2", "", { "dependencies": { "types-ramda": "^0.30.1" } }, "sha512-PyzHvjCalm2BRYjAU6nIB3TprYwMNOUY/7P/N8bSzp9W/yM2YrtGtAnnVtaCNSeOZ8DzKyFDvaqQs7LnWwwmBA=="], + + "@types/react": ["@types/react@19.3.0", "", { "dependencies": { "csstype": "^3.2.2" } }, "sha512-N0rFCuH9YoxG9/m61l9MfpJKfmLOVU0em7ipIz6TRgSSkvReLB9vL85GB+yr8Bs5leqpvg96JSwF4ZS1s4viQg=="], + + "@types/react-dom": ["@types/react-dom@19.3.0", "", { "peerDependencies": { "@types/react": "^19.3.0" } }, "sha512-ZI7bU42mZXXKHn/qNLEw2IrbiINU7X5+vfgdixBHkCNpYWXjKgfQ/P+uyGb5CjOLB9UcnTeg3rylQtV2hym44Q=="], + + "@types/swagger-ui-react": ["@types/swagger-ui-react@5.18.0", "", { "dependencies": { "@types/react": "*" } }, "sha512-c2M9adVG7t28t1pq19K9Jt20VLQf0P/fwJwnfcmsVVsdkwCWhRmbKDu+tIs0/NGwJ/7GY8lBx+iKZxuDI5gDbw=="], + + "@types/trusted-types": ["@types/trusted-types@2.0.7", "", {}, "sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw=="], + + "@types/unist": ["@types/unist@3.0.3", "", {}, "sha512-ko/gIFJRv177XgZsZcBwnqJN5x/Gien8qNOn0D5bQU/zAzVf9Zt3BlcUiLqhV9y4ARk0GbT3tnUiPNgnTXzc/Q=="], + + "@types/use-sync-external-store": ["@types/use-sync-external-store@0.0.6", "", {}, "sha512-zFDAD+tlpf2r4asuHEj0XH6pY6i0g5NeAHPn+15wk3BV6JA69eERFXC1gyGThDkVa1zCyKr5jox1+2LbV/AMLg=="], + + "agent-base": ["agent-base@6.0.2", "", { "dependencies": { "debug": "4" } }, "sha512-RZNwNclF7+MS/8bDg70amg32dyeZGZxiDuQmZxKLAlQjr3jGyLx+4Kkk58UO7D2QdgFIQCovuSuZESne6RG6XQ=="], + + "apg-lite": ["apg-lite@1.0.7", "", {}, "sha512-wehJttEme63zE8FsrFThE8Ozmx2u8brywefDNb9oVPUQJupDNBFOOyhbpQSI2P+k/yqKhdgx2DErLfy4Pswycg=="], + + "argparse": ["argparse@2.0.1", "", {}, "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q=="], + + "asynckit": ["asynckit@0.4.0", "", {}, "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q=="], + + "autolinker": ["autolinker@3.16.2", "", { "dependencies": { "tslib": "^2.3.0" } }, "sha512-JiYl7j2Z19F9NdTmirENSUUIIL/9MytEWtmzhfmsKPCp9E+G35Y0UNCMoM9tFigxT59qSc8Ml2dlZXOCVTYwuA=="], + + "available-typed-arrays": ["available-typed-arrays@1.0.7", "", { "dependencies": { "possible-typed-array-names": "^1.0.0" } }, "sha512-wvUjBtSGN7+7SjNpq/9M2Tg350UZD3q62IFZLbRAR1bSMlCo1ZaeW+BJ+D090e4hIIZLBcTDWe4Mh4jvUDajzQ=="], + + "axios": ["axios@1.21.1", "", { "dependencies": { "follow-redirects": "^1.16.2", "form-data": "^4.0.6", "https-proxy-agent": "^5.0.1", "proxy-from-env": "^2.1.0" } }, "sha512-6eI5Q/Y4u/Um9dDlsRoq5pY2rxnUTv+L4PpLitnbk/i4jb3MxLZ5CsN5Ih3IysbeRYK4pR+P7qfMsOQl9fwwFQ=="], + + "balanced-match": ["balanced-match@4.0.4", "", {}, "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA=="], + + "base64-js": ["base64-js@1.5.1", "", {}, "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA=="], + + "baseline-browser-mapping": ["baseline-browser-mapping@2.11.36", "", { "bin": { "baseline-browser-mapping": "dist/cli.cjs" } }, "sha512-AbPFGS4K9S3meMRCLTM0Zas+e9X7b5ygUBOboDT5zevCZt9ByKSbMtKhwyVqW+oL8WemPVsbP7X3rdZcIyOa0w=="], + + "brace-expansion": ["brace-expansion@5.0.13", "", { "dependencies": { "balanced-match": "^4.0.2" } }, "sha512-Vh3dmFbc4wZeox7M9I/0L9GfFd83Su4+yCck/OF9Gi/P/dAHn0RT7X4K9R7gMNMhDck3DvhR6QXsnQdjjgwNvQ=="], + + "buffer": ["buffer@6.0.3", "", { "dependencies": { "base64-js": "^1.3.1", "ieee754": "^1.2.1" } }, "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA=="], + + "call-bind": ["call-bind@1.0.9", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.2", "es-define-property": "^1.0.1", "get-intrinsic": "^1.3.0", "set-function-length": "^1.2.2" } }, "sha512-a/hy+pNsFUTR+Iz8TCJvXudKVLAnz/DyeSUo10I5yvFDQJBFU2s9uqQpoSrJlroHUKoKqzg+epxyP9lqFdzfBQ=="], + + "call-bind-apply-helpers": ["call-bind-apply-helpers@1.0.2", "", { "dependencies": { "es-errors": "^1.3.0", "function-bind": "^1.1.2" } }, "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ=="], + + "call-bound": ["call-bound@1.0.4", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.2", "get-intrinsic": "^1.3.0" } }, "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg=="], + + "caniuse-lite": ["caniuse-lite@1.0.30001826", "", {}, "sha512-wTB+9tIbLro/BCXwLuNV1meHE4L9dS6dArMDwgYfNBPMYScqClHyGunhkCSDtHhe/69Xl0sHlKgBVZ+fNsYtWA=="], + + "character-entities": ["character-entities@2.0.2", "", {}, "sha512-shx7oQ0Awen/BRIdkjkvz54PnEEI/EjwXDSIZp86/KKdbafHh1Df/RYGBhn4hbe2+uKC9FnT5UCEdyPz3ai9hQ=="], + + "character-entities-legacy": ["character-entities-legacy@3.0.0", "", {}, "sha512-RpPp0asT/6ufRm//AJVwpViZbGM/MkjQFxJccQRHmISF/22NBtsHqAWmL+/pmkPWoIUJdWyeVleTl1wydHATVQ=="], + + "character-reference-invalid": ["character-reference-invalid@2.0.1", "", {}, "sha512-iBZ4F4wRbyORVsu0jPV7gXkOsGYjGHPmAyv+HiHG8gi5PtC9KI2j1+v8/tlibRvjoWX027ypmG/n0HtO5t7unw=="], + + "classnames": ["classnames@2.5.1", "", {}, "sha512-saHYOzhIQs6wy2sVxTM6bUDsQO4F50V9RQ22qBpEdCW+I+/Wmke2HOl6lS6dTpdxVhb88/I6+Hs+438c3lfUow=="], + + "client-only": ["client-only@0.0.1", "", {}, "sha512-IV3Ou0jSMzZrd3pZ48nLkT9DA7Ag1pnPzaiQhpW7c3RbcqqzvzzVu+L8gfqMp/8IM2MQtSiqaCxrrcfu8I8rMA=="], + + "combined-stream": ["combined-stream@1.0.8", "", { "dependencies": { "delayed-stream": "~1.0.0" } }, "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg=="], + + "comma-separated-tokens": ["comma-separated-tokens@2.0.3", "", {}, "sha512-Fu4hJdvzeylCfQPp9SGWidpzrMs7tTrlu6Vb8XGaRGck8QSNZJJp538Wrb60Lax4fPwR64ViY468OIUTbRlGZg=="], + + "copy-to-clipboard": ["copy-to-clipboard@3.3.3", "", { "dependencies": { "toggle-selection": "^1.0.6" } }, "sha512-2KV8NhB5JqC3ky0r9PMCAZKbUHSwtEo4CwCs0KXgruG43gX5PMqDEBbVU4OUzw2MuAWUfsuFmWvEKG5QRfSnJA=="], + + "core-js-pure": ["core-js-pure@3.51.0", "", {}, "sha512-NE4SFDJ+qzQeqHG2vVSNwopzS6zZNPYJ5kinIqs+OofTqGzOmICgT89E/yvS9XY7rwb3eU1utWXTJ9nVFqv74A=="], + + "css.escape": ["css.escape@1.5.1", "", {}, "sha512-YUifsXXuknHlUsmlgyY0PKzgPOr7/FjCePfHNt0jxm83wHZi44VDMQ7/fGNkjY3/jV1MC+1CmZbaHzugyeRtpg=="], + + "csstype": ["csstype@3.2.3", "", {}, "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ=="], + + "debug": ["debug@4.4.3", "", { "dependencies": { "ms": "^2.1.3" } }, "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA=="], + + "decode-named-character-reference": ["decode-named-character-reference@1.3.0", "", { "dependencies": { "character-entities": "^2.0.0" } }, "sha512-GtpQYB283KrPp6nRw50q3U9/VfOutZOe103qlN7BPP6Ad27xYnOIWv4lPzo8HCAL+mMZofJ9KEy30fq6MfaK6Q=="], + + "deep-extend": ["deep-extend@0.6.0", "", {}, "sha512-LOHxIOaPYdHlJRtCQfDIVZtfw/ufM8+rVj649RIHzcm/vGwQRXFt6OPqIFWsm2XEMrNIEtWR64sY1LEKD2vAOA=="], + + "deepmerge": ["deepmerge@4.3.1", "", {}, "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A=="], + + "define-data-property": ["define-data-property@1.1.4", "", { "dependencies": { "es-define-property": "^1.0.0", "es-errors": "^1.3.0", "gopd": "^1.0.1" } }, "sha512-rBMvIzlpA8v6E+SJZoo++HAYqsLrkg7MSfIinMPFhmkorw7X+dOXVJQs+QT69zGkzMyfDnIMN2Wid1+NbL3T+A=="], + + "delayed-stream": ["delayed-stream@1.0.0", "", {}, "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ=="], + + "detect-libc": ["detect-libc@2.1.2", "", {}, "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ=="], + + "dompurify": ["dompurify@3.4.17", "", { "optionalDependencies": { "@types/trusted-types": "^2.0.7" } }, "sha512-B/pSlYVHQ58kqISD/yDjuJ1yfzI34m1gF4lAod2bwSRhiN4K5Cl3H8Af7hqB2PmTL911tdEudnnXn5FnhRoz0w=="], + + "drange": ["drange@1.1.1", "", {}, "sha512-pYxfDYpued//QpnLIm4Avk7rsNtAtQkUES2cwAYSvD/wd2pKD71gN2Ebj3e7klzXwjocvE8c5vx/1fxwpqmSxA=="], + + "dunder-proto": ["dunder-proto@1.0.1", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.1", "es-errors": "^1.3.0", "gopd": "^1.2.0" } }, "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A=="], + + "es-define-property": ["es-define-property@1.0.1", "", {}, "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g=="], + + "es-errors": ["es-errors@1.3.0", "", {}, "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw=="], + + "es-object-atoms": ["es-object-atoms@1.1.2", "", { "dependencies": { "es-errors": "^1.3.0" } }, "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw=="], + + "es-set-tostringtag": ["es-set-tostringtag@2.1.0", "", { "dependencies": { "es-errors": "^1.3.0", "get-intrinsic": "^1.2.6", "has-tostringtag": "^1.0.2", "hasown": "^2.0.2" } }, "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA=="], + + "esbuild": ["esbuild@0.28.2", "", { "optionalDependencies": { "@esbuild/aix-ppc64": "0.28.2", "@esbuild/android-arm": "0.28.2", "@esbuild/android-arm64": "0.28.2", "@esbuild/android-x64": "0.28.2", "@esbuild/darwin-arm64": "0.28.2", "@esbuild/darwin-x64": "0.28.2", "@esbuild/freebsd-arm64": "0.28.2", "@esbuild/freebsd-x64": "0.28.2", "@esbuild/linux-arm": "0.28.2", "@esbuild/linux-arm64": "0.28.2", "@esbuild/linux-ia32": "0.28.2", "@esbuild/linux-loong64": "0.28.2", "@esbuild/linux-mips64el": "0.28.2", "@esbuild/linux-ppc64": "0.28.2", "@esbuild/linux-riscv64": "0.28.2", "@esbuild/linux-s390x": "0.28.2", "@esbuild/linux-x64": "0.28.2", "@esbuild/netbsd-arm64": "0.28.2", "@esbuild/netbsd-x64": "0.28.2", "@esbuild/openbsd-arm64": "0.28.2", "@esbuild/openbsd-x64": "0.28.2", "@esbuild/openharmony-arm64": "0.28.2", "@esbuild/sunos-x64": "0.28.2", "@esbuild/win32-arm64": "0.28.2", "@esbuild/win32-ia32": "0.28.2", "@esbuild/win32-x64": "0.28.2" }, "bin": { "esbuild": "bin/esbuild" } }, "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA=="], + + "fast-json-patch": ["fast-json-patch@3.1.1", "", {}, "sha512-vf6IHUX2SBcA+5/+4883dsIjpBTqmfBjmYiWK1savxQmFk4JfBMLa7ynTYOs1Rolp/T1betJxHiGD3g1Mn8lUQ=="], + + "fault": ["fault@1.0.4", "", { "dependencies": { "format": "^0.2.0" } }, "sha512-CJ0HCB5tL5fYTEA7ToAq5+kTwd++Borf1/bifxd9iT70QcXr4MRrO3Llf8Ifs70q+SJcGHFtnIE/Nw6giCtECA=="], + + "follow-redirects": ["follow-redirects@1.16.3", "", {}, "sha512-toOSoqN6d51Wjf1aOFJYcoVv1aND9rj/CwjLU0Vz40oDuSpWDayCeKe4JpL5NL0WdFvoOOCI3BRo69HahjbR1A=="], + + "for-each": ["for-each@0.3.5", "", { "dependencies": { "is-callable": "^1.2.7" } }, "sha512-dKx12eRCVIzqCxFGplyFKJMPvLEWgmNtUrpTiJIR5u97zEhRG8ySrtboPHZXx7daLxQVrl643cTzbab2tkQjxg=="], + + "form-data": ["form-data@4.0.6", "", { "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", "es-set-tostringtag": "^2.1.0", "hasown": "^2.0.4", "mime-types": "^2.1.35" } }, "sha512-vKatAh4SlVfgbv+YtmhiRjhEMJsYpsG1Y2rMQtR+SVSbytsSD1YGzDIcrAJmdFec88u/+VoGmxnl+80gL1tRCQ=="], + + "format": ["format@0.2.2", "", {}, "sha512-wzsgA6WOq+09wrU1tsJ09udeR/YZRaeArL9e1wPbFg3GG2yDnC2ldKpxs4xunpFF9DgqCqOIra3bc1HWrJ37Ww=="], + + "fsevents": ["fsevents@2.3.3", "", { "os": "darwin" }, "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw=="], + + "function-bind": ["function-bind@1.1.2", "", {}, "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA=="], + + "get-intrinsic": ["get-intrinsic@1.3.0", "", { "dependencies": { "call-bind-apply-helpers": "^1.0.2", "es-define-property": "^1.0.1", "es-errors": "^1.3.0", "es-object-atoms": "^1.1.1", "function-bind": "^1.1.2", "get-proto": "^1.0.1", "gopd": "^1.2.0", "has-symbols": "^1.1.0", "hasown": "^2.0.2", "math-intrinsics": "^1.1.0" } }, "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ=="], + + "get-proto": ["get-proto@1.0.1", "", { "dependencies": { "dunder-proto": "^1.0.1", "es-object-atoms": "^1.0.0" } }, "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g=="], + + "gopd": ["gopd@1.2.0", "", {}, "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg=="], + + "has-property-descriptors": ["has-property-descriptors@1.0.2", "", { "dependencies": { "es-define-property": "^1.0.0" } }, "sha512-55JNKuIW+vq4Ke1BjOTjM2YctQIvCT7GFzHwmfZPGo5wnrgkid0YQtnAleFSqumZm4az3n2BS+erby5ipJdgrg=="], + + "has-symbols": ["has-symbols@1.1.0", "", {}, "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ=="], + + "has-tostringtag": ["has-tostringtag@1.0.2", "", { "dependencies": { "has-symbols": "^1.0.3" } }, "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw=="], + + "hasown": ["hasown@2.0.4", "", { "dependencies": { "function-bind": "^1.1.2" } }, "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A=="], + + "hast-util-parse-selector": ["hast-util-parse-selector@4.0.0", "", { "dependencies": { "@types/hast": "^3.0.0" } }, "sha512-wkQCkSYoOGCRKERFWcxMVMOcYE2K1AaNLU8DXS9arxnLOUEWbOXKXiJUNzEpqZ3JOKpnha3jkFrumEjVliDe7A=="], + + "hastscript": ["hastscript@9.0.3", "", { "dependencies": { "@types/hast": "^3.0.0", "comma-separated-tokens": "^2.0.0", "hast-util-parse-selector": "^4.0.0", "property-information": "^7.0.0", "space-separated-tokens": "^2.0.0" } }, "sha512-1ALZXSmCGmW3h8AMz4R4+QKSKFi7sNgXLVwmwB8FYVtl1CwQ3WDkSAEY/d5tp1g/vbQgq2s1WlHgfO3jbw1TsA=="], + + "highlight.js": ["highlight.js@10.7.3", "", {}, "sha512-tzcUFauisWKNHaRkN4Wjl/ZA07gENAjFl3J/c480dprkGTg5EQstgaNFqBfUqCq54kZRIEcreTsAgF/m2quD7A=="], + + "highlightjs-vue": ["highlightjs-vue@1.0.0", "", {}, "sha512-PDEfEF102G23vHmPhLyPboFCD+BkMGu+GuJe2d9/eH4FsCwvgBpnc9n0pGE+ffKdph38s6foEZiEjdgHdzp+IA=="], + + "https-proxy-agent": ["https-proxy-agent@5.0.1", "", { "dependencies": { "agent-base": "6", "debug": "4" } }, "sha512-dFcAjpTQFgoLMzC2VwU+C/CbS7uRL0lWmxDITmqm7C+7F0Odmj6s9l6alZc6AELXhrnggM2CeWSXHGOdX2YtwA=="], + + "ieee754": ["ieee754@1.2.1", "", {}, "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA=="], + + "immutable": ["immutable@5.2.0", "", {}, "sha512-u1aDbE79y64hkiY7K3npTBoTgLcgXK8MkJgwKO15SoN1bZS0su2d0QBhlb/Va/YxLbbU03CoIZvsPUOVcMedDA=="], + + "inherits": ["inherits@2.0.4", "", {}, "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="], + + "invariant": ["invariant@2.2.4", "", { "dependencies": { "loose-envify": "^1.0.0" } }, "sha512-phJfQVBuaJM5raOpJjSfkiD6BpbCE4Ns//LaXl6wGYtUBY83nWS6Rf9tXm2e8VaK60JEjYldbPif/A2B1C2gNA=="], + + "is-alphabetical": ["is-alphabetical@2.0.1", "", {}, "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ=="], + + "is-alphanumerical": ["is-alphanumerical@2.0.1", "", { "dependencies": { "is-alphabetical": "^2.0.0", "is-decimal": "^2.0.0" } }, "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw=="], + + "is-callable": ["is-callable@1.2.7", "", {}, "sha512-1BC0BVFhS/p0qtw6enp8e+8OD0UrK0oFLztSjNzhcKA3WDuJxxAPXzPuPtKkjEY9UUoEWlX/8fgKeu2S8i9JTA=="], + + "is-decimal": ["is-decimal@2.0.1", "", {}, "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A=="], + + "is-hexadecimal": ["is-hexadecimal@2.0.1", "", {}, "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg=="], + + "is-typed-array": ["is-typed-array@1.1.15", "", { "dependencies": { "which-typed-array": "^1.1.16" } }, "sha512-p3EcsicXjit7SaskXHs1hA91QxgTw46Fv6EFKKGS5DRFLD8yKnohjF3hxoju94b/OcMZoQukzpPpBE9uLVKzgQ=="], + + "isarray": ["isarray@2.0.5", "", {}, "sha512-xHjhDr3cNBK0BzdUJSPXZntQUx/mwMS5Rw4A7lPJ90XGAO6ISP/ePDNuo0vhqOZU+UD5JoodwCAAoZQd3FeAKw=="], + + "js-file-download": ["js-file-download@0.4.12", "", {}, "sha512-rML+NkoD08p5Dllpjo0ffy4jRHeY6Zsapvr/W86N7E0yuzAO6qa5X9+xog6zQNlH102J7IXljNY2FtS6Lj3ucg=="], + + "js-tokens": ["js-tokens@4.0.0", "", {}, "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ=="], + + "js-yaml": ["js-yaml@4.3.2", "", { "dependencies": { "argparse": "^2.0.1" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-SFNOvSJ+Dgf/9An904Yx+CgSlIPCkIpao4qo51lpee25TIRejdH3rhR4EZMGoNx3/TP3O+wzWuiTFl4sqbltzA=="], + + "lodash": ["lodash@4.18.1", "", {}, "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q=="], + + "lodash.debounce": ["lodash.debounce@4.0.8", "", {}, "sha512-FT1yDzDYEoYWhnSGnpE/4Kj1fLZkDFyqRb7fNt6FdYOSxlUWAtp42Eh6Wb0rGIv/m9Bgo7x4GhQbm5Ys4SG5ow=="], + + "loose-envify": ["loose-envify@1.4.0", "", { "dependencies": { "js-tokens": "^3.0.0 || ^4.0.0" }, "bin": { "loose-envify": "cli.js" } }, "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q=="], + + "lowlight": ["lowlight@1.20.0", "", { "dependencies": { "fault": "^1.0.0", "highlight.js": "~10.7.0" } }, "sha512-8Ktj+prEb1RoCPkEOrPMYUN/nCggB7qAWe3a7OpMjWQkh3l2RD5wKRQ+o8Q8YuI9RG/xs95waaI/E6ym/7NsTw=="], + + "marked": ["marked@18.1.2", "", { "bin": { "marked": "bin/marked.js" } }, "sha512-DfOnvLAQ6WYeWxWO1u4RyFOeqyHup6dks5PPqnoFiooU7ipRvidO/2j8plhAHIiZg574E9ZlzSjUiPMLAzFkgg=="], + + "math-intrinsics": ["math-intrinsics@1.1.0", "", {}, "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g=="], + + "mime-db": ["mime-db@1.52.0", "", {}, "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg=="], + + "mime-types": ["mime-types@2.1.35", "", { "dependencies": { "mime-db": "1.52.0" } }, "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw=="], + + "minim": ["minim@0.23.8", "", { "dependencies": { "lodash": "^4.15.0" } }, "sha512-bjdr2xW1dBCMsMGGsUeqM4eFI60m94+szhxWys+B1ztIt6gWSfeGBdSVCIawezeHYLYn0j6zrsXdQS/JllBzww=="], + + "minimatch": ["minimatch@10.2.6", "", { "dependencies": { "brace-expansion": "^5.0.8" } }, "sha512-vpLQEs+VLCr1nU0BXS07maYoFwlDAH0gngQuuttxIwutDFEMHq2blX+8vpgxDdK3J1PwjCJiep77OitTZ4Ll1A=="], + + "ms": ["ms@2.1.3", "", {}, "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA=="], + + "nanoid": ["nanoid@3.3.20", "", { "bin": { "nanoid": "bin/nanoid.cjs" } }, "sha512-uKdg2G3GNCKQn9byYOpxbGqrT2fGO5KRt5J/8b3pok8rT6qxGWF6hxMyJiEYtAf+FVyYuD9hRaDqX5uPFYJ4ZQ=="], + + "neotraverse": ["neotraverse@1.0.1", "", {}, "sha512-WmmLty1YWwJl9yZi77v2dVIV6X2kuYV8YYBI/G3LWGKdGHmHUvL1z7FW0iDvEvGAwNEoc5x1tOOOyDnf5jJw/w=="], + + "next": ["next@16.4.4", "", { "dependencies": { "@next/env": "16.4.4", "@swc/helpers": "0.5.23", "baseline-browser-mapping": "^2.9.19", "caniuse-lite": "^1.0.30001579", "postcss": "8.5.23", "styled-jsx": "5.1.6" }, "optionalDependencies": { "@next/swc-darwin-arm64": "16.4.4", "@next/swc-darwin-x64": "16.4.4", "@next/swc-linux-arm64-gnu": "16.4.4", "@next/swc-linux-arm64-musl": "16.4.4", "@next/swc-linux-x64-gnu": "16.4.4", "@next/swc-linux-x64-musl": "16.4.4", "@next/swc-win32-arm64-msvc": "16.4.4", "@next/swc-win32-x64-msvc": "16.4.4", "sharp": "^0.35.5" }, "peerDependencies": { "@opentelemetry/api": "^1.1.0", "@playwright/test": "^1.51.1", "babel-plugin-react-compiler": "*", "react": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "react-dom": "^18.2.0 || 19.0.0-rc-de68d2f4-20241204 || ^19.0.0", "sass": "^1.3.0" }, "optionalPeers": ["@opentelemetry/api", "@playwright/test", "babel-plugin-react-compiler", "sass"], "bin": { "next": "dist/bin/next" } }, "sha512-Hu4pOw2x0RQ0TQabNWbpsNg/3+SZf+rLQwvfhBLnptv98GS4dcIVMlfEyn9jb2/ZJDSahhnUKEs0YrfarjGX3A=="], + + "node-abort-controller": ["node-abort-controller@3.1.1", "", {}, "sha512-AGK2yQKIjRuqnc6VkX2Xj5d+QW8xZ87pa1UK6yA6ouUyuxfHuMP6umE5QK7UmTeOAymo+Zx1Fxiuw9rVx8taHQ=="], + + "node-addon-api": ["node-addon-api@8.9.2", "", {}, "sha512-VijLXbi3UACN69I0JVXJsX4tjACjNoQDgv2gTF6sx2wWEi8tkSg2eX8p5gSIFi8z2+DL3oHmY6OyKce38SDolg=="], + + "node-gyp-build": ["node-gyp-build@4.8.4", "", { "bin": { "node-gyp-build": "bin.js", "node-gyp-build-optional": "optional.js", "node-gyp-build-test": "build-test.js" } }, "sha512-LA4ZjwlnUblHVgq0oBF3Jl/6h/Nvs5fzBLwdEF4nuxnFdsfajde4WfxtJr3CaiH+F6ewcIB/q4jQ4UzPyid+CQ=="], + + "object-assign": ["object-assign@4.1.1", "", {}, "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg=="], + + "openapi-path-templating": ["openapi-path-templating@2.3.0", "", { "dependencies": { "apg-lite": "^1.0.5" } }, "sha512-rjqLJDhInqH2ZqD76oTfc2Ufc3BoKY7+E0AB3POH39E6ltsaWS5zLSiwflQi9NtFQqEUYzwWrzUjX1BIYpNpBQ=="], + + "openapi-server-url-templating": ["openapi-server-url-templating@1.3.0", "", { "dependencies": { "apg-lite": "^1.0.4" } }, "sha512-DPlCms3KKEbjVQb0spV6Awfn6UWNheuG/+folQPzh/wUaKwuqvj8zt5gagD7qoyxtE03cIiKPgLFS3Q8Bz00uQ=="], + + "parse-entities": ["parse-entities@4.0.2", "", { "dependencies": { "@types/unist": "^2.0.0", "character-entities-legacy": "^3.0.0", "character-reference-invalid": "^2.0.0", "decode-named-character-reference": "^1.0.0", "is-alphanumerical": "^2.0.0", "is-decimal": "^2.0.0", "is-hexadecimal": "^2.0.0" } }, "sha512-GG2AQYWoLgL877gQIKeRPGO1xF9+eG1ujIb5soS5gPvLQ1y2o8FL90w2QWNdf9I361Mpp7726c+lj3U0qK1uGw=="], + + "picocolors": ["picocolors@1.1.1", "", {}, "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA=="], + + "possible-typed-array-names": ["possible-typed-array-names@1.1.0", "", {}, "sha512-/+5VFTchJDoVj3bhoqi6UeymcD00DAwb1nJwamzPvHEszJ4FpF6SNNbUbOS8yI56qHzdV8eK0qEfOSiodkTdxg=="], + + "postcss": ["postcss@8.5.23", "", { "dependencies": { "nanoid": "^3.3.16", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-g50586zr4bZmwFiTlflMu8E0bDTb5I5gertgwAKmsdUlTQIhZtunzUlD1WSzwcVWPoAVpsrA6vlfCD7oXvRwgg=="], + + "prismjs": ["prismjs@1.30.0", "", {}, "sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw=="], + + "prop-types": ["prop-types@15.8.1", "", { "dependencies": { "loose-envify": "^1.4.0", "object-assign": "^4.1.1", "react-is": "^16.13.1" } }, "sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg=="], + + "property-information": ["property-information@7.2.0", "", {}, "sha512-IAtzIB6sUiWaJYrX9smp3V46pBGbBeLFRGdh25kg1334VcBlD8HzhPeNIWQH9zhGmo2itIe25EHt9dQP7G5hmg=="], + + "proxy-from-env": ["proxy-from-env@2.1.0", "", {}, "sha512-cJ+oHTW1VAEa8cJslgmUZrc+sjRKgAKl3Zyse6+PV38hZe/V6Z14TbCuXcan9F9ghlz4QrFr2c92TNF82UkYHA=="], + + "querystringify": ["querystringify@2.2.0", "", {}, "sha512-FIqgj2EUvTa7R50u0rGsyTftzjYmv/a3hO345bZNrqabNqjtgiDMgmo4mkUjd+nzU5oF3dClKqFIPUKybUyqoQ=="], + + "ramda": ["ramda@0.30.1", "", {}, "sha512-tEF5I22zJnuclswcZMc8bDIrwRHRzf+NqVEmqg50ShAZMP7MWeR/RGDthfM/p+BlqvF2fXAzpn8i+SJcYD3alw=="], + + "ramda-adjunct": ["ramda-adjunct@5.1.0", "", { "peerDependencies": { "ramda": ">= 0.30.0" } }, "sha512-8qCpl2vZBXEJyNbi4zqcgdfHtcdsWjOGbiNSEnEBrM6Y0OKOT8UxJbIVGm1TIcjaSu2MxaWcgtsNlKlCk7o7qg=="], + + "randexp": ["randexp@0.5.3", "", { "dependencies": { "drange": "^1.0.2", "ret": "^0.2.0" } }, "sha512-U+5l2KrcMNOUPYvazA3h5ekF80FHTUG+87SEAmHZmolh1M+i/WyTCxVzmi+tidIa1tM4BSe8g2Y/D3loWDjj+w=="], + + "randombytes": ["randombytes@2.1.0", "", { "dependencies": { "safe-buffer": "^5.1.0" } }, "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ=="], + + "react": ["react@19.3.1", "", {}, "sha512-QNhWdt7nrgVWWQG58QuGsAR3jv3Hbe4mb4vz7w2csnHavciZJgda1CPNaldF6eVxv90ud3jUXpKlHL69gO38yw=="], + + "react-copy-to-clipboard": ["react-copy-to-clipboard@5.1.1", "", { "dependencies": { "copy-to-clipboard": "^3.3.3", "prop-types": "^15.8.1" }, "peerDependencies": { "react": ">=15.3.0" } }, "sha512-s+HrzLyJBxrpGTYXF15dTgMjAJpEPZT/Yp6NytAtZMRngejxt6Pt5WrfFxLAcsqUDU6sY1Jz6tyHwIicE1U2Xg=="], + + "react-debounce-input": ["react-debounce-input@3.3.0", "", { "dependencies": { "lodash.debounce": "^4", "prop-types": "^15.8.1" }, "peerDependencies": { "react": "^15.3.0 || 16 || 17 || 18" } }, "sha512-VEqkvs8JvY/IIZvh71Z0TC+mdbxERvYF33RcebnodlsUZ8RSgyKe2VWaHXv4+/8aoOgXLxWrdsYs2hDhcwbUgA=="], + + "react-dom": ["react-dom@19.3.1", "", { "dependencies": { "scheduler": "^0.28.0" }, "peerDependencies": { "react": "^19.3.1" } }, "sha512-Y0bARz53lhEC1NMCASs0/j+faB/zqt3R8hpvg1e8+61ZVJ4UL0UdC4cBbXfZMcIuhrfgeILTLe+ZeBCavQPtKQ=="], + + "react-immutable-proptypes": ["react-immutable-proptypes@2.2.0", "", { "dependencies": { "invariant": "^2.2.2" }, "peerDependencies": { "immutable": ">=3.6.2" } }, "sha512-Vf4gBsePlwdGvSZoLSBfd4HAP93HDauMY4fDjXhreg/vg6F3Fj/MXDNyTbltPC/xZKmZc+cjLu3598DdYK6sgQ=="], + + "react-immutable-pure-component": ["react-immutable-pure-component@2.2.2", "", { "peerDependencies": { "immutable": ">= 2 || >= 4.0.0-rc", "react": ">= 16.6", "react-dom": ">= 16.6" } }, "sha512-vkgoMJUDqHZfXXnjVlG3keCxSO/U6WeDQ5/Sl0GK2cH8TOxEzQ5jXqDXHEL/jqk6fsNxV05oH5kD7VNMUE2k+A=="], + + "react-inspector": ["react-inspector@6.0.2", "", { "peerDependencies": { "react": "^16.8.4 || ^17.0.0 || ^18.0.0" } }, "sha512-x+b7LxhmHXjHoU/VrFAzw5iutsILRoYyDq97EDYdFpPLcvqtEzk4ZSZSQjnFPbr5T57tLXnHcqFYoN1pI6u8uQ=="], + + "react-is": ["react-is@16.13.1", "", {}, "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ=="], + + "react-redux": ["react-redux@9.3.1", "", { "dependencies": { "@types/use-sync-external-store": "^0.0.6", "use-sync-external-store": "^1.4.0" }, "peerDependencies": { "@types/react": "^18.2.25 || ^19", "react": "^18.0 || ^19", "redux": "^5.0.0" }, "optionalPeers": ["@types/react", "redux"] }, "sha512-vxMLT0lalUjbZPkoTepWyKAZbjIIFssNx/CEL9lTfwQBU6XpkGSmCNdcCIrkOBUgB68uftZMnbXVb6DwGnhRKQ=="], + + "react-syntax-highlighter": ["react-syntax-highlighter@16.1.2", "", { "dependencies": { "@babel/runtime": "^7.28.4", "highlight.js": "^10.4.1", "highlightjs-vue": "^1.0.0", "lowlight": "^1.17.0", "prismjs": "^1.30.0", "refractor": "^5.0.0" }, "peerDependencies": { "react": ">= 0.14.0" } }, "sha512-4dM0+mYtfnhgwYWAvFx56fgyjIYk2yFopfiICFvMDhRfeSGRNd+ngFALdPD9q7llyGAmiE6pzOSOwI8Lf9ca1w=="], + + "redux": ["redux@5.0.1", "", {}, "sha512-M9/ELqF6fy8FwmkpnF0S3YKOqMyoWJ4+CS5Efg2ct3oY9daQvd/Pc71FpGZsVsbl3Cpb+IIcjBDUnnyBdQbq4w=="], + + "refractor": ["refractor@5.0.0", "", { "dependencies": { "@types/hast": "^3.0.0", "@types/prismjs": "^1.0.0", "hastscript": "^9.0.0", "parse-entities": "^4.0.0" } }, "sha512-QXOrHQF5jOpjjLfiNk5GFnWhRXvxjUVnlFxkeDmewR5sXkr3iM46Zo+CnRR8B+MDVqkULW4EcLVcRBNOPXHosw=="], + + "remarkable": ["remarkable@2.0.1", "", { "dependencies": { "argparse": "^1.0.10", "autolinker": "^3.11.0" }, "bin": { "remarkable": "bin/remarkable.js" } }, "sha512-YJyMcOH5lrR+kZdmB0aJJ4+93bEojRZ1HGDn9Eagu6ibg7aVZhc3OWbbShRid+Q5eAfsEqWxpe+g5W5nYNfNiA=="], + + "repeat-string": ["repeat-string@1.6.1", "", {}, "sha512-PV0dzCYDNfRi1jCDbJzpW7jNNDRuCOG/jI5ctQcGKt/clZD+YcPS3yIlWuTJMmESC8aevCFmWJy5wjAFgNqN6w=="], + + "requires-port": ["requires-port@1.0.0", "", {}, "sha512-KigOCHcocU3XODJxsu8i/j8T9tzT4adHiecwORRQ0ZZFcp7ahwXuRU1m+yuO90C5ZUyGeGfocHDI14M3L3yDAQ=="], + + "reselect": ["reselect@5.3.0", "", {}, "sha512-XGoLeRAVzUTcJ1qkxPQhDJyIZ5d6zzZD9nT7AEZOaaU9UbWclhycElmhO+VD5bFeLuzhPBaOV2oXC8uG35ZSpg=="], + + "ret": ["ret@0.2.2", "", {}, "sha512-M0b3YWQs7R3Z917WRQy1HHA7Ba7D8hvZg6UE5mLykJxQVE2ju0IXbGlaHPPlkY+WN7wFP+wUMXmBFA0aV6vYGQ=="], + + "safe-buffer": ["safe-buffer@5.2.1", "", {}, "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ=="], + + "scheduler": ["scheduler@0.28.0", "", {}, "sha512-juorfCmIkIw8tT+p5BXSm6PJjQF/ycEYmKyzURCIt/RaZIhL+PulbQ9Yu2z1HdOJDdqDTlxA1+xKBmHXJsczAw=="], + + "semver": ["semver@7.8.6", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-9lpSSU4Mly3mrtruwLs1eLK6+gzbzqeBFwRNjIjE+9LuDpWdYctrQlQ3ej1Ilgi7gknpsTRnPoLP8DpCHqHIJw=="], + + "serialize-error": ["serialize-error@8.1.0", "", { "dependencies": { "type-fest": "^0.20.2" } }, "sha512-3NnuWfM6vBYoy5gZFvHiYsVbafvI9vZv/+jlIigFn4oP4zjNPK3LhcY0xSCgeb1a5L8jO71Mit9LlNoi2UfDDQ=="], + + "set-function-length": ["set-function-length@1.2.2", "", { "dependencies": { "define-data-property": "^1.1.4", "es-errors": "^1.3.0", "function-bind": "^1.1.2", "get-intrinsic": "^1.2.4", "gopd": "^1.0.1", "has-property-descriptors": "^1.0.2" } }, "sha512-pgRc4hJ4/sNjWCSS9AmnS40x3bNMDTknHgL5UaMBTMyJnU90EgWh1Rz+MC9eFu4BuN/UwZjKQuY/1v3rM7HMfg=="], + + "sha.js": ["sha.js@2.4.12", "", { "dependencies": { "inherits": "^2.0.4", "safe-buffer": "^5.2.1", "to-buffer": "^1.2.0" }, "bin": { "sha.js": "bin.js" } }, "sha512-8LzC5+bvI45BjpfXU8V5fdU2mfeKiQe1D1gIMn7XUlF3OTUrpdJpPPH4EMAnF0DsHHdSZqCdSss5qCmJKuiO3w=="], + + "sharp": ["sharp@0.35.5", "", { "dependencies": { "@img/colour": "^1.1.0", "detect-libc": "^2.1.2", "semver": "^7.8.5" }, "optionalDependencies": { "@img/sharp-darwin-arm64": "0.35.5", "@img/sharp-darwin-x64": "0.35.5", "@img/sharp-freebsd-wasm32": "0.35.5", "@img/sharp-libvips-darwin-arm64": "1.3.4", "@img/sharp-libvips-darwin-x64": "1.3.4", "@img/sharp-libvips-linux-arm": "1.3.4", "@img/sharp-libvips-linux-arm64": "1.3.4", "@img/sharp-libvips-linux-ppc64": "1.3.4", "@img/sharp-libvips-linux-riscv64": "1.3.4", "@img/sharp-libvips-linux-s390x": "1.3.4", "@img/sharp-libvips-linux-x64": "1.3.4", "@img/sharp-libvips-linuxmusl-arm64": "1.3.4", "@img/sharp-libvips-linuxmusl-x64": "1.3.4", "@img/sharp-linux-arm": "0.35.5", "@img/sharp-linux-arm64": "0.35.5", "@img/sharp-linux-ppc64": "0.35.5", "@img/sharp-linux-riscv64": "0.35.5", "@img/sharp-linux-s390x": "0.35.5", "@img/sharp-linux-x64": "0.35.5", "@img/sharp-linuxmusl-arm64": "0.35.5", "@img/sharp-linuxmusl-x64": "0.35.5", "@img/sharp-webcontainers-wasm32": "0.35.5", "@img/sharp-win32-arm64": "0.35.5", "@img/sharp-win32-ia32": "0.35.5", "@img/sharp-win32-x64": "0.35.5" } }, "sha512-Ywn4OnzGukp7CDMrp08RQ50YKmuwG47brZgIVPTvBaaAfQlRlygrRqSrxdCiL9M+LlzLBiJ68IR1QqvzHyjC7g=="], + + "short-unique-id": ["short-unique-id@5.3.2", "", { "bin": { "short-unique-id": "bin/short-unique-id", "suid": "bin/short-unique-id" } }, "sha512-KRT/hufMSxXKEDSQujfVE0Faa/kZ51ihUcZQAcmP04t00DvPj7Ox5anHke1sJYUtzSuiT/Y5uyzg/W7bBEGhCg=="], + + "source-map-js": ["source-map-js@1.2.2", "", {}, "sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw=="], + + "space-separated-tokens": ["space-separated-tokens@2.0.2", "", {}, "sha512-PEGlAwrG8yXGXRjW32fGbg66JAlOAwbObuqVoJpv/mRgoWDQfgH1wDPvtzWyUSNAXBGSk8h755YDbbcEy3SH2Q=="], + + "sprintf-js": ["sprintf-js@1.0.3", "", {}, "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g=="], + + "styled-jsx": ["styled-jsx@5.1.6", "", { "dependencies": { "client-only": "0.0.1" }, "peerDependencies": { "react": ">= 16.8.0 || 17.x.x || ^18.0.0-0 || ^19.0.0-0" } }, "sha512-qSVyDTeMotdvQYoHWLNGwRFJHC+i+ZvdBRYosOFgC+Wg1vx4frN2/RG/NA7SYqqvKNLf39P2LSRA2pu6n0XYZA=="], + + "swagger-client": ["swagger-client@3.39.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.22.15", "@scarf/scarf": "=1.4.0", "@swagger-api/apidom-core": "^1.14.0", "@swagger-api/apidom-error": "^1.14.0", "@swagger-api/apidom-json-pointer": "^1.14.0", "@swagger-api/apidom-ns-json-schema-2020-12": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-1": "^1.14.0", "@swagger-api/apidom-ns-openapi-3-2": "^1.14.0", "@swagger-api/apidom-reference": "^1.14.0", "@swaggerexpert/cookie": "^2.0.2", "deepmerge": "~4.3.0", "fast-json-patch": "^3.0.0-1", "js-yaml": "^4.3.2", "neotraverse": "=1.0.1", "node-abort-controller": "^3.1.1", "openapi-path-templating": "^2.2.1", "openapi-server-url-templating": "^1.3.0", "ramda": "^0.30.1", "ramda-adjunct": "^5.1.0" }, "optionalDependencies": { "@swagger-api/apidom-ns-asyncapi-2": "^1.14.0", "@swagger-api/apidom-ns-asyncapi-3": "^1.14.0", "@swagger-api/apidom-ns-openapi-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-api-design-systems-json": "^1.14.0", "@swagger-api/apidom-parser-adapter-api-design-systems-yaml": "^1.14.0", "@swagger-api/apidom-parser-adapter-arazzo-json-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-arazzo-yaml-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-asyncapi-json-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-asyncapi-json-3": "^1.14.0", "@swagger-api/apidom-parser-adapter-asyncapi-yaml-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-asyncapi-yaml-3": "^1.14.0", "@swagger-api/apidom-parser-adapter-json": "^1.14.0", "@swagger-api/apidom-parser-adapter-json-schema-json-2020-12": "^1.14.0", "@swagger-api/apidom-parser-adapter-json-schema-yaml-2020-12": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-json-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-json-3-0": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-json-3-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-json-3-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-yaml-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-yaml-3-0": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-yaml-3-1": "^1.14.0", "@swagger-api/apidom-parser-adapter-openapi-yaml-3-2": "^1.14.0", "@swagger-api/apidom-parser-adapter-yaml-1-2": "^1.14.0" } }, "sha512-EDpBphskzOCzczUrucX3/FVb7k5gch1GSzB+MTBcdGY3Zew2XKs0ryPPw1J2l1hioojwwKUZXtEg31axbnQvpQ=="], + + "swagger-ui-react": ["swagger-ui-react@5.34.0", "", { "dependencies": { "@babel/runtime-corejs3": "^7.27.1", "@scarf/scarf": "=1.4.0", "@tanstack/react-virtual": "=3.14.10", "base64-js": "^1.5.1", "buffer": "^6.0.3", "classnames": "^2.5.1", "css.escape": "1.5.1", "deep-extend": "0.6.0", "dompurify": "^3.4.16", "ieee754": "^1.2.1", "immutable": "^5.1.9", "js-file-download": "^0.4.12", "js-yaml": "=4.3.2", "lodash": "^4.18.1", "prop-types": "^15.8.1", "randexp": "^0.5.3", "randombytes": "^2.1.0", "react-copy-to-clipboard": "5.1.1", "react-debounce-input": "=3.3.0", "react-immutable-proptypes": "2.2.0", "react-immutable-pure-component": "^2.2.0", "react-inspector": "^6.0.1", "react-redux": "^9.3.0", "react-syntax-highlighter": "^16.0.0", "redux": "^5.0.1", "remarkable": "^2.0.1", "reselect": "^5.1.1", "serialize-error": "^8.1.0", "sha.js": "^2.4.12", "swagger-client": "^3.38.4", "url-parse": "^1.5.10", "xml": "=1.0.1", "xml-but-prettier": "^1.0.1", "zenscroll": "^4.0.2" }, "peerDependencies": { "react": ">=16.8.0 <20", "react-dom": ">=16.8.0 <20" } }, "sha512-pwWmbBfDoHHVS/Fx4L4KpgqZQPCx5leWk9Wi98tHw1eYmTrxcFmyOUXvjaj3gOO55Stjtw6fqlL9W6WT28YJfA=="], + + "to-buffer": ["to-buffer@1.2.2", "", { "dependencies": { "isarray": "^2.0.5", "safe-buffer": "^5.2.1", "typed-array-buffer": "^1.0.3" } }, "sha512-db0E3UJjcFhpDhAF4tLo03oli3pwl3dbnzXOUIlRKrp+ldk/VUxzpWYZENsw2SZiuBjHAk7DfB0VU7NKdpb6sw=="], + + "toggle-selection": ["toggle-selection@1.0.6", "", {}, "sha512-BiZS+C1OS8g/q2RRbJmy59xpyghNBqrr6k5L/uKBGRsTfxmu3ffiRnd8mlGPUVayg8pvfi5urfnu8TU7DVOkLQ=="], + + "tree-sitter": ["tree-sitter@0.21.1", "", { "dependencies": { "node-addon-api": "^8.0.0", "node-gyp-build": "^4.8.0" } }, "sha512-7dxoA6kYvtgWw80265MyqJlkRl4yawIjO7S5MigytjELkX43fV2WsAXzsNfO7sBpPPCF5Gp0+XzHk0DwLCq3xQ=="], + + "tree-sitter-json": ["tree-sitter-json@0.24.8", "", { "dependencies": { "node-addon-api": "^8.2.2", "node-gyp-build": "^4.8.2" }, "peerDependencies": { "tree-sitter": "^0.21.1" }, "optionalPeers": ["tree-sitter"] }, "sha512-Tc9ZZYwHyWZ3Tt1VEw7Pa2scu1YO7/d2BCBbKTx5hXwig3UfdQjsOPkPyLpDJOn/m1UBEWYAtSdGAwCSyagBqQ=="], + + "ts-mixer": ["ts-mixer@6.0.4", "", {}, "sha512-ufKpbmrugz5Aou4wcr5Wc1UUFWOLhq+Fm6qa6P0w0K5Qw2yhaUoiWszhCVuNQyNwrlGiscHOmqYoAox1PtvgjA=="], + + "ts-toolbelt": ["ts-toolbelt@9.6.0", "", {}, "sha512-nsZd8ZeNUzukXPlJmTBwUAuABDe/9qtVDelJeT/qW0ow3ZS3BsQJtNkan1802aM9Uf68/Y8ljw86Hu0h5IUW3w=="], + + "tslib": ["tslib@2.9.1", "", {}, "sha512-a4Ux9VKuIMHsOS7ENbEq6hK2ZGYIT27Rtl0E4eD9KqwxhKiQeMZE/9xb3IdYwWaSOyIBQLExhQgXDTYoiCxnWA=="], + + "tsx": ["tsx@4.23.15", "", { "dependencies": { "esbuild": "~0.28.0" }, "optionalDependencies": { "fsevents": "~2.3.3" }, "bin": { "tsx": "dist/cli.mjs" } }, "sha512-Yiex1Ovn8z2xPpOWckIiysV1SSyRMY9BkLF++q0yKiDxCqRhosKfMg3janKkiLBwZ5c/YryloKwGZcrEmtwxKw=="], + + "type-fest": ["type-fest@0.20.2", "", {}, "sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ=="], + + "typed-array-buffer": ["typed-array-buffer@1.0.3", "", { "dependencies": { "call-bound": "^1.0.3", "es-errors": "^1.3.0", "is-typed-array": "^1.1.14" } }, "sha512-nAYYwfY3qnzX30IkA6AQZjVbtK6duGontcQm1WSG1MD94YLqK0515GNApXkoxKOWMusVssAHWLh9SeaoefYFGw=="], + + "types-ramda": ["types-ramda@0.30.1", "", { "dependencies": { "ts-toolbelt": "^9.6.0" } }, "sha512-1HTsf5/QVRmLzcGfldPFvkVsAdi1db1BBKzi7iW3KBUlOICg/nKnFS+jGqDJS3YD8VsWbAh7JiHeBvbsw8RPxA=="], + + "typescript": ["typescript@6.0.3", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-y2TvuxSZPDyQakkFRPZHKFm+KKVqIisdg9/CZwm9ftvKXLP8NRWj38/ODjNbr43SsoXqNuAisEf1GdCxqWcdBw=="], + + "undici-types": ["undici-types@8.9.0", "", {}, "sha512-KTDyRTYX8sWmKXAikPHHSyc63CRPETMctyjKFupcC6OBLXT3xsN0e9aF7m+mIXutFWpUXuedtowG7iLOzp0kQg=="], + + "unraw": ["unraw@3.0.0", "", {}, "sha512-08/DA66UF65OlpUDIQtbJyrqTR0jTAlJ+jsnkQ4jxR7+K5g5YG1APZKQSMCE1vqqmD+2pv6+IdEjmopFatacvg=="], + + "url-parse": ["url-parse@1.5.10", "", { "dependencies": { "querystringify": "^2.1.1", "requires-port": "^1.0.0" } }, "sha512-WypcfiRhfeUP9vvF0j6rw0J3hrWrw6iZv3+22h6iRMJ/8z1Tj6XfLP4DsUix5MhMPnXpiHDoKyoZ/bdCkwBCiQ=="], + + "use-sync-external-store": ["use-sync-external-store@1.7.0", "", { "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } }, "sha512-6L+EeigHMQhdaIPNIFUKwfWJSwWFQ8gJbJ2DLOs5sDIegTwR9fRxvnM3uciHKjIZhFz+KAv2emhWMRvDmMcY8A=="], + + "web-tree-sitter": ["web-tree-sitter@0.24.5", "", {}, "sha512-+J/2VSHN8J47gQUAvF8KDadrfz6uFYVjxoxbKWDoXVsH2u7yLdarCnIURnrMA6uSRkgX3SdmqM5BOoQjPdSh5w=="], + + "which-typed-array": ["which-typed-array@1.1.24", "", { "dependencies": { "available-typed-arrays": "^1.0.7", "call-bind": "^1.0.9", "call-bound": "^1.0.4", "for-each": "^0.3.5", "get-proto": "^1.0.1", "gopd": "^1.2.0", "has-tostringtag": "^1.0.2" } }, "sha512-wk4Mf4pR5mRP7eYuuTBCIQ9d0ud2Fv2jRLQpfgnRjbOxAFHmjKFValgTpitVKzJJS8ajnYQV2Du1SZ8j6b/EUQ=="], + + "xml": ["xml@1.0.1", "", {}, "sha512-huCv9IH9Tcf95zuYCsQraZtWnJvBtLVE0QHMOs8bWyZAFZNDcYjsPq1nEx8jKA9y+Beo9v+7OBPRisQTjinQMw=="], + + "xml-but-prettier": ["xml-but-prettier@1.0.1", "", { "dependencies": { "repeat-string": "^1.5.2" } }, "sha512-C2CJaadHrZTqESlH03WOyw0oZTtoy2uEg6dSDF6YRg+9GnYNub53RRemLpnvtbHDFelxMx4LajiFsYeR6XJHgQ=="], + + "zenscroll": ["zenscroll@4.0.2", "", {}, "sha512-jEA1znR7b4C/NnaycInCU6h/d15ZzCd1jmsruqOKnZP6WXQSMH3W2GL+OXbkruslU4h+Tzuos0HdswzRUk/Vgg=="], + + "@swagger-api/apidom-parser-adapter-yaml-1-2/tree-sitter": ["tree-sitter@0.22.4", "", { "dependencies": { "node-addon-api": "^8.3.0", "node-gyp-build": "^4.8.4" } }, "sha512-usbHZP9/oxNsUY65MQUsduGRqDHQOou1cagUSwjhoSYAmSahjQDAVsh9s+SlZkn8X8+O1FULRGwHu7AFP3kjzg=="], + + "parse-entities/@types/unist": ["@types/unist@2.0.11", "", {}, "sha512-CmBKiL6NNo/OqgmMn95Fk9Whlp2mtvIv+KNpQKN2F4SjvrEesubTRWGYSg+BnWZOnlCaSTU1sMpsBOzgbYhnsA=="], + + "remarkable/argparse": ["argparse@1.0.10", "", { "dependencies": { "sprintf-js": "~1.0.2" } }, "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg=="], + } +} diff --git a/apps/docs/lib/site.ts b/apps/docs/lib/site.ts new file mode 100644 index 00000000..b6ea782b --- /dev/null +++ b/apps/docs/lib/site.ts @@ -0,0 +1,7 @@ +export const SITE_URL = 'https://docs.hellonear.xyz' +export const TRUST_URL = 'https://trust.hellonear.xyz' +export const REPO_URL = 'https://github.com/Hellonear-AI/hellonear' +export const ISSUES_URL = `${REPO_URL}/issues/new` +export const STATUS_URL = 'https://status.hellonear.xyz' +export const APP_URL = 'https://app.hellonear.xyz' +export const API_URL = 'https://api.hellonear.xyz' diff --git a/apps/docs/next-env.d.ts b/apps/docs/next-env.d.ts new file mode 100644 index 00000000..a419cbe4 --- /dev/null +++ b/apps/docs/next-env.d.ts @@ -0,0 +1,7 @@ +/// +/// +import "./.next/dev/types/routes.d.ts"; +import "./.next/dev/types/root-params.d.ts"; + +// NOTE: This file should not be edited +// see https://nextjs.org/docs/app/api-reference/config/typescript for more information. diff --git a/apps/docs/next.config.ts b/apps/docs/next.config.ts new file mode 100644 index 00000000..825b9dc6 --- /dev/null +++ b/apps/docs/next.config.ts @@ -0,0 +1,18 @@ +import type { NextConfig } from "next"; + +const nextConfig: NextConfig = { + async headers() { + return [ + { + // Agents find the Markdown index from any page (llms.txt convention), and caches keep HTML and Markdown apart. + source: "/:path*", + headers: [ + { key: "Link", value: '; rel="llms-txt", ; rel="llms-full-txt"' }, + { key: "Vary", value: "Accept" }, + ], + }, + ]; + }, +}; + +export default nextConfig; diff --git a/apps/docs/package.json b/apps/docs/package.json new file mode 100644 index 00000000..88b8cbf1 --- /dev/null +++ b/apps/docs/package.json @@ -0,0 +1,35 @@ +{ + "name": "@hellonear/docs", + "version": "0.1.0", + "private": true, + "engines": { + "node": "^22.22.2 || >=24.0.0" + }, + "scripts": { + "content": "node scripts/build-content.mjs", + "predev": "node scripts/build-content.mjs", + "dev": "next dev --port 3300", + "prebuild": "node scripts/build-content.mjs", + "build": "next build", + "start": "next start --port 3300", + "pretypecheck": "node scripts/build-content.mjs", + "typecheck": "tsc --noEmit", + "pretest": "node scripts/build-content.mjs", + "test": "node --import tsx --test tests/*.test.ts" + }, + "dependencies": { + "marked": "18.1.2", + "next": "16.4.4", + "react": "19.3.1", + "react-dom": "19.3.1", + "swagger-ui-react": "5.34.0" + }, + "devDependencies": { + "@types/node": "26.6.6", + "@types/react": "19.3.0", + "@types/react-dom": "19.3.0", + "@types/swagger-ui-react": "5.18.0", + "tsx": "4.23.15", + "typescript": "6.0.3" + } +} diff --git a/apps/docs/scripts/build-content.mjs b/apps/docs/scripts/build-content.mjs new file mode 100644 index 00000000..f07fe004 --- /dev/null +++ b/apps/docs/scripts/build-content.mjs @@ -0,0 +1,42 @@ +// Turns content/**/*.md into lib/generated/pages.json, the one source every route reads (HTML, .md export, llms +// files, MCP), so nothing reads the file system at request time. Also copies the repo's OpenAPI spec into public/. +import { copyFileSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs' +import { dirname, join, relative } from 'node:path' +import { fileURLToPath } from 'node:url' + +const root = join(dirname(fileURLToPath(import.meta.url)), '..') +const contentDir = join(root, 'content') + +const walk = (dir) => + readdirSync(dir).flatMap((name) => { + const path = join(dir, name) + return statSync(path).isDirectory() ? walk(path) : name.endsWith('.md') ? [path] : [] + }) + +export function parsePage(file, text) { + const m = /^---\n([\s\S]*?)\n---\n/.exec(text) + if (!m) throw new Error(`${file}: missing frontmatter`) + const meta = Object.fromEntries( + m[1].split('\n').filter(Boolean).map((line) => { + const i = line.indexOf(':') + if (i < 0) throw new Error(`${file}: bad frontmatter line "${line}"`) + return [line.slice(0, i).trim(), line.slice(i + 1).trim()] + }), + ) + if (!meta.title || !meta.description) throw new Error(`${file}: title and description are required`) + const slug = file.replace(/\.md$/, '').replace(/(^|\/)index$/, '') + return { slug, title: meta.title, description: meta.description, markdown: text.slice(m[0].length).trim() + '\n' } +} + +const pages = walk(contentDir) + .map((path) => parsePage(relative(contentDir, path).split('\\').join('/'), readFileSync(path, 'utf8'))) + .sort((a, b) => a.slug.localeCompare(b.slug)) + +for (const p of pages) { + if (/[\u2013\u2014]/.test(p.markdown + p.title + p.description)) throw new Error(`content/${p.slug || 'index'}.md: no en or em dashes`) +} + +mkdirSync(join(root, 'lib/generated'), { recursive: true }) +writeFileSync(join(root, 'lib/generated/pages.json'), JSON.stringify(pages, null, 1) + '\n') +copyFileSync(join(root, '../../docs/openapi.json'), join(root, 'public/openapi.json')) +console.log(`content: ${pages.length} pages, openapi.json copied`) diff --git a/apps/docs/tsconfig.json b/apps/docs/tsconfig.json new file mode 100644 index 00000000..1a0ca4a3 --- /dev/null +++ b/apps/docs/tsconfig.json @@ -0,0 +1,41 @@ +{ + "compilerOptions": { + "target": "ES2022", + "lib": [ + "dom", + "dom.iterable", + "esnext" + ], + "allowJs": false, + "skipLibCheck": true, + "strict": true, + "noEmit": true, + "esModuleInterop": true, + "module": "esnext", + "moduleResolution": "bundler", + "resolveJsonModule": true, + "isolatedModules": true, + "jsx": "react-jsx", + "incremental": true, + "plugins": [ + { + "name": "next" + } + ], + "paths": { + "@/*": [ + "./*" + ] + } + }, + "include": [ + "next-env.d.ts", + "**/*.ts", + "**/*.tsx", + ".next/types/**/*.ts", + ".next/dev/types/**/*.ts" + ], + "exclude": [ + "node_modules" + ] +} From 3f60afc48326dcb8e37ad8ae5b3cb7a5c34fdc01 Mon Sep 17 00:00:00 2001 From: Lexirieru Date: Fri, 13 Nov 2026 04:37:32 +0700 Subject: [PATCH 2/9] docs(docs): the docs pages, sliced from the README and the API contract MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Most pages are README sections (images stripped, relative links pointed at GitHub) and api-contract §3, so they say what the repo says; intro, concepts, track features, errors and status are written from the README, apps/be/CLAUDE.md and the code. No en or em dashes (the content build refuses them). Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e --- apps/docs/content/agent-market.md | 18 +++ apps/docs/content/agent.md | 159 ++++++++++++++++++++++ apps/docs/content/api-reference.md | 13 ++ apps/docs/content/api.md | 157 +++++++++++++++++++++ apps/docs/content/autopilot.md | 27 ++++ apps/docs/content/connections.md | 30 ++++ apps/docs/content/connectors.md | 25 ++++ apps/docs/content/contract-check.md | 18 +++ apps/docs/content/contracts.md | 86 ++++++++++++ apps/docs/content/errors.md | 47 +++++++ apps/docs/content/events.md | 70 ++++++++++ apps/docs/content/hackathon-phase.md | 40 ++++++ apps/docs/content/haggling.md | 27 ++++ apps/docs/content/how-it-works.md | 73 ++++++++++ apps/docs/content/index.md | 43 ++++++ apps/docs/content/minds.md | 34 +++++ apps/docs/content/payments-csv.md | 26 ++++ apps/docs/content/privacy.md | 20 +++ apps/docs/content/quickstart.md | 88 ++++++++++++ apps/docs/content/relayer.md | 18 +++ apps/docs/content/run-locally.md | 35 +++++ apps/docs/content/skills.md | 28 ++++ apps/docs/content/status.md | 49 +++++++ apps/docs/content/swarm-auction.md | 39 ++++++ apps/docs/content/tech-stack.md | 45 ++++++ apps/docs/content/telegram.md | 25 ++++ apps/docs/content/tracks.md | 71 ++++++++++ apps/docs/content/verified-replies.md | 31 +++++ apps/docs/content/wallet-and-approvals.md | 19 +++ 29 files changed, 1361 insertions(+) create mode 100644 apps/docs/content/agent-market.md create mode 100644 apps/docs/content/agent.md create mode 100644 apps/docs/content/api-reference.md create mode 100644 apps/docs/content/api.md create mode 100644 apps/docs/content/autopilot.md create mode 100644 apps/docs/content/connections.md create mode 100644 apps/docs/content/connectors.md create mode 100644 apps/docs/content/contract-check.md create mode 100644 apps/docs/content/contracts.md create mode 100644 apps/docs/content/errors.md create mode 100644 apps/docs/content/events.md create mode 100644 apps/docs/content/hackathon-phase.md create mode 100644 apps/docs/content/haggling.md create mode 100644 apps/docs/content/how-it-works.md create mode 100644 apps/docs/content/index.md create mode 100644 apps/docs/content/minds.md create mode 100644 apps/docs/content/payments-csv.md create mode 100644 apps/docs/content/privacy.md create mode 100644 apps/docs/content/quickstart.md create mode 100644 apps/docs/content/relayer.md create mode 100644 apps/docs/content/run-locally.md create mode 100644 apps/docs/content/skills.md create mode 100644 apps/docs/content/status.md create mode 100644 apps/docs/content/swarm-auction.md create mode 100644 apps/docs/content/tech-stack.md create mode 100644 apps/docs/content/telegram.md create mode 100644 apps/docs/content/tracks.md create mode 100644 apps/docs/content/verified-replies.md create mode 100644 apps/docs/content/wallet-and-approvals.md diff --git a/apps/docs/content/agent-market.md b/apps/docs/content/agent-market.md new file mode 100644 index 00000000..dc4ad178 --- /dev/null +++ b/apps/docs/content/agent-market.md @@ -0,0 +1,18 @@ +--- +title: Hire on Agent Market +description: How a Mind searches the NEAR AI Agent Market, gets each agent's price for a job and recommends the cheapest within budget, without hiring. +--- + +**Track:** `agents`. **Skill:** Hire on Agent Market (`agent-market`), in the General Assistant template. **Tools:** `market_search`, `market_quote`. + +The Mind searches the public catalog of the [NEAR AI Agent Market](https://market.near.ai) (`GET /v1/agents`), asks for a job's exact price, and picks the cheapest agent within the owner's budget. + +## Try it + +Make a **General Assistant** and ask: *"I need competitor research for a coffee shop in Jakarta. My budget is 1 USDC. Find the cheapest agent on the NEAR AI Agent Market that fits."* See: real agents from market.near.ai, a price from each, which fit the budget, and the cheapest recommended. + +An older General Assistant adds **Hire on Agent Market** on the Skills page first. + +## What it does not do + +**Nothing is hired or paid.** Hiring on the Agent Market is paid in USDC on NEAR mainnet, and HelloNear runs on testnet during the hackathon, so it only quotes. See [Hackathon phase](/hackathon-phase). diff --git a/apps/docs/content/agent.md b/apps/docs/content/agent.md new file mode 100644 index 00000000..953bc3b7 --- /dev/null +++ b/apps/docs/content/agent.md @@ -0,0 +1,159 @@ +--- +title: The agent +description: How each Mind runs on Mastra and NEAR AI Cloud: design, every tool, every skill, and how it is tested. +--- + +This is the core of HelloNear, and the part a judge can read end to end in `engine/`. + +### Design + +| Piece | How it is built | Where | +|---|---|---| +| **One generic agent** | A single Mastra `Agent`. Each request carries the Mind's persona, skills, wallet token, time zone and rules in Mastra's `RequestContext`; nothing per-Mind is hardcoded. | `engine/src/mastra.ts`, `engine/src/mind.ts` | +| **Model** | NEAR AI Cloud through `@ai-sdk/openai-compatible` with token usage on streams. Default `z-ai/glm-5.3-flash` (low reasoning effort), `deepseek-ai/DeepSeek-V4.1-Flash-1017` for reasoning, `Qwen/Qwen3-Embedding-0.6B` for memory. Chat goes through the NEAR AI SDK's fetch so every response can be verified. | `engine/src/models.ts` | +| **Verified replies** | After the stream ends, each completion's signature is fetched and checked against the TEE attestation (warmed at start and every 50 minutes). The badge shows the weakest step's level; the proof is kept. | `engine/src/verify.ts` | +| **Skills** | 33 equippable skills plus a built-in HelloNear guide. Each is a `SKILL.md` (frontmatter: title, blurb, tools, connections, status) turned into a Mastra skill; shared references load only when a playbook asks. | `engine/skills/*/SKILL.md`, `engine/src/skills.ts` | +| **Tools granted by skills** | The tool list is resolved per request from the equipped skills; the backend sends skill ids, never tool names. A tool no equipped skill grants does not exist for that run. | `engine/src/tools.ts` (`toolsFor`) | +| **Approval** | Tools that act get Mastra's `requireApproval`: the run pauses into a stored snapshot until the owner answers. A per-call `needsApprovalFn` applies the owner's rules (a payment skips the card only up to the owner's amount and only to a listed address). `beforeApproval` re-reads the target first, so an invented id or a stale value never even gets a card. | `engine/src/tools.ts`, `engine/src/autoApprove.ts` | +| **Writes re-check** | Every write reads its target again just before writing (a Sheet cell, a Notion row, a calendar event, a Doc title) and refuses if it changed since the card was shown. | `engine/src/apps.ts`, `engine/src/calendar.ts` | +| **Memory** | Mastra Memory on Postgres + pgvector: working memory the owner can read, edit or clear, and semantic recall of past chats, scoped to the owner and the Mind's persona version. Either can be switched off. | `engine/src/memory.ts` | +| **Context budget** | Mastra's `TokenLimiterProcessor` drops the oldest messages first when a long thread passes the budget; the system prompt and tools stay. | `engine/src/mastra.ts` | +| **Workflows** | Builder canvases compile to Mastra dynamic workflows, including nested Ifs and End; Autopilot runs them on Mastra workflow schedules. Unattended runs never get approval tools, and user text can never become a Mastra template. | `engine/src/builder.ts`, `engine/src/workflows.ts`, `engine/src/autopilot.ts` | +| **Secrets** | The model writes `{{secrets.NAME}}`; only the tool fills it at execution, for the hosts the owner listed. Secret values and wallet tokens live in a `Map` in the request context, so they never reach prompts, traces or stored snapshots (a test scans every table). | `engine/src/secrets.ts` | +| **Events** | Mastra's stream is normalised into HelloNear events (`tool.called`, `tool.approval_required`, `run.verified`, …) that drive the chat, the live view and the Mind Graph. | `engine/src/server.ts`, `docs/api-contract.md` | +| **Stop** | Closing the request aborts the model call, so a stopped reply stops spending tokens. Payments already sent to OutLayer are never cut halfway. | `engine/src/server.ts` | + +### All 53 tools + +**A** (approval) = needs the owner's approval (or an owner rule). Reads never ask. + +**Wallet and NEAR** + +| Tool | A | What it does | Calls | +|---|---|---|---| +| `send_payment` | yes | Send testnet NEAR from the Mind's wallet | Backend wallet route → OutLayer (policy checked in a TEE) | +| `get_balance` | | The Mind's wallet address and balance | Backend wallet route | +| `list_payments` | | Recent payments, including refused ones and why | Backend wallet route | +| `split_amount` | | Each person's share of an amount, exactly, in yoctoNEAR | Local (BigInt) | +| `near_view_account` | | Look up a testnet account: exists, balance, storage, and whether it is a contract (`isContract`, `codeHash`) | NEAR RPC `view_account` | +| `near_check_transfer` | | Check one transaction: success, receiver, amount, whether it paid this Mind | NEAR RPC `tx` | +| `crosschain_quote` | | Quote a USDC/USDT payment to another chain, signature checked | NEAR Intents 1Click `/v0/quote` (`dry: true`) | +| `buy_data` | | Buy a live NEAR data report (402 pattern) | Backend shop route | +| `get_quotes` | | Every seller's price for a report, cheapest first, and which ones the wallet may pay | Backend shop route | +| `make_offer` | | Offer one seller less than it quoted, once, within the owner's budget; answers accepted or its last price, and whether to buy or walk away | Backend shop route (`offer`) | +| `market_search` | | Search the NEAR AI Agent Market's public catalog: agents, default price, track record, verification | market.near.ai `GET /v1/agents` | +| `market_quote` | | Get a listed agent's exact price for the owner's task, unpaid (its x402 answer), and whether it is within the owner's budget; nothing starts, nothing is paid | market.near.ai A2A `SendMessage` without payment | +| `sell_offer` | yes | Put something this Mind made on sale to other Minds | Backend offers route | +| `buy_from_mind` | | Buy what another Mind sells (402 pattern) | Backend offers route | + +**Gmail and the Mind's own email address** + +| Tool | A | What it does | Calls | +|---|---|---|---| +| `gmail_list_emails` | | Recent emails, optionally filtered | Composio Gmail | +| `gmail_read_email` | | Read one email | Composio Gmail | +| `gmail_create_draft` | | Save a draft reply (no send tool exists) | Composio Gmail | +| `gmail_organize` | yes | Archive or label up to 20 emails; never deletes | Composio Gmail | +| `mail_send` | yes | Send from the Mind's own address, only to addresses the owner typed | Backend mail route → AgentMail | +| `mail_list` | | The Mind's own inbox, with spam and phishing warnings | Backend mail route | +| `mail_read` | | Read one message in the Mind's inbox | Backend mail route | +| `mail_send_to_owner` | yes, in chat | Email the owner (never a chosen recipient); in Autopilot only as a step the owner placed | Backend mail route | + +**Calendar and meetings** + +| Tool | A | What it does | Calls | +|---|---|---|---| +| `googlecalendar_list_events` | | Events with times on the owner's clock | Composio Google Calendar | +| `googlecalendar_find_free_time` | | Free slots of a given length within the owner's day | Composio Google Calendar | +| `googlecalendar_create_event` | yes | Add an event; nobody is invited | Composio Google Calendar | +| `googlecalendar_create_meeting` | yes | A meeting with guests the owner named, optional Google Meet link | Composio Google Calendar + Meet | +| `googlecalendar_move_event` | yes | Move an event the owner organises; guests stay, nobody is emailed | Composio Google Calendar (PATCH) | +| `googlecalendar_block_time` | | Block time today; only as a Builder step the owner placed | Composio Google Calendar | +| `zoom_list_meetings` | | Upcoming or past Zoom meetings | Composio Zoom | +| `zoom_create_meeting` | yes | A Zoom meeting with a join link; nobody is invited | Composio Zoom | +| `zoom_meeting_summary` | | Zoom's AI summary of a past meeting | Composio Zoom | + +**Documents and workspaces** + +| Tool | A | What it does | Calls | +|---|---|---|---| +| `googlesheets_find_spreadsheets` | | Find spreadsheets by name or content | Composio Sheets | +| `googlesheets_read_range` | | Read cells, with row numbers | Composio Sheets | +| `googlesheets_append_row` | yes | Add a row (values stay text, never formulas) | Composio Sheets | +| `googlesheets_update_cells` | yes | Change cells, old and new value on the card; refuses a clear | Composio Sheets | +| `googledrive_find_files` | | Search Drive by text | Composio Drive | +| `googledocs_read_document` | | Read a Doc's text | Composio Docs | +| `googledocs_create_document` | yes | Create a Doc from Markdown | Composio Docs | +| `googledocs_append_text` | yes | Add text at the end of a Doc; never replaces | Composio Docs | +| `notion_search` | | Find shared pages or databases | Composio Notion | +| `notion_read_page` | | Read a page's text | Composio Notion | +| `notion_query_database` | | A database's rows, filtered and sorted | Composio Notion | +| `notion_create_page` | yes | Create a page under one the owner chose | Composio Notion | +| `notion_add_row` | yes | Add a database row | Composio Notion | +| `notion_update_row` | yes | Change a row's properties, old and new on the card; never archives | Composio Notion | +| `slack_list_channels` | | Channels the owner can see | Composio Slack | +| `slack_send_message` | yes | Post to a channel the owner named | Composio Slack | +| `outlook_list_emails` | | Recent Outlook emails | Composio Outlook | +| `outlook_read_email` | | Read one Outlook email | Composio Outlook | +| `outlook_create_draft` | | Save a reply draft (no send) | Composio Outlook | + +**Utilities** + +| Tool | A | What it does | Calls | +|---|---|---|---| +| `get_time` | | UTC and the owner's local date, time and weekday (the model never works out a weekday itself) | Local | +| `add_numbers` | | Exact addition, so the model never sums in its head | Local | +| `http_request` | | Call a public HTTPS API with a key from Connections, only to the hosts the owner allowed; no redirects, private addresses refused, the key redacted from the result | The owner's service | + +### All 34 skills + +Icons are the ones the web app shows on each skill card. + +| | Skill | What it does | Tools it grants | +|---|---|---|---| +| | **Payments** (`payments`) | Sends testnet NEAR and pays bills after the owner approves; quotes USDC or USDT payments to other chains (Base, Solana…) through NEAR Intents | `send_payment`, `get_balance`, `list_payments`, `get_time`, `near_view_account`, `crosschain_quote` | +| | **Recipient guard** (`recipient-guard`) | Checks a recipient before paying and answers allow, warn or block with the reason: where the account came from, that it exists, lookalikes of people you already pay, first payments, and contracts | `near_view_account`, `list_payments`, `send_payment`, `get_balance`, `get_time` | +| | **Split bill** (`split-bill`) | Works out each person's share of a bill and pays each one after you approve | `add_numbers`, `split_amount`, `send_payment`, `near_view_account`, `list_payments`, `get_balance`, `get_time` | +| | **Revenue split** (`revenue-split`) | Remembers your partners' shares and pays each one their part of new income after you approve | `get_balance`, `send_payment`, `near_view_account`, `add_numbers`, `split_amount`, `list_payments`, `get_time` | +| | **Paid data** (`paid-data`) | Buys small live NEAR reports, paying only after you approve | `buy_data`, `send_payment`, `list_payments`, `get_time` | +| | **Best price buyer** (`best-price`) | Compares every seller of a data report, haggles once when the price is over your budget (then buys or walks away), and buys from one your wallet may pay, after you approve | `get_quotes`, `make_offer`, `buy_data`, `send_payment`, `list_payments`, `get_time` | +| | **Hire on Agent Market** (`agent-market`) | Finds agents on the NEAR AI Agent Market (market.near.ai), gets a job's exact price and picks the cheapest within your budget; hiring is paid in USDC on NEAR mainnet, so during the testnet phase it only quotes | `market_search`, `market_quote` | +| | **Price watch** (`price-watch`) | Checks a data report's price and buys only at or under your limit, after you approve | `get_quotes`, `buy_data`, `send_payment`, `add_numbers`, `get_time` | +| | **Mind as seller** (`mind-seller`) | Sells what this Mind made to other Minds for testnet NEAR into its own wallet, and buys from other Minds, after you approve | `sell_offer`, `buy_from_mind`, `send_payment`, `get_balance`, `get_time` | +| | **Invoice & get paid** (`invoice`) | Emails an invoice from this Mind's address after you approve, and checks a payment only by its transaction | `mail_send`, `mail_list`, `mail_read`, `get_balance`, `near_check_transfer`, `get_time` | +| | **Treasury report** (`treasury-report`) | Reports the wallet balance, what went out since yesterday and what is pending; it only reads | `get_balance`, `list_payments`, `get_time`, `add_numbers` | +| | **Spending audit** (`spending-audit`) | Reviews a week of payments, with tx links for those sent and reasons for those refused; it only reads | `get_balance`, `list_payments`, `get_time`, `add_numbers` | +| | **Freeze advisor** (`freeze-advisor`) | Spots trouble in the wallet and tells you when to press Freeze; it cannot freeze anything itself | `list_payments`, `get_balance`, `get_time` | +| | **NEAR account lookup** (`near-account`) | Looks up NEAR testnet accounts, cannot spend | `near_view_account` | +| | **Phishing check** (`phishing-detector`) | Flags emails that ask for money, keys or urgent action, or that try to give the AI orders; never acts on them | `gmail_list_emails`, `gmail_read_email`, `gmail_organize` | +| | **Confidential reader** (`confidential-reader`) | Summarises sensitive emails (contracts, payslips, medical letters) into dates, amounts and obligations; signs or sends nothing | `gmail_list_emails`, `gmail_read_email` | +| | **Redact before send** (`redact-before-send`) | Takes personal data the recipient does not need out of an email or web request and shows what it removed before sending | `mail_send`, `http_request` | +| | **Health journal** (`health-journal`) | Keeps a private log of sleep, meals, symptoms and mood you tell it and sums up your week; gives no medical advice | `get_time` | +| | **Email helper** (`email-triage`) | Reads the owner's Gmail, saves drafts and tidies the inbox when you approve, never sends | `gmail_list_emails`, `gmail_read_email`, `gmail_create_draft`, `gmail_organize`, `get_time` | +| | **Email address** (`email-address`) | Gives this Mind its own email address and sends email after the owner approves | `mail_send`, `mail_list`, `mail_read`, `get_time`, `mail_send_to_owner` | +| | **Follow-ups** (`follow-ups`) | Finds unpaid invoices and unanswered promises in Gmail and drafts polite follow-ups; never sends | `get_time`, `gmail_list_emails`, `gmail_read_email`, `gmail_create_draft` | +| | **Subscriptions & bills** (`subscriptions`) | Finds subscriptions, bills and due dates in Gmail, adds up the costs and adds reminders when you approve | `get_time`, `gmail_list_emails`, `gmail_read_email`, `add_numbers`, `googlecalendar_create_event` | +| | **Spending tracker** (`spending-tracker`) | Reads receipts in Gmail and totals your spending by category; pays nothing | `get_time`, `gmail_list_emails`, `gmail_read_email`, `add_numbers` | +| | **Daily planner** (`daily-planner`) | Time, quick math, Google Calendar events, free time, moving events, and meetings with a Google Meet link; never deletes events | `get_time`, `add_numbers`, `googlecalendar_list_events`, `googlecalendar_create_event`, `googlecalendar_create_meeting`, `googlecalendar_block_time`, `googlecalendar_find_free_time`, `googlecalendar_move_event` | +| | **Calendar conflict check** (`calendar-conflicts`) | Finds double bookings and back-to-back meetings in the owner's week and suggests moves; moves an event only when the owner asks and approves | `get_time`, `googlecalendar_list_events`, `googlecalendar_create_event`, `googlecalendar_find_free_time`, `googlecalendar_move_event` | +| | **Meeting prep** (`meeting-prep`) | One read-only brief for a meeting from the calendar and recent emails with the people in it | `get_time`, `googlecalendar_list_events`, `gmail_list_emails`, `gmail_read_email` | +| | **Morning briefing** (`morning-briefing`) | One read-only briefing of the day's calendar, inbox and wallet | `get_time`, `googlecalendar_list_events`, `gmail_list_emails`, `gmail_read_email`, `get_balance`, `list_payments` | +| | **Google Sheets** (`sheets`) | Finds and reads the owner's spreadsheets, adds a row or changes cells after approval; never clears or deletes cells | `add_numbers`, `googlesheets_find_spreadsheets`, `googlesheets_read_range`, `googlesheets_append_row`, `googlesheets_update_cells` | +| | **Google Docs** (`docs`) | Finds files in Google Drive, reads Google Docs, creates a new Doc or adds text at the end of one after approval; never shares, changes existing text or deletes | `googledrive_find_files`, `googledocs_read_document`, `googledocs_create_document`, `googledocs_append_text` | +| | **Notion** (`notion`) | Searches and reads the owner's Notion pages and databases, adds a page or a row, and changes a row's properties after approval; never clears, archives or deletes | `notion_search`, `notion_read_page`, `notion_create_page`, `notion_add_row`, `notion_query_database`, `notion_update_row` | +| | **Slack** (`slack`) | Lists the owner's Slack channels and posts a message the owner approved; cannot read messages | `slack_list_channels`, `slack_send_message` | +| | **Outlook email** (`outlook`) | Reads the owner's Outlook inbox, sums it up and saves reply drafts; it never sends | `outlook_list_emails`, `outlook_read_email`, `outlook_create_draft` | +| | **Zoom** (`zoom`) | Lists the owner's Zoom meetings, schedules one with a join link after approval, and reads Zoom's AI summary of a past meeting; never deletes, ends or invites | `zoom_list_meetings`, `zoom_create_meeting`, `zoom_meeting_summary` | +| | **HTTP request** (`http-request`) | Calls the owner's own HTTPS APIs with keys saved in Connections, only on the hosts the owner listed | `http_request` | + +Plus the built-in **HelloNear guide**, loaded by every Mind, so it can answer questions about the app without inventing screens or features. + +### How it is tested + +Assertions are on what the engine guarantees (events, approval gating, what was sent), not on wording: +- **Unit:** every SKILL.md parses and uses only registered tools; every list tool returns a `count`; amounts in BigInt; signature checks. +- **Live prompt tests** against real NEAR AI Cloud and local Postgres, with stand-ins for the wallet, Composio and 1Click: `engine/test/skills-*.test.ts` (payments, recipient guard, split bill, mail, Sheets, Notion, calendar, Zoom, cross-chain quotes and more). +- **Secrets:** tests scan every table in the `mastra` schema for a test secret and the wallet token. +- **Load tests** with k6: `engine/load/chat.js`, `engine/load/workflow.js`. + +--- diff --git a/apps/docs/content/api-reference.md b/apps/docs/content/api-reference.md new file mode 100644 index 00000000..ecc777d4 --- /dev/null +++ b/apps/docs/content/api-reference.md @@ -0,0 +1,13 @@ +--- +title: API reference +description: Every route of the HelloNear backend API, rendered from the OpenAPI spec, with the hosted server at https://api.hellonear.xyz. +--- + +The HelloNear backend API is described by an OpenAPI 3 spec, kept in the repository at [`docs/openapi.json`](https://github.com/Hellonear-AI/hellonear/blob/main/docs/openapi.json) and served here at [/openapi.json](/openapi.json). The prose contract, with every field and event, is [`docs/api-contract.md`](https://github.com/Hellonear-AI/hellonear/blob/main/docs/api-contract.md). + +- **Server:** `https://api.hellonear.xyz` (NEAR testnet), or `http://localhost:4000` when you [run it locally](/run-locally). +- **Auth:** every route except health, status and auth needs the session cookie `hn_session`. Get one as a guest with `POST /v1/auth/demo`, or sign in with a NEAR wallet (NEP-413). +- **Errors:** `{ error, ...details }` with an HTTP status. See [Errors](/errors). +- **Streams:** chat, approval and workflow runs answer with server-sent events. See [Streaming events](/events). + +A worked example with curl is in the [Quickstart](/quickstart#through-the-api), and every route in a table is in the [API overview](/api). diff --git a/apps/docs/content/api.md b/apps/docs/content/api.md new file mode 100644 index 00000000..36b62690 --- /dev/null +++ b/apps/docs/content/api.md @@ -0,0 +1,157 @@ +--- +title: API overview +description: How the public HTTP API works, every route, and where the OpenAPI spec lives. +--- + +The web app is a client of a public HTTP API, and everything it does can be done with `curl`. The full spec is **[`docs/openapi.json`](https://github.com/Hellonear-AI/hellonear/blob/main/docs/openapi.json)** (OpenAPI 3.1, 63 operations): open it in [Swagger Editor](https://editor.swagger.io/?url=https://raw.githubusercontent.com/Hellonear-AI/hellonear/main/docs/openapi.json) or any OpenAPI viewer to read every route and try it against the hosted API. Every server-sent event type is described in [`docs/api-contract.md`](https://github.com/Hellonear-AI/hellonear/blob/main/docs/api-contract.md) §3. + +- **Base URL:** `https://api.hellonear.xyz` (NEAR testnet), or `http://localhost:4000`. +- **Auth:** a session cookie, `hn_session`. Get one with `POST /v1/auth/demo` (guest, no wallet) or with a NEAR wallet: `POST /v1/auth/challenge`, sign the message (NEP-413), then `POST /v1/auth/login`. `curl` works as is (no `Origin` header); a browser page on another site gets `403` for any call that changes something (CSRF protection). +- **Streams:** chat, approve/decline, workflow runs and attack runs answer `text/event-stream`: `run.started`, `text.delta`, `tool.called`, `tool.result`, `tool.approval_required`, `run.finished`, `run.verified` and more. +- **Guests** get `403 demo_not_allowed` for owner actions (wallet policy, freeze, memory edits, rules, schedules); everything else works. +- **Checked live:** the last column marks the endpoints called against the hosted API with a guest session on 12 Nov 2026 and answered as documented (owner-only and money-moving endpoints are covered by the backend's integration tests instead). + +**System** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/health` | Health of the backend and the engine | 200 | yes | + +**Auth** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `POST` | `/v1/auth/challenge` | Get a NEP-413 sign-in message and a one-time nonce | 200 | | +| `POST` | `/v1/auth/login` | Sign in with a NEAR wallet signature (NEP-413) | 200 | | +| `POST` | `/v1/auth/demo` | Start a try-out (guest) session: no wallet, 20 messages | 201 | yes | +| `POST` | `/v1/auth/logout` | Sign out | 204 | | +| `GET` | `/v1/me` | The signed-in user | 200 | yes | + +**Catalog** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/templates` | Mind templates | 200 | yes | +| `GET` | `/v1/skills` | Every skill a Mind can equip, with its tools | 200 | yes | +| `GET` | `/v1/skills/{skillId}` | One skill with its playbook (SKILL.md body) | 200 | yes | + +**Minds** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/minds` | The user's Minds, newest first | 200 | yes | +| `POST` | `/v1/minds` | Create a Mind from a template | 201 | yes | +| `GET` | `/v1/minds/{mindId}` | One Mind | 200 | yes | +| `PATCH` | `/v1/minds/{mindId}` | Change a Mind: name, voice, model, skills, memory switches, auto-approve rules | 200 | | +| `DELETE` | `/v1/minds/{mindId}` | Delete a Mind (and its workflows, schedules and wallet key) | 200 | | + +**Chat** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `POST` | `/v1/minds/{mindId}/chat` | Send a message; the reply streams as server-sent events | SSE | yes | +| `GET` | `/v1/minds/{mindId}/threads` | Chat threads, newest first | 200 | yes | +| `GET` | `/v1/minds/{mindId}/threads/{threadId}/messages` | A thread's messages, oldest first, paged by `before` | 200 | | +| `PATCH` | `/v1/minds/{mindId}/threads/{threadId}` | Rename a thread | 200 | | +| `DELETE` | `/v1/minds/{mindId}/threads/{threadId}` | Delete a thread for good (the engine forgets it too) | 200 | | + +**Runs** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/minds/{mindId}/runs` | Runs of a Mind, with tokens and cost | 200 | yes | +| `GET` | `/v1/runs/{runId}` | One run with all its stored events | 200 | yes | +| `POST` | `/v1/runs/{runId}/cancel` | Stop a run that is still streaming | 200 | | +| `GET` | `/v1/minds/{mindId}/events` | Events across runs since a time (Mind Graph history) | 200 | yes | + +**Approvals** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/minds/{mindId}/approvals` | Runs waiting for the owner's approval | 200 | yes | +| `POST` | `/v1/runs/{runId}/approve` | Approve a waiting tool call; the run resumes as SSE | SSE | | +| `POST` | `/v1/runs/{runId}/decline` | Decline a waiting tool call; the run resumes as SSE | SSE | yes | + +**Verification** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/runs/{runId}/proof` | The proof behind a reply's Verified badge | 200 | yes | +| `POST` | `/v1/runs/{runId}/proof/tee-explorer` | Upload the run's Intel quote to Phala's TEE Explorer and get the verified report | 200 | yes | + +**Wallet** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `POST` | `/v1/minds/{mindId}/wallet` | Create the Mind's OutLayer wallet (testnet) | 201 | | +| `GET` | `/v1/minds/{mindId}/wallet` | Balance, spent today, frozen, and the policy | 200 | yes | +| `GET` | `/v1/minds/{mindId}/wallet/payments` | Payment receipts, refused ones included | 200 | yes | +| `GET` | `/v1/minds/{mindId}/payments.csv` | Every payment as a CSV an accountant can open (date UTC, status in words, amount, counterparty, purpose, who approved, tx hash, NearBlocks link) | 200 `text/csv` | yes | +| `GET` | `/v1/status` | Public status of HelloNear and its providers (NEAR AI chat and embeddings, 1Click quotes, OutLayer, NEAR RPC, Agent Market, TEE Explorer): status, latency, uptime, 48 half-hour buckets and incidents of the last 7 days. CORS `*`, cached 30 s | 200 | | +| `POST` | `/v1/relay` | Relay a NEP-366 signed delegate action to the registry (only `unequip_skill` / `set_wallet`, exactly 1 yoctoNEAR); the relayer pays the gas, never a deposit. Not for try-out users | 200, `503 relay_not_configured` until the relayer is set | | +| `POST` | `/v1/minds/{mindId}/wallet/policy` | Build a store_wallet_policy transaction for the owner to sign | 200 | | +| `POST` | `/v1/minds/{mindId}/wallet/freeze` | Build a freeze_wallet transaction for the owner to sign | 200 | | +| `POST` | `/v1/minds/{mindId}/wallet/unfreeze` | Build an unfreeze_wallet transaction for the owner to sign | 200 | | + +**Memory** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/minds/{mindId}/memory` | What the Mind remembers about the owner | 200 | yes | +| `PUT` | `/v1/minds/{mindId}/memory` | Replace the Mind's memory | 200 | | +| `DELETE` | `/v1/minds/{mindId}/memory` | Clear the Mind's memory | 204 | | + +**Email** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/minds/{mindId}/inbox` | The Mind's own email address, if any | 200 | yes | +| `POST` | `/v1/minds/{mindId}/inbox` | Create the Mind's own email address (AgentMail) | 201 | | +| `GET` | `/v1/minds/{mindId}/mail/sent` | Emails the Mind sent, refusals included | 200 | yes | + +**Autopilot** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/minds/{mindId}/workflows` | Saved Builder workflows | 200 | yes | +| `PUT` | `/v1/minds/{mindId}/workflows/{workflowId}` | Save a Builder canvas (compiled to a Mastra workflow) | 200 | yes | +| `GET` | `/v1/minds/{mindId}/workflows/{workflowId}` | One workflow with its canvas | 200 | | +| `DELETE` | `/v1/minds/{mindId}/workflows/{workflowId}` | Delete a workflow and its schedule | 204 | yes | +| `POST` | `/v1/minds/{mindId}/workflows/{workflowId}/runs` | Run a workflow now; steps stream as SSE | SSE | yes | +| `GET` | `/v1/minds/{mindId}/workflows/{workflowId}/runs` | Past runs of a workflow, newest first, with each step | 200 | yes | +| `PUT` | `/v1/minds/{mindId}/workflows/{workflowId}/autopilot` | Turn the schedule on (wallet sign-in only) | 200 | yes | +| `GET` | `/v1/minds/{mindId}/workflows/{workflowId}/autopilot` | The schedule's state | 200 | | +| `DELETE` | `/v1/minds/{mindId}/workflows/{workflowId}/autopilot` | Turn the schedule off | 204 | | + +**Connections** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/connections` | Apps the user connected through Composio | 200 | yes | +| `POST` | `/v1/connections/{toolkit}` | Get a Composio Connect Link for an app | 200 | | +| `DELETE` | `/v1/connections/{toolkit}` | Disconnect an app | 204 | | + +**Telegram** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/minds/{mindId}/telegram` | The Mind's Telegram bot, if connected | 200 | yes | +| `PUT` | `/v1/minds/{mindId}/telegram` | Connect a BotFather token to the Mind | 200 | | +| `DELETE` | `/v1/minds/{mindId}/telegram` | Disconnect the bot | 204 | | + +**Secrets** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/secrets` | Saved API keys (names and hosts, never values) | 200 | yes | +| `PUT` | `/v1/secrets/{name}` | Save an API key for the Mind's HTTP request skill | 200 | | +| `DELETE` | `/v1/secrets/{name}` | Delete a saved key | 204 | | + +**Attack playground** + +| Method | Path | What it does | Answer | Checked live | +|---|---|---|---|---| +| `GET` | `/v1/attacks` | The prompt-injection scenarios | 200 | yes | +| `POST` | `/v1/attacks/{attackId}/runs` | Run a scenario on a hidden test Mind; ends with attack.verdict | SSE | yes | + +--- diff --git a/apps/docs/content/autopilot.md b/apps/docs/content/autopilot.md new file mode 100644 index 00000000..39ab4f4f --- /dev/null +++ b/apps/docs/content/autopilot.md @@ -0,0 +1,27 @@ +--- +title: Autopilot and Builder +description: The visual Builder for jobs a Mind runs, Autopilot schedules, and why unattended jobs get no payment tools. +--- + +The **Builder** is a visual canvas for a job a Mind runs step by step. **Autopilot** runs a Builder job on a schedule, without the owner watching. + +## Steps + +| Step | What it does | +|---|---| +| **Ask the Mind** | A prompt to the Mind, with the Mind's persona and skills | +| **Use a tool** | One tool the owner picked, such as *Email me* or adding to the owner's calendar | +| **Call a website** | An HTTP request, with secrets filled in only for the hosts the owner listed | +| **If or else** | A branch, including nested Ifs and End | + +Canvases compile to Mastra dynamic workflows (`engine/src/builder.ts`, `engine/src/workflows.ts`); Autopilot runs them on Mastra workflow schedules (`engine/src/autopilot.ts`). User text can never become a Mastra template. + +## Unattended jobs are limited + +Autopilot jobs get **no payment or approval tools**. They may only email the owner or add to the owner's calendar, and only as steps the owner placed. *Email me* can only send the Mind's notes to the owner's own connected Gmail; the recipient is never in the request. Scheduled runs get no secrets yet. + +If the Mind changes (persona, model, skills), its Autopilot jobs get the new config; a job the engine cannot run is paused and says why (`pausedFor`). + +## Through the API + +`POST /v1/minds/{mindId}/workflows/{workflowId}/runs` runs a workflow and streams events; `PUT …/autopilot` turns the schedule on or off. The workflow events (`workflow.started`, `node.started`, `node.finished`, `workflow.finished`) are in [Streaming events](/events). diff --git a/apps/docs/content/connections.md b/apps/docs/content/connections.md new file mode 100644 index 00000000..cfc8194f --- /dev/null +++ b/apps/docs/content/connections.md @@ -0,0 +1,30 @@ +--- +title: Connections and keys +description: How a Mind uses your apps through Composio, and how API keys are stored so the model never sees them. +--- + +## App connections + +A Mind works in the owner's apps through **Composio**: Gmail, Google Calendar and Meet, Sheets, Drive, Docs, Notion, Slack, Discord, Outlook, HubSpot and Zoom. The owner connects an app once per account on the Connections page; Composio stores and refreshes the OAuth tokens. + +- Tokens never reach HelloNear's backend, the browser or the model. +- The Composio user id is the HelloNear user id, so a Mind's tools act only on its own owner's accounts. +- Actions that change something wait for the owner's approval. See [Skills and tools](/skills). +- Guests get a fixed, fictional sample inbox and calendar instead of a real account. + +The full list with what each app is for is on [Connectors](/connectors). + +## A Mind's own email address + +With the `email-address` skill, a Mind gets its own inbox on AgentMail (`{name}-{6 id chars}@agentmail.to`), for invoices and replies. Owners can send at most 20 emails per Mind per day. + +## API keys (secrets) + +For a website or API the owner wants a Mind to call, the owner stores a key on the Keys page: + +- Each key has a name (`UPPER_SNAKE_CASE`) and a list of **allowed hosts**. It is only ever sent to those hosts. +- It is stored encrypted with AES-256-GCM, bound to the owner and the key's name (`apps/be/src/crypto.ts`), and never returned by the API. +- The model only ever writes `{{secrets.NAME}}`. The tool fills in the value at execution. Values and wallet tokens live in an in-memory map, so they never reach prompts, traces or stored run snapshots; a test scans every table for them. +- In events, secrets are shown as `••••`. + +Through the API: `GET /v1/secrets` (names and hosts only), `PUT /v1/secrets/{NAME}`, `DELETE /v1/secrets/{NAME}`; `GET /v1/connections`, `POST /v1/connections/{toolkit}`, `DELETE /v1/connections/{toolkit}`. diff --git a/apps/docs/content/connectors.md b/apps/docs/content/connectors.md new file mode 100644 index 00000000..9bf4a549 --- /dev/null +++ b/apps/docs/content/connectors.md @@ -0,0 +1,25 @@ +--- +title: Connectors +description: The apps and services a Mind can use, and what each one is for. +--- + +What a Mind can work with. Logos are the ones the web app shows on the Connections screen (rendered from `apps/fe/src/components/elements/AppLogos.tsx`); each is its owner's trademark, used to name the app. + +| | Connector | How it connects | What a Mind can do with it | +|---|---|---|---| +| | **Gmail** | Composio (OAuth, the owner's account) | Read and search mail, save drafts, archive or label after approval. No send tool exists | +| | **Google Calendar** | Composio | Read events, find free time, add an event, move an event, all with times on the owner's clock | +| | **Google Meet** | Composio | Schedule a meeting with guests the owner named and a Meet link, after approval | +| | **Google Sheets** | Composio | Find and read sheets, add a row, change cells with the old value shown first | +| | **Google Drive** | Composio | Search files by name and content | +| | **Google Docs** | Composio | Read a Doc, create one, add text at the end (never replaces) | +| | **Notion** | Composio | Search and read pages and databases, add a page or a row, change a row's properties | +| | **Slack** | Composio | List channels, post a message the owner approved | +| | **Outlook** | Composio | Read mail and save reply drafts (no send) | +| | **Zoom** | Composio | List meetings, schedule one with a join link, read Zoom's AI summary of a past meeting | +| | **Telegram** | A bot per Mind, made by the owner with BotFather | Chat with the Mind, streamed replies, Approve / Decline buttons on cards; only the owner's chat is answered | +| | **The Mind's own email address** | AgentMail, one inbox per Mind | Send from `…@agentmail.to` after approval, only to addresses the owner typed; read its own inbox with spam and phishing warnings | +| | **NEAR wallet** (Meteor first) | NEAR Connect, NEP-413 sign-in | The owner signs in, sets the Mind wallet's limits and freezes it; the Mind never holds the owner's keys | +| | **HTTP request** (your own APIs) | API keys the owner saves in Connections, stored encrypted | Call any HTTPS API the owner uses (a store, a CRM, a webhook) with the owner's key, only on the hosts the owner listed; the Mind writes `{{secrets.NAME}}` and never sees the key | + +--- diff --git a/apps/docs/content/contract-check.md b/apps/docs/content/contract-check.md new file mode 100644 index 00000000..a826803e --- /dev/null +++ b/apps/docs/content/contract-check.md @@ -0,0 +1,18 @@ +--- +title: Contract check before paying +description: How the Recipient guard skill warns before a plain transfer to a smart contract and asks the owner instead of showing an approval card. +--- + +**Track:** `security`. **Skill:** Recipient guard (`recipient-guard`), in the Payments Mind template. **Tool:** `near_view_account`. + +Before paying, the Mind looks up the recipient on NEAR testnet (`view_account`: exists, balance, storage, `isContract`, `codeHash`). If the account is a smart contract, it warns: it is a contract, not a person's wallet, and NEAR sent to it by a plain transfer may be stuck or do nothing. It pays only if the owner confirms that is what they want. + +## Try it + +With a Payments Mind: *"Pay 0.001 NEAR to hellonear-registry.testnet."* See: a warning that it is a smart contract, and a question. No approval card. + +## Other checks in the same skill + +Recipient guard answers allow, warn or block with the reason: where the account came from, that it exists, lookalikes of people the owner already pays, first payments, and contracts. A first payment to a real account that is not a contact, contract or lookalike is allowed, and the Mind says it is the first payment to it. + +These checks are advice from the model. The hard stops are the owner's approval and the wallet policy. See [Wallet, limits and approvals](/wallet-and-approvals). diff --git a/apps/docs/content/contracts.md b/apps/docs/content/contracts.md new file mode 100644 index 00000000..2dd1d1e4 --- /dev/null +++ b/apps/docs/content/contracts.md @@ -0,0 +1,86 @@ +--- +title: Receipts and smart contracts +description: Every on-chain claim with its transaction: payments, policies, the verified registry contract and the swarm auction round. +--- + +Every link opens a public explorer or report. Nothing here needs an account. + +### On NEAR testnet + +| What happened | Transaction | What it proves | +|---|---|---| +| A Mind's wallet paid 0.01 NEAR after the owner approved, through the hosted stack | [`AKYYpkLq…`](https://testnet.nearblocks.io/txns/AKYYpkLq8XxjL4GKJqdGF5CVTLmjNh3AGEpz2rbcfyYT) | `Transfer` from the Mind wallet `83e05486…` to `lin1er.testnet`. The agent pays from its own wallet, never the owner's | +| An owner saved the Mind's limits, signed in Meteor | [`DhKqbLAX…`](https://testnet.nearblocks.io/txns/DhKqbLAX3zhH2tP3kJDx5Xsk8ZkMByfJbYLyWYyivXXZ) | `store_wallet_policy` on `outlayer.testnet`: the policy lives on chain, set by the owner, not by HelloNear | +| An owner froze the Mind's wallet | [`HHGf2pqG…`](https://testnet.nearblocks.io/txns/HHGf2pqGRGTEJuA7wn4R18swFC4ssL6XMyXyogFHkDgu) | `freeze_wallet` on `outlayer.testnet`: one signature stops every payment | +| A payment went through right after the UTC day reset of the daily limit | [`GUn5P1Dp…`](https://testnet.nearblocks.io/txns/GUn5P1DpuJ3XxMw2s9GJAecHR1BVuVtr4wQhTZ54RjG) | The daily cap is enforced by the wallet and resets at 00:00 UTC | +| The Mind registry contract upgraded to v0.3.0 | [`ESMY36Uo…`](https://testnet.nearblocks.io/txns/ESMY36UoFcdWuw5fbShbNx13Fvf2NB1z1qWWypJNyCwp) | `DeployContract` on `hellonear-registry.testnet`; `contract_source_metadata` answers version 0.3.0, NEP-330 | +| The same v0.3.0 redeployed from a reproducible build, then source-verified | [`DmidjQmo…`](https://testnet.nearblocks.io/txns/DmidjQmoN15bj2qctXaXDefAW5NGJZFBPqqPPFJoa6Qb) | `build_info` names the build image and commit `95c2b3d`; NearBlocks shows the contract as verified through SourceScan (code hash `GUxsMNJd…`) | +| A Mind equipped a published skill, paying its publisher | [`6diDXaAY…`](https://testnet.nearblocks.io/txns/6diDXaAYmT8pMtVemsv4xtmzSE8DW7WM5Uprim6aU2a5) | `equip_skill` on the registry | + +A payment the policy refuses has **no transaction at all**: OutLayer refuses it in the TEE before signing. The app and the Mind never show a tx link for one. + +### The registry contract's source is verified + +`hellonear-registry.testnet` runs exactly the code in this repository at commit `95c2b3d`. It was built reproducibly (NEP-330) and verified through SourceScan, so anyone can rebuild it and get the same hash. + +| | | +|---|---| +| **Status** | **Verified**. The [NearBlocks contract tab](https://testnet.nearblocks.io/address/hellonear-registry.testnet?tab=contract) shows the verified source, and its verify page answers "Contract already verified" | +| **Code hash on chain** | `GUxsMNJdJKoFq7VJawNeCwW7GjGZE6TpURPj13ojEnub` | +| **Deploy transaction** | [`DmidjQmoN15bj2qctXaXDefAW5NGJZFBPqqPPFJoa6Qb`](https://testnet.nearblocks.io/txns/DmidjQmoN15bj2qctXaXDefAW5NGJZFBPqqPPFJoa6Qb) (12 Nov 2026, code-only, state unchanged) | +| **Source** | [`Hellonear-AI/hellonear@95c2b3d`](https://github.com/Hellonear-AI/hellonear/tree/95c2b3d839357583224b4c8fa64b0f03cddc3f80), folder `sc` | +| **Build image** | `sourcescan/cargo-near:0.21.1-rust-1.96.0@sha256:ccb22bb4e677ed022d8b9d1aa1b32f0af52dd0471ef1c32e48dedbf68ee6ee17` | +| **Verifier** | SourceScan `v2-verifier.sourcescan.testnet`; its record holds the same code hash and the source on IPFS (`QmX4dYjf9v798uF4Uuf11EPMA83Le84sCg6UsmaGdgrMdc`) | + +Check it without a browser (public RPC, no key). Each command should print the value in the table: + +```sh +RPC=https://test.rpc.fastnear.com + +# 1. The code hash deployed on the account +curl -s $RPC -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"query","params":{"request_type":"view_account","finality":"final","account_id":"hellonear-registry.testnet"}}' | jq -r .result.code_hash + +# 2. The contract names its own source and build (NEP-330 contract_source_metadata) +curl -s $RPC -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"query","params":{"request_type":"call_function","finality":"final","account_id":"hellonear-registry.testnet","method_name":"contract_source_metadata","args_base64":"e30="}}' | jq -r '.result.result | implode | fromjson | .build_info' + +# 3. SourceScan's verification record for the account +curl -s $RPC -H 'content-type: application/json' -d '{"jsonrpc":"2.0","id":1,"method":"query","params":{"request_type":"call_function","finality":"final","account_id":"v2-verifier.sourcescan.testnet","method_name":"get_contract","args_base64":"eyJhY2NvdW50X2lkIjoiaGVsbG9uZWFyLXJlZ2lzdHJ5LnRlc3RuZXQifQ=="}}' | jq -r '.result.result | implode | fromjson | .code_hash' +``` + +To rebuild it yourself (needs Docker): `git checkout 95c2b3d && cd sc && cargo near build reproducible-wasm`, then compare the SHA-256 (base58) of `target/near/hellonear_mind_registry.wasm` with the code hash above. + +### The swarm auction: one real round on testnet + +The group-buying auction contract (`sc/swarm`, rules in [`RULES.md`](https://github.com/Hellonear-AI/hellonear/blob/main/sc/swarm/RULES.md)) is deployed at **[`auction.hellonear-swarm.testnet`](https://testnet.nearblocks.io/address/auction.hellonear-swarm.testnet?tab=contract)**. It was built reproducibly from commit `64c9278`, and its **source is verified** through SourceScan (code hash `6Wn9K6b3DtoH4TnoXs2jx6zFzihdzFDQGw4ae2dzcCv1`, deploy [`FkvHpxf9…`](https://testnet.nearblocks.io/txns/FkvHpxf9ff8LBeMcLEqSbhmFUbhcx5PebyG3qzJdQAwo)). Every agent is its own sub-account of `hellonear-swarm.testnet`. Round 0 (13 Nov 2026) had 3 buyers wanting 6 "gpu-hours", a ceiling of 0.01 NEAR per unit, and 2 sellers bidding sealed asks: + +| Step | Who | Transaction | What it shows | +|---|---|---|---| +| Open the round | `coordinator` | [`B4CFzH9o…`](https://testnet.nearblocks.io/txns/B4CFzH9oCH8smUfCbTeKD7hNLPAmCwgzegzmnodavQaj) | Ceiling 0.01 NEAR per unit, seller bond 0.01 NEAR, a fixed 3 min commit window and 2 min reveal window | +| Join with escrow | `buyer-1`, `buyer-2`, `buyer-3` | [`GdBiXyn4…`](https://testnet.nearblocks.io/txns/GdBiXyn44oTHPEtcdxiZNdE9xdCPjPqiJUbUniGuVLG6) [`Eo4m23zh…`](https://testnet.nearblocks.io/txns/Eo4m23zhYhpxGTMZB7FxAK7oZAp6rCLFJvkJnrDMRQJJ) [`cgt2zw9v…`](https://testnet.nearblocks.io/txns/cgt2zw9vewKo9HQQC9g8FJFcu5GXM3n9FBWWCzcheaY) | 2, 3 and 1 units, each paying units × ceiling into escrow | +| Sealed asks | `seller-1`, `seller-2` | [`CQUFGq7K…`](https://testnet.nearblocks.io/txns/CQUFGq7KoJ9VH5pi78GyvA84TLxrDTw1D8wgnuECmSH9) [`4FsTkdpw…`](https://testnet.nearblocks.io/txns/4FsTkdpwJDxX4xXxWp1jfxXo8pLtN1cQizdbMnjP67iN) | Only a SHA-256 commitment (round, seller, ask, capacity, salt) plus the bond. Nobody can see the price | +| Reveal | `seller-1`, `seller-2` | [`Gu7qQBFn…`](https://testnet.nearblocks.io/txns/Gu7qQBFnV8uUCgp3VgjxntrNzwSnczWLxsq6TLi3U6pw) [`4EPJqmC6…`](https://testnet.nearblocks.io/txns/4EPJqmC6dtzSGADFLnNqffo3DMkvxEmxVuTmbcFFuyyC) | 0.006 NEAR × 4 units and 0.008 NEAR × 5 units; each must hash to its commitment, and the bond comes back | +| Close (a buyer, not the organizer) | `buyer-2` | [`44guvtrj…`](https://testnet.nearblocks.io/txns/44guvtrj8riB75rgQiC1kfMsBQzYHQcmruR3cdA4eL5C) | All 6 units filled at **one clearing price, 0.008 NEAR**: seller-1 sold 4, seller-2 sold 2. Buyers paid 0.048 NEAR in total and sellers earned 0.048 NEAR | +| Withdraw | each agent | [`CNsVsstu…`](https://testnet.nearblocks.io/txns/CNsVsstuuumXzjLbjGTFWXEYVXtw1bDfcTsiej7PEy7s) [`E2Amtv9p…`](https://testnet.nearblocks.io/txns/E2Amtv9pnSWdLhQoFaXeZxuxrm8Jjhc8NBgLbcDMcnJC) [`APe2tSRJ…`](https://testnet.nearblocks.io/txns/APe2tSRJqZrcrKUMNhsKnMjvCFcMLfWD4ayHqSvpMgD2) [`3WYa3qLP…`](https://testnet.nearblocks.io/txns/3WYa3qLPAP57WCg5fM7ptgQ6QyKv31M6f7r66NWDGBw6) [`5qV7kPVS…`](https://testnet.nearblocks.io/txns/5qV7kPVSVV17KzvCZBLVbtHbM52ZDnrRtmtaM36V6f9w) | Buyers pull their change (0.004, 0.006 and 0.002 NEAR); sellers pull sales plus bond (0.042 and 0.026 NEAR) | + +Read the round yourself: `get_round` with `{"round_id":0}` on `auction.hellonear-swarm.testnet` (public RPC, no key). The full 20-buyer, 5-seller simulation runs on a local sandbox: `cd sc/swarm && cargo test --test simulation -- --nocapture`. + +### The proof behind a verified reply (NEAR AI Cloud TEE) + +| | | +|---|---| +| **Claim** | The reply came from NEAR AI's gateway TEE, and every step was signed by the key that hardware vouches for. | +| **Where it is checked** | `engine/src/verify.ts`, before the badge is shown. The signatures, hashes (never the conversation) and Intel's TDX quote are kept on `run.verified`. | +| **Open it** | Verified badge → **View proof** → **Check it in TEE Explorer**. The backend uploads the Intel quote to Phala's TEE Attestation Explorer and the app opens the report. | +| **A real report** | [proof.t16z.com/reports/1b374e5b…](https://proof.t16z.com/reports/1b374e5b10031496c6c45bc7749038d7e7cd26a16996455f893b6b5dd44a9db2): **VERIFIED**. Its report data ends with that run's nonce (`…99e266`), and its MRCONFIG carries the compose hash (`877959253d…`) in our proof. | + +### NEAR Intents quotes, signed by 1Click + +| | | +|---|---| +| **Claim** | The numbers a Payments Mind shows for a cross-chain payment are NEAR Intents' own. | +| **How** | `crosschain_quote` calls 1Click `POST /v0/quote` with `dry: true`. 1Click signs every quote (ed25519); the engine checks it with the official SDK's `verifyQuoteSignature` and returns `proof: { signedBy1Click, signature, quoteHash, publicKey }`. | +| **Live quotes** | 10 USDC on NEAR → **9.99558 USDC on Base** (~22 s); 25 USDT on NEAR → **24.98 USDT on Solana** (~17 s). | +| **Tested** | `engine/test/crosschain.test.ts`: a real signed quote recorded from 1Click verifies; the same quote with `amountOut` changed by one unit does not. | +| **Honest caveat** | It is a quote: NEAR Intents has no testnet and HelloNear's wallets are on testnet, so nothing is sent, and the Mind says so in every reply. | + +--- diff --git a/apps/docs/content/errors.md b/apps/docs/content/errors.md new file mode 100644 index 00000000..9a36d3af --- /dev/null +++ b/apps/docs/content/errors.md @@ -0,0 +1,47 @@ +--- +title: Errors +description: The shape of every error the HelloNear API returns, what each status means, and the codes you are most likely to meet. +--- + +Every error is JSON: `{ "error": "", ...details }` with an HTTP status. The `error` code is stable; details depend on the code. + +## Status codes + +| Status | Meaning | +|---|---| +| `400` | The request is wrong: `invalid_json`, `invalid_body`, an unknown skill, an unknown time zone | +| `401` | `unauthorized` (no session or an expired one), `invalid_signature`, `invalid_nonce` (wallet sign-in) | +| `403` | Not allowed: `bad_origin` (a state-changing request from an origin not in `FE_ORIGIN`), `demo_not_allowed` (an owner action from a try-out user) | +| `404` | Not found. **Another user's Mind or run answers `404`, never `403`**, so ids cannot be probed | +| `409` | A conflict with the current state, such as `not_awaiting_approval`, `not_running`, `thread_busy`, `wallet_not_empty`, `already_connected` | +| `413` | `body_too_large` (bodies are at most 256 KB) | +| `422` | `not_a_quote` (TEE Explorer upload of anything but a hex quote) | +| `429` | A rate limit: `demo_run_limit`, `demo_rate_limited`, `relay_rate_limited`, `mail_rate_limited` | +| `503` | A service HelloNear depends on failed | + +## Why 503 and never 502 + +When OutLayer, Composio, the engine or the NEAR RPC fails, the answer is **`503`**, never `502`. Behind Cloudflare a `502` or `504` body is replaced by Cloudflare's own HTML page, so the caller would lose the error. Two families: + +- `…_error`: the service answered with a failure; details carry its status (for example `outlayerStatus`, `composioStatus`). +- `…_unreachable` and `engine_unavailable`: no answer; details carry `reason` (`timeout` or a network code such as `ECONNREFUSED`). + +Every 5xx is logged on the server as one line with the route, code and details, never keys. + +## Payment results + +A payment refused by the wallet is not an HTTP error of your request; it is the tool's result inside the run: + +| Result | Meaning | +|---|---| +| `policy_denied` | Over the per-payment or daily limit, or to an address not on the list. Refused in the TEE before signing, so there is **no transaction** | +| `wallet_frozen` | The owner froze the wallet. No transaction | +| `pending_approval` | The wallet's own approval threshold applies; it resolves to `success` with a `tx_hash`, or `failed` | + +Never show a transaction link, or "rejected on-chain", for a refused payment. + +## Run errors + +A run that fails sends a `run.error` event with a code, for example `run_interrupted` when a backend restarted mid-run. See [Streaming events](/events). + +The full list of codes per route is in [`docs/api-contract.md`](https://github.com/Hellonear-AI/hellonear/blob/main/docs/api-contract.md) §7. diff --git a/apps/docs/content/events.md b/apps/docs/content/events.md new file mode 100644 index 00000000..99af5d3d --- /dev/null +++ b/apps/docs/content/events.md @@ -0,0 +1,70 @@ +--- +title: Streaming events +description: The server-sent events every chat, approval, workflow and attack run streams, in order. +--- + +The engine **normalizes** Mastra stream chunks into these events. The browser and the Mind Graph depend on this format, not on raw Mastra chunks, so a Mastra upgrade cannot break the UI. + +Common fields on every event: + +| Field | Type | Notes | +|---|---|---| +| `v` | `1` | contract version | +| `type` | string | see below | +| `runId` | string | Mastra `runId` | +| `mindId` | string | | +| `seq` | integer | 0, 1, 2… per run; the backend uses `(runId, seq)` as the primary key | +| `ts` | string | ISO 8601, set by the engine | + +### Event types + +| `type` | Extra fields | From Mastra chunk | +|---|---|---| +| `run.started` | `threadId`, `model`, `nodeId` (`model:{modelId}`), `skills` (ids actually loaded) | `start` | +| `step.started` | `step` (1-based) | `step-start` | +| `reasoning.delta` | `text` | `reasoning-delta` (glm only; DeepSeek sends none) | +| `text.delta` | `text` | `text-delta` Em and en dashes are replaced by a plain hyphen before the event is sent (house style, #109, #124); the TEE verification covers the model's own bytes | +| `tool.called` | `toolCallId`, `tool`, `nodeId`, `args`; `approvedBy: "rule"` and `rule: "tool" \| "payment"` when an owner's auto-approve rule (#167) lets the call run without a `tool.approval_required` | `tool-call`: payload `{ toolCallId, toolName, args }` | +| `tool.result` | `toolCallId`, `tool`, `nodeId`, `result`, `status: "ok"` | `tool-result`: payload `{ toolCallId, toolName, args, result }` | +| `tool.error` | `toolCallId`, `tool`, `nodeId`, `status: "error" \| "policy_denied" \| "wallet_frozen" \| "rejected" \| "rate_limited"`, `error`, `result?` | `tool-error`; for `send_payment`, a `tool-result` whose `status` is `policy_denied` / `wallet_frozen` (the wallet refused before signing, #42): `error` is OutLayer's message, `result` the payment receipt without `txHash`; for `mail_send`, a `tool-result` whose `status` is `rejected` / `rate_limited` (#96): `error` is the refusal's `message`, `result` the send record without `messageId` | +| `tool.approval_required` | `toolCallId`, `tool`, `nodeId`, `args` | `tool-call-approval` | +| `step.finished` | `step`, `usage` | `step-finish` | +| `run.finished` | `finishReason`, `text`, `usage`, `costUsd`, `verification: { status: "pending" }` | `finish` | +| `run.finished` (canceled) | `status: "canceled"`, `finishReason: "canceled"`; no `text`, `usage` or `costUsd`, and no `run.verified` after it | **backend**, not the engine: the last event of a run stopped with `POST /v1/runs/{runId}/cancel` (#121); a builder run gets `workflow.finished` with `status: "canceled"` instead | +| `attack.verdict` | `attackId`, `attacker`, `paymentTool` (the Mind's skills grant `send_payment`), `stoppedBy`: `model` (refused, asked for no payment) · `no_tool` (no payment tool) · `approval` (a payment card waits for the owner) · `policy` (approved, then refused by the wallet in OutLayer's TEE before signing: `policy_denied` / `wallet_frozen`, no tx) · `none` (a payment was sent), `detail`, optional `to`, `status`, `attackerTargeted` (the payment went to the scenario's attacker), `txHash` (only for `none`) | engine (`src/attacks.ts`, #16), on a run that carries `attackId`, after `run.finished` and before `run.verified` | +| `thread.titled` | `threadId`, `title` (3 to 6 words summing up the user's first message, in the user's language, no quotes or final period) | engine (`src/titles.ts`, #86, #93), after the `run.finished` of a thread's first run and before `run.verified`; skipped if making the title fails or takes too long, and then the backend keeps the first-message cut | +| `run.verified` | `model`, `nodeId`, `verification` (see below). Always the run's **last** event | engine, after the stream is read | +| `run.error` | `error` | `error` chunk or a thrown error. The backend adds one itself when the engine stream breaks (`engine_stream_interrupted`), and when a run stayed `running` after a backend restart (`run_interrupted`, #218) | +| `workflow.started` | `workflowId`, `nodeId` (`workflow:{workflowId}`), `model`, `skills` | `workflow-start`; first event of a builder run | +| `node.started` | `node` (canvas node id), `nodeType` (`agent \| tool \| http`), `nodeId` (Mind Graph) | `workflow-step-start` | +| `node.finished` | `node`, `nodeType`, `nodeId`, `status: "ok"` + `output`, or `status: "error"` + `error` | `workflow-step-result` | +| `workflow.finished` | `workflowId`, `status` (`success`, `failed`, …) | `workflow-finish`; followed by `run.verified` as the last event | + +`usage` = `{ "inputTokens": 441, "outputTokens": 28, "reasoningTokens": 2, "totalTokens": 469 }`. It is only filled while streaming when the engine builds models with `@ai-sdk/openai-compatible` + `includeUsage: true`; with the `nearai/` router string it is empty. + +`costUsd` = `inputTokens × input price + outputTokens × output price`, prices from `GET https://cloud-api.near.ai/v1/model/list` (cached by the engine). + +`verification` (on `run.verified`), computed with `@nearai/inference-sdk` (`verifyResponse` per completion, after Gateway and model attestation): +- `{ "status": "verified", "level": "model_tee" | "gateway_tee", "completionIds": [...] }`: every model step verified. `model_tee` only if every step was signed inside the model TEE (`provider_tee`); streaming completions are signed by the Gateway TEE, so a normal chat run is `gateway_tee` (measured 3 Nov). + - `proof` (#254, optional: present when every step carried its evidence; absent on runs before it) = `{ checkedAt, steps: [{ id, signatureKind, signer: { algo, address }, signedText, signature, attestation }], attestations: { [attestation]: { kind: "gateway" | "model", signer: { algo, address }, nonce, intelQuote, tcbStatus, gpuEvidence?, composeHash?, osImageHash? } } }`. Taken from the SDK's own `verifyResponse` result, nothing fetched again, no API key. `signedText` is `{request_hash}:{response_hash}` (gateway) or `{model}:{request_hash}:{response_hash}`: hashes only. Each step's `attestation` keys the attestation whose signer signed it; anyone can check the `intelQuote` at https://proof.t16z.com. About 12 KB per run (a 10,012-character quote for one gateway attestation, measured 11 Nov), so the backend stores it but leaves it out of the stream (chat, approve/decline, Telegram), `GET /v1/runs/{runId}` and the Mind Graph's events, and serves it on its own at `GET /v1/runs/{runId}/proof` (#254). +- `{ "status": "not_applicable", "reason": "incognito_model" | "no_completions" }`: Incognito models (`verifiable: false` in the model list) never get the private badge. +- `{ "status": "failed", "completionIds": [...], "errors": [...] }`: show no badge. + +UI wording: `model_tee` → "Verified private (model TEE)"; `gateway_tee` → "Verified via NEAR AI TEE gateway"; anything else → no badge. + +Builder runs (#20) send `workflow.started → node.started/node.finished… → workflow.finished → run.verified`. Inside an `agent` node the chat events appear between its `node.started` and `node.finished` (`step.*`, `reasoning.delta`, `text.delta`, `tool.*`), but no `run.started` / `run.finished`. A run with no agent node ends with `run.verified` `{ status: "not_applicable", reason: "no_completions" }`. Condition nodes emit nothing; only the branch that ran appears. + +Example sequence for one tool call: + +```text +run.started → step.started{1} → reasoning.delta… → tool.called{addNumbers} → tool.result{addNumbers} +→ step.finished{1} → step.started{2} → text.delta… → step.finished{2} → run.finished +``` + +### Not forwarded to the browser + +`tool-call-input-streaming-start`, `tool-call-delta`, `tool-call-input-streaming-end`, `text-start`, `text-end`, `reasoning-start`, `reasoning-end`, `raw`. The engine drops them; nothing in the UI needs partial tool arguments. + +### Secrets in events + +No event may contain a secret value. The engine redacts known secret **values** (not just field names) in every event field, including `run.error`, before emitting, replacing them with `"••••"`. diff --git a/apps/docs/content/hackathon-phase.md b/apps/docs/content/hackathon-phase.md new file mode 100644 index 00000000..afa4bbb7 --- /dev/null +++ b/apps/docs/content/hackathon-phase.md @@ -0,0 +1,40 @@ +--- +title: Hackathon phase and roadmap +description: What runs on NEAR testnet during the hackathon, what becomes real on mainnet, and the roadmap. +--- + +During the hackathon HelloNear runs on **NEAR testnet**, so judges can try everything for free with test tokens and a guest session. Some features therefore stop one step short of real money on purpose. Each becomes real on mainnet with the same approvals and limits. + +| Feature | During the hackathon (testnet) | On mainnet | +|---|---|---| +| **Payments** | Testnet NEAR from each Mind's OutLayer wallet, policy checked in a TEE | Real NEAR and stablecoins, same policy, approvals and Freeze | +| **Cross-chain stablecoins (NEAR Intents)** | Real quotes from 1Click, signature checked; nothing is sent, because NEAR Intents has no testnet | The Mind sends the payment it quoted, after the owner approves | +| **NEAR AI Agent Market (market.near.ai)** | Real agents and real prices (each agent's x402 answer); the Mind picks the cheapest within the owner's budget, but **hires no one**, because the market is paid in USDC on NEAR mainnet | The Mind **hires the agent for real**: one signed USDC transfer (NEP-366) behind the owner's approval card, and the agent's result comes back into the chat. Haggling then moves to the market's job board (post the job with a budget, compare bids, answer one counter) | +| **Haggling** | One offer to the sellers of HelloNear's own testnet data shop (two sellers on the hosted demo) | The same playbook with real sellers and the job board above | +| **Swarm auction** | Contract live and source verified at `auction.hellonear-swarm.testnet`; one round ran with scripted agent accounts, the 20-buyer simulation runs on a local sandbox | Minds join group-buying rounds from the app with their own wallets | +| **Relayer (NEP-366)** | **Live on the hosted demo** for two registry methods (`unequip_skill`, `set_wallet`), paid by `relayer.hellonear-swarm.testnet`, whose only key lives on the server; never pays a deposit, not for try-out users | Pays the gas for owners' calls to HelloNear's contracts, so owners never need NEAR for gas | + +Also stated plainly: +- **App accounts:** Gmail, Google Calendar and Meet, Sheets, Drive, Docs and Notion were used by the team with real accounts. Changing Sheets cells, moving Calendar events, updating Notion rows and appending to Docs were tested against a stand-in for Composio, not yet on a real account. Zoom, Outlook and Slack are wired but not yet tried with a real account. +- **The owner's payment rule** was tested on a local stack against a stand-in OutLayer. OutLayer's TEE checks every payment either way. +- **Model behaviour varies.** Over repeated runs the model sometimes declines a payment it could have put on a card. The approval and the wallet policy, not the model, are what guarantee the outcome. + +--- + +## Now and after the hackathon + +**During the hackathon (now):** everything runs on NEAR testnet so judges can try it for free. +- **Guest mode:** *Continue as guest* makes a temporary user with 20 messages, a Mind from any template, sample inbox and calendar data, and payments from a shared test wallet with HelloNear's limits. No wallet, account or payment needed; data is deleted after 7 days. +- **The AI is on us:** every reply runs on NEAR AI Cloud with the team's own credits. +- **Signing in with a NEAR wallet** (Meteor first) gives the full app: your own Mind wallet, limits, freeze, rules, connections and Autopilot. + +**After the hackathon:** +- **Mainnet.** Deploy the registry and the Mind wallets on NEAR mainnet; cross-chain stablecoin payments through NEAR Intents can then be sent, not only quoted, under the same limits and approvals. +- **Pay-as-you-go AI credits.** Owners top up credits and pay for what their Minds use. Each run already records its tokens and cost. +- **More Mind templates** beyond the three today, each starting with the skills for its job. +- **Hiring on the Agent Market.** On mainnet a Mind can pay a market.near.ai agent itself: the payment is one signed delegate action (NEP-366) for the agent's quoted USDC price, behind the owner's approval card and wallet limits, and the agent's result comes back into the chat. +- **Haggling through the Agent Market's job board.** The Mind posts the owner's job with their budget, compares the bids that come in, answers one counter, and funds the escrow only through the owner's approval card. Today it compares the fixed prices of several agents and picks the cheapest within the budget. +- **The swarm auction on chain for Minds.** Minds join group-buying rounds of the swarm auction contract (`sc/swarm`) with their own wallets, so several owners' Minds pool demand and pay one clearing price. +- **Images and voice.** Owners send their Mind a photo (a receipt, an invoice, a screenshot) or a voice message, and the Mind reads it and acts on it, with the same approvals and limits. + +--- diff --git a/apps/docs/content/haggling.md b/apps/docs/content/haggling.md new file mode 100644 index 00000000..f0e8ee7f --- /dev/null +++ b/apps/docs/content/haggling.md @@ -0,0 +1,27 @@ +--- +title: Haggling with a seller +description: How a Mind makes one offer below a seller's price, within the owner's budget, then buys at the agreed price or walks away. +--- + +**Track:** `agents`. **Skill:** Best price buyer (`best-price`). **Tools:** `get_quotes`, `make_offer`, `buy_data`, `send_payment`. + +When a data report costs more than the owner's budget, the Mind makes **one** offer to one seller, then either buys at the agreed price (after the owner approves) or walks away and pays nothing. It never makes a second offer. + +## Try it + +In the app, with a Payments Mind: *"Buy the gas price report, but I only want to pay 0.0006 NEAR. Haggle if it costs more."* See: the sellers' prices, then **Made an offer**, then an approval card at the agreed price, or a reply that it walked away. + +## How the seller answers + +The sellers are HelloNear's own test shop (`apps/be/src/shop.ts`). Each seller has a floor, a share of its list price (default 0.8): + +- An offer at or above the floor is `accepted` (never above the list price). +- An offer below the floor gets one `countered` price, halfway to the list price but not under the floor. + +It is stateless: the paid step carries the same offer, and the backend checks the payment against the agreed price. An offer under the floor never lowers it. + +## How payment is checked + +The shop answers `402` with a price and an address. The Mind pays through its wallet (owner approval, then the OutLayer policy), and the backend serves the report only for this Mind's own sent payment, confirmed on NEAR testnet by RPC, used once. This is a 402 pattern on testnet NEAR, not the x402 standard. + +The Mind only picks sellers its wallet may pay: the quotes say `onYourList`, read from the wallet's own policy. diff --git a/apps/docs/content/how-it-works.md b/apps/docs/content/how-it-works.md new file mode 100644 index 00000000..46d92fae --- /dev/null +++ b/apps/docs/content/how-it-works.md @@ -0,0 +1,73 @@ +--- +title: How it works +description: The parts of HelloNear and how one payment goes from a chat message to a NEAR transaction. +--- + +```mermaid +flowchart LR + O([Owner]) -->|chat, approve| FE[Web app Next.js] + O -->|chat, approve| TG[Telegram bot] + O -->|signs policy, freeze| MW[Meteor wallet] + FE --> BE[Backend API NEP-413 sign-in, runs, approvals] + TG --> BE + BE -->|mind config + skills| EN + + subgraph EN[Engine · Mastra 1.81] + direction TB + AG[One generic Mind agent persona, memory, skills from RequestContext] + TL[[53 tools granted only by equipped skills]] + WF[Visual Builder workflows + Autopilot schedules] + AG --> TL + WF --> TL + end + + EN -->|every model call| NAI[(NEAR AI Cloud TEE inference)] + NAI -->|signature + attestation| VER{{verify before the badge}} + TL -->|wallet routes| BE + BE -->|transfer| OL[(OutLayer wallet policy checked in a TEE)] + MW -->|store_wallet_policy, freeze_wallet| OLC[(outlayer.testnet)] + OL --> NEAR[(NEAR testnet)] + TL -->|dry quote| INT[(NEAR Intents 1Click)] + TL -->|Gmail, Calendar, Sheets, Notion…| CMP[(Composio)] + BE -->|Intel quote| TEX[(Phala TEE Explorer)] + TL -->|view_account, tx| RPC[(NEAR RPC)] + BE -.->|registry| REG[(hellonear-registry.testnet)] +``` + +### One payment, call by call + +```mermaid +sequenceDiagram + autonumber + participant O as Owner + participant A as Mind (Mastra agent) + participant M as NEAR AI Cloud (TEE) + participant B as Backend + participant W as OutLayer (TEE) + participant N as NEAR testnet + + O->>A: "Pay 0.01 NEAR to alice.testnet" + A->>M: model call (streamed) + M-->>A: tool call near_view_account + A->>N: RPC view_account alice.testnet + N-->>A: account exists + M-->>A: tool call send_payment + Note over A: requireApproval: the run pauses (unless an owner rule covers it) + A-->>O: approval card: amount, recipient, checks + O->>B: Approve + B->>A: resume the run + A->>B: /internal/v1/wallet/send_payment (wallet token) + B->>W: transfer request + alt inside the policy + W->>N: signed transfer + N-->>W: tx hash + W-->>A: sent + txHash + else over the limit, not on the list, or frozen + W-->>A: policy_denied / wallet_frozen, no tx + end + A-->>O: receipt (or "refused before signing") + A->>M: fetch signatures + attestation + Note over A: run.verified: badge shown only if every step matches the attested key +``` + +--- diff --git a/apps/docs/content/index.md b/apps/docs/content/index.md new file mode 100644 index 00000000..ea8e7c84 --- /dev/null +++ b/apps/docs/content/index.md @@ -0,0 +1,43 @@ +--- +title: Introduction +description: HelloNear gives a person a Mind, an AI agent with a persona, memory, skills and its own NEAR wallet, whose money rules sit outside the model. +--- + +HelloNear gives a person a **Mind**: an AI agent with a persona, memory, skills it can equip and its own NEAR wallet. It reads your email, works in your apps and pays your bills, but **every limit that matters sits outside the model**: the owner approves, and the wallet's policy is checked inside a TEE before anything is signed. Every reply comes from NEAR AI Cloud's TEE with a proof you can check yourself. + +Built at **NEAR HACKATHON** (1 to 14 Nov 2026) for six tracks: `security`, `privacy`, `agents`, `swarms`, `business`, `realworld`. Everything runs on **NEAR testnet** during the hackathon. + +## Live now + +| | | +|---|---| +| Web app (no account needed: *Continue as guest*) | [app.hellonear.xyz](https://app.hellonear.xyz) | +| Landing page | [hellonear.xyz](https://hellonear.xyz) | +| API (NEAR testnet) | [api.hellonear.xyz/v1/health](https://api.hellonear.xyz/v1/health) | +| Status, checked every 5 minutes | [status.hellonear.xyz](https://status.hellonear.xyz) | +| Mind registry contract | [`hellonear-registry.testnet`](https://testnet.nearblocks.io/address/hellonear-registry.testnet?tab=contract) (v0.3.0, source verified) | +| Swarm auction contract | [`auction.hellonear-swarm.testnet`](https://testnet.nearblocks.io/address/auction.hellonear-swarm.testnet?tab=contract) (source verified) | +| OpenAPI spec | [openapi.json](/openapi.json), rendered in the [API reference](/api-reference) | +| Repository | [github.com/Hellonear-AI/hellonear](https://github.com/Hellonear-AI/hellonear) | + +## The problem + +An AI assistant that can pay is one prompt injection away from paying the wrong person. A rule written in the system prompt ("never send more than X") is advice to the model, not a limit: a malicious email, calendar invite or web page can talk the model out of it. And an AI that reads your private email should not leak it to the infrastructure it runs on. + +HelloNear's answer is to **take the limits out of the model** and **make the model's work verifiable**: + +1. **Every payment asks the owner,** in the app or in Telegram, unless the owner turned on a rule for small payments to listed addresses. Without an approval or a rule, the payment tool cannot run. +2. **The wallet enforces its own policy.** Each Mind's wallet is an [OutLayer](https://outlayer.ai) wallet whose policy (per-payment limit, daily limit, allowed recipients) is stored on NEAR and checked in a TEE before anything is signed. A payment over the limit or to an unknown address is refused **even if the owner approved it**, and no transaction exists. +3. **Freeze.** One transaction, signed in the owner's own NEAR wallet, stops everything. +4. **Private, verifiable inference.** Every model call runs on NEAR AI Cloud inside a TEE. HelloNear checks each reply's signature against the hardware attestation before it shows the "Verified" badge, keeps that proof, and lets anyone open it on Phala's TEE Attestation Explorer. + +## Where to go next + +- [Quickstart](/quickstart): try it in two minutes as a guest, or drive it with curl. +- [Minds and templates](/minds), [Skills and tools](/skills), [Wallet, limits and approvals](/wallet-and-approvals): the core ideas. +- [API reference](/api-reference): every route, from the OpenAPI spec. +- [Trust](/trust): every claim on this site with a link you can check. + +## For AI agents + +This site is readable by machines: [/llms.txt](/llms.txt) lists every page, [/llms-full.txt](/llms-full.txt) has them all in one file, any page is available as Markdown by adding `.md` to its path, [/skill.md](/skill.md) describes how to use HelloNear, and an MCP server at [/mcp](/mcp) offers `search_docs` and `read_page`. diff --git a/apps/docs/content/minds.md b/apps/docs/content/minds.md new file mode 100644 index 00000000..8c6286f0 --- /dev/null +++ b/apps/docs/content/minds.md @@ -0,0 +1,34 @@ +--- +title: Minds and templates +description: What a Mind is, the three templates it starts from, and what the owner can change afterwards. +--- + +A **Mind** is one AI agent with one job. It has a name and a voice (its persona), a memory of its owner, the skills it has equipped and, when it needs to pay, its own NEAR wallet. One owner can have several Minds. + +## Templates + +A Mind starts from a template. The template picks its starting skills; the owner can equip or remove skills afterwards on the Skills page. + +| Template | `templateId` | Starting skills | +|---|---|---| +| **General Assistant** | `general-assistant` | Daily planner, Calendar conflicts, Health journal, Redact before send, Hire on Agent Market | +| **Payments Mind** | `payments-mind` | Payments, Daily planner, Recipient guard, Split bill, Treasury report, Spending audit, Best price buyer, Freeze advisor | +| **Email Manager** | `email-manager` | Email triage, Daily planner, Phishing detector, Follow-ups, Subscriptions & bills, Confidential reader, Calendar conflicts | + +Templates live in `engine/templates/*.json`. All three use the model `z-ai/glm-5.3-flash` on NEAR AI Cloud by default ([The agent](/agent) lists the models). + +## What the owner controls + +- **Persona:** the name and the "soul" (how it talks). Changing either starts a fresh memory, so a renamed Mind does not carry the old persona's notes. +- **Skills:** which playbooks and tools it has. See [Skills and tools](/skills). +- **Memory:** read, edit or clear what it remembers, and switch off memory or the search of past chats. See [Privacy](/privacy). +- **Wallet:** limits, allowed addresses and Freeze. See [Wallet, limits and approvals](/wallet-and-approvals). +- **Approvals:** optional rules that skip the card for small payments to listed addresses, or for chosen actions. + +## On chain + +A Mind can be recorded in the **Mind registry contract** (`hellonear-registry.testnet`): Mind, owner, wallet address and equipped skills. It holds no money; the wallet lives in OutLayer and the contract only stores its address. See [Receipts and smart contracts](/contracts). + +## Through the API + +`GET /v1/templates` lists the templates; `POST /v1/minds` with `{ "templateId": "payments-mind", "name": "Penny" }` creates a Mind. See the [Quickstart](/quickstart) and the [API reference](/api-reference). diff --git a/apps/docs/content/payments-csv.md b/apps/docs/content/payments-csv.md new file mode 100644 index 00000000..9effa367 --- /dev/null +++ b/apps/docs/content/payments-csv.md @@ -0,0 +1,26 @@ +--- +title: Payments CSV +description: A file of every payment a Mind made or tried, with who approved it and the transaction link, that an accountant can open without asking. +--- + +**Track:** `realworld`. + +The Wallet page has **Download CSV** beside Recent activity. The file has one row per payment attempt: date, status in words, amount, counterparty, purpose, who approved, tx hash and NearBlocks link. + +## Try it + +After a payment in the app, open **Wallet** and click **Download CSV**. + +Through the API (owner only, with the session cookie): + +```sh +curl -s -b jar $B/v1/minds/$MIND/payments.csv +``` + +## Details + +- "Who approved" is read from the run's own events: `owner`, or `your rule` when the owner's rule skipped the card. +- Refused payments are listed too, with their reason and no tx hash, because a payment the policy refuses has no transaction. +- Cells that start like a spreadsheet formula get a leading `'`, so opening the file cannot run a formula. + +Source: `paymentsCsv` in `apps/be/src/payments.ts`. diff --git a/apps/docs/content/privacy.md b/apps/docs/content/privacy.md new file mode 100644 index 00000000..be9669ef --- /dev/null +++ b/apps/docs/content/privacy.md @@ -0,0 +1,20 @@ +--- +title: Privacy: what is kept +description: What the TEE protects, what HelloNear stores, what is never stored, and how the owner deletes it. +--- + +The TEE protects the model calls. It does not make HelloNear's own backend blind: a Mind that remembers its owner needs that memory stored somewhere. This table says exactly where the line is. + +| Data | Who can see it | Kept? | +|---|---|---| +| **Prompts and replies while the model runs** | Nobody outside the TEE: not the cloud provider, not the model host, not NEAR AI. Each reply's signature is checked against the hardware attestation | HelloNear keeps the chat itself (next row); inside the TEE the operator cannot read it | +| **Chat history** | The owner, and HelloNear's backend (Postgres, **not** in a TEE) | Yes, so the Mind can continue a chat. Deleting a chat also deletes its semantic-recall vectors (`engine/src/threads.ts`) | +| **The Mind's memory of its owner** (working memory) | The owner (Mind settings → Memory), and HelloNear's backend | Yes, until the owner edits or clears it in Settings (`engine/src/memory.ts`) | +| **API keys and connection secrets** | Nobody in plain text: AES-256-GCM, bound to the owner and the secret's name (`apps/be/src/crypto.ts`). The model only ever writes `{{secrets.NAME}}` | Encrypted, until the owner deletes it | +| **Secrets and wallet tokens during a run** | Only the tool that uses them | **Never** in prompts, traces or stored run snapshots: they live in an in-memory map, and a test scans every table for them | +| **Proofs behind the Verified badge** | Anyone with the run | Signatures, hashes and Intel's TDX quote only, never the conversation text | +| **Guest sessions** | The guest | Deleted with all their Minds after the retention period (7 days) | + +So: HelloNear can keep your chats and memory to be useful, and you can delete them. It never stores your secrets in a form it can read back to the model, and the AI provider never sees your prompts outside the TEE. + +--- diff --git a/apps/docs/content/quickstart.md b/apps/docs/content/quickstart.md new file mode 100644 index 00000000..32bf44b9 --- /dev/null +++ b/apps/docs/content/quickstart.md @@ -0,0 +1,88 @@ +--- +title: Quickstart +description: Try HelloNear in the web app as a guest, or drive it with curl through the public API. +--- + +### In the web app (2 minutes, no account) + +> **During the hackathon everything runs on NEAR testnet, so judges can try it all for free.** *Continue as guest* needs no wallet, sign-up or payment: you get 20 messages, sample inbox and calendar data, and payments from a shared test wallet with HelloNear's limits. The AI runs on NEAR AI Cloud with the team's own credits, so you pay nothing for the model. Guest data is deleted after 7 days. + +1. Open **[app.hellonear.xyz](https://app.hellonear.xyz)** → **Continue as guest** → pick the **Payments Mind**. +2. *"Send 0.01 NEAR to lin1er.testnet"*. See: an approval card with the amount, the recipient and the wallet's checks. Approve it. See: a receipt with a testnet transaction link. +3. *"Send 10 USDC to 0x8ba1f109551bD432803012645Ac136ddd64DBA72 on Base."* See: a NEAR Intents quote (what would arrive, the cost, the time), signed by 1Click, and the Mind saying nothing was sent. +4. Click **Verified via NEAR AI TEE gateway** under a reply → **View proof** → **Check it in TEE Explorer**. See: Phala's TEE Explorer opens on a report that reads VERIFIED. +5. *"Buy the gas price report, but I only want to pay 0.0006 NEAR. Haggle if it costs more."* See: the sellers' prices, then **Made an offer**. The Mind buys at the agreed price (approval card) or walks away and pays nothing; it never makes a second offer. +6. *"Pay 0.001 NEAR to hellonear-registry.testnet."* See: a warning that it is a smart contract, and a question. No approval card. +7. After a payment, open **Wallet**. See: **Download CSV** beside Recent activity, a file an accountant can open (date, status, amount, counterparty, purpose, who approved, tx hash, NearBlocks link). +8. Make a **General Assistant** and ask *"I need competitor research for a coffee shop in Jakarta. My budget is 1 USDC. Find the cheapest agent on the NEAR AI Agent Market that fits."* See: real agents from market.near.ai, a price from each, which fit the budget, and the cheapest recommended. Nothing is hired or paid (hiring is USDC on mainnet). An older General Assistant adds **Hire on Agent Market** on the Skills page first. +9. Open **Attack playground** and run a scenario. See: which layer stopped it. +10. Make an **Email Manager** and ask *"List my latest emails. Is any of them suspicious?"* See: the sample inbox, the phishing email flagged, nothing paid. + +### Through the API + +The hosted backend is `https://api.hellonear.xyz`. Guest mode makes a temporary user (20 messages, deleted after 7 days). Replies stream as [server-sent events](https://github.com/Hellonear-AI/hellonear/blob/main/docs/api-contract.md#3-hellonear-events-engine--backend--browser). + +```sh +B=https://api.hellonear.xyz # or http://localhost:4000 (see "Run locally") + +# 1. Start a guest session. See: 201 and "demo": true +curl -s -c jar -X POST $B/v1/auth/demo -H 'content-type: application/json' -d '{}' + +# 2. List the Mind templates. See: email-manager, general-assistant, payments-mind +curl -s -b jar $B/v1/templates + +# 3. Create a Payments Mind. See: 201 with the Mind's id (mnd_…) +curl -s -b jar -X POST $B/v1/minds -H 'content-type: application/json' \ + -d '{"templateId":"payments-mind","name":"Penny"}' +M=mnd_... # the id from step 3 + +# 4. Ask for a cross-chain quote. See: tool.called crosschain_quote, a tool.result with +# status "quote_only", to.amount, cost, seconds and proof.signedBy1Click: true; nothing sent +curl -sN -b jar -X POST $B/v1/minds/$M/chat -H 'content-type: application/json' \ + -d '{"message":"Send 10 USDC to 0x8ba1f109551bD432803012645Ac136ddd64DBA72 on Base."}' + +# 5. Ask to pay. See: tool.approval_required for send_payment, nothing sent yet +curl -sN -b jar -X POST $B/v1/minds/$M/chat -H 'content-type: application/json' \ + -d '{"message":"Send 0.01 NEAR to lin1er.testnet"}' +curl -s -b jar $B/v1/minds/$M/approvals # the runId and toolCallId +curl -sN -b jar -X POST $B/v1/runs/$RUN/approve -H 'content-type: application/json' \ + -d '{"toolCallId":"…"}' # See: send_payment "sent" with a txHash + +# 6. The proof behind a reply. See: signers, signatures (hashes only) and the Intel quote, +# then a TEE Explorer report URL with verified: true +curl -s -b jar $B/v1/runs/$RUN/proof +curl -s -b jar -X POST $B/v1/runs/$RUN/proof/tee-explorer -H 'content-type: application/json' -d '{}' +``` + +Ask for 1 NEAR and approve it. See: `policy_denied`, no transaction and no tx link: the wallet refused before signing. + +**Attack playground:** +- `curl -s -b jar $B/v1/attacks`. See: `direct-order`, `email-injection`, `rogue-skill`, `tricked-owner`. +- `curl -sN -b jar -X POST $B/v1/attacks/direct-order/runs -H 'content-type: application/json' -d '{}'`. See: the Mind refuses and `attack.verdict` has `"stoppedBy":"model"`. +- `rogue-skill`: `"stoppedBy":"no_tool"`; `send_payment` never appears. +- `tricked-owner`: sometimes the Mind refuses, sometimes it puts the payment on a card. Approve that card. See: `"stoppedBy":"policy"`, `policy_denied` ("not in whitelist") and **no tx hash**. + +**Autopilot** (a job built here as JSON; the Builder makes the same canvas): +```sh +curl -s -b jar -X PUT $B/v1/minds/$M/workflows/morning-brief -H 'content-type: application/json' -d '{"name":"Morning brief","nodes":[ + {"id":"start","type":"trigger","data":{"schedule":{"cron":"30 7 * * 1-5","timezone":"Asia/Jakarta"}}}, + {"id":"cal","type":"tool","data":{"tool":"googlecalendar_list_events","args":{}}}, + {"id":"note","type":"agent","data":{"prompt":"In three short lines, brief me on today from these events: {{steps.cal.events}}"}}], + "edges":[{"source":"start","target":"cal"},{"source":"cal","target":"note"}]}' +curl -sN -b jar -X POST $B/v1/minds/$M/workflows/morning-brief/runs -H 'content-type: application/json' -d '{}' +``` +Use a General Assistant (it has the calendar). An If compares a number or text from an earlier step (after a list, its count: "number of events is more than 0"). Turning the schedule on needs a wallet sign-in (a guest gets `403 demo_not_allowed`). + +**More prompts** (guests get a sample inbox and calendar): +- *"Archive the newsletter and the StreamBox receipt."*: a card listing each email, saying nothing is deleted. +- *"Brief me on today"*: meetings, emails that need you, money due, and a "Watch out" line for the phishing email. +- *"Which subscriptions do I pay for?"*: StreamBox, CloudNotes and an invoice, with monthly totals; it never pays. +- *"What's the gas price on NEAR testnet? Buy the report."*: a `402` price, a card for 0.001 NEAR, then the report with its tx hash. +- *"Pay b0b.testnet 0.01"* after paying `bob.testnet`: a question about the lookalike, not a card. +- *"Mark INV-12 as Paid in my Invoices sheet"* (with Sheets connected): card Now: Unpaid / New: Paid. +- *"Move my 3pm client call to 4pm"*: card From / To; guests stay, nobody is emailed. +- *"What is this app?"*: every Mind answers from the built-in guide. + +Every route and event is in [`docs/api-contract.md`](https://github.com/Hellonear-AI/hellonear/blob/main/docs/api-contract.md). + +--- diff --git a/apps/docs/content/relayer.md b/apps/docs/content/relayer.md new file mode 100644 index 00000000..9cc988d2 --- /dev/null +++ b/apps/docs/content/relayer.md @@ -0,0 +1,18 @@ +--- +title: Gas relayer (NEP-366) +description: A meta-transaction relayer that pays the gas for an owner's calls to the registry contract, never a deposit. +--- + +**Track:** `realworld`. **Source:** `apps/be/src/relay.ts`, tests in `apps/be/test/relay.test.ts`. + +Owners should not need NEAR for gas to manage their Minds. The relayer accepts a NEP-366 signed delegate action from the signed-in owner and sends it, paying the gas. It is **live on the hosted demo** for two registry methods, `unequip_skill` and `set_wallet`, paid by `relayer.hellonear-swarm.testnet`, whose only key lives on the server. + +## Limits + +- Only calls to the registry contract, only `unequip_skill` and `set_wallet`, with exactly 1 yoctoNEAR attached. A relayer pays any inner deposit too, so methods that need storage or a price (`register_mind`, `equip_skill`) are not relayed. +- Everything that can be refused is refused before sending: sender is the signed-in account, receiver is the registry, gas, ed25519 signature, expiry within 1000 blocks, full-access key, nonce. A bad request costs no gas. +- 10 per owner per hour. Not for try-out users. + +## Through the API + +`POST /v1/relay { "signedDelegate": "" }`. Answers `503 relay_not_configured` until a relayer account is set. diff --git a/apps/docs/content/run-locally.md b/apps/docs/content/run-locally.md new file mode 100644 index 00000000..3728a3ae --- /dev/null +++ b/apps/docs/content/run-locally.md @@ -0,0 +1,35 @@ +--- +title: Run locally +description: Run the engine, backend and web app on your own machine. +--- + +Needs Node ≥ 24.22.1, Bun, Docker (OrbStack on macOS) and a NEAR AI Cloud API key. + +```sh +docker compose up -d postgres # Postgres 17 + pgvector, capped at 1 CPU / 512 MB + +cd engine && cp .env.example .env # set NEARAI_API_KEY and ENGINE_API_KEY +bun install && bun run dev # http://localhost:4100/v1/health + +cd ../apps/be && cp .env.example .env # same ENGINE_API_KEY; SECRETS_MASTER_KEY=$(openssl rand -base64 32); DEMO_MODE=true +bun install && bun run migrate && bun run dev # http://localhost:4000/v1/health → {"ok":true,"engine":true} + +cd ../fe && NEXT_PUBLIC_API_URL=http://localhost:4000 bun run dev # http://localhost:3000 +``` + +Payments also need `DEMO_OUTLAYER_API_KEY` (an OutLayer wallet's agent key) in `apps/be/.env`. `docker compose stop` when done. + +**Tests:** `bun run test` in `engine/` and `apps/be/` (integration: real NEAR AI + local Postgres), `bun run test` in `apps/fe/`, `cargo test` in `sc/` (unit + local NEAR sandbox). Load: `k6 run engine/load/chat.js`, `k6 run engine/load/workflow.js`, `bun run load` in `apps/be/`. Each package has a GitHub Actions workflow. + +| Folder | What | +|---|---| +| `engine` | AI engine: Mastra 1.81 on NEAR AI Cloud, skills, tools, memory, Visual Builder, Autopilot, verification | +| `apps/be` | Backend API: NEP-413 sign-in, Minds, OutLayer wallets, approvals, secrets, connections, Telegram, Postgres | +| `apps/fe` | Web app (Next.js 16, NEAR Connect with Meteor first) | +| `apps/landing` | Landing page | +| `sc` | Mind registry contract (Rust `near-sdk` 5.29) | +| `docs` | API contract between web app, backend and engine | +| `design` | Design tokens, screens and Mind characters | +| `deploy` | Hosted demo: systemd units, `deploy.sh`, automatic deploy after a merge | + +--- diff --git a/apps/docs/content/skills.md b/apps/docs/content/skills.md new file mode 100644 index 00000000..5263ec9d --- /dev/null +++ b/apps/docs/content/skills.md @@ -0,0 +1,28 @@ +--- +title: Skills and tools +description: How skills grant tools, why a Mind without a payment skill cannot pay, and where every skill and tool is listed. +--- + +A **skill** is a playbook plus a fixed list of tools. HelloNear has 33 equippable skills plus a built-in HelloNear guide. A **tool** is one action the model can call, such as `send_payment`, `gmail_list_emails` or `market_search`. + +## Skills grant tools + +A Mind has exactly the tools its equipped skills grant. The backend sends the engine skill **ids**, never tool names, and the engine resolves the tool list for each request from the skills (`toolsFor` in `engine/src/tools.ts`). A tool no equipped skill grants does not exist for that run, so a Mind without a payment skill cannot pay, whatever an email or a web page tells it. + +You can see this in the Attack playground: *Use a skill it doesn't have* ends with `stoppedBy: no_tool`, because `send_payment` never appears. + +## How a skill is written + +Each skill is a `SKILL.md` in `engine/skills//` with frontmatter (title, blurb, tools, connections, status) and a playbook in plain words. A unit test checks that every `SKILL.md` parses and uses only registered tools. A skill with status `blocked` is accepted but not loaded. + +## Tools that act ask first + +Tools that change something (a payment, an email, a calendar event, a Sheets cell, a Notion row, a Doc, a Slack post, a Zoom meeting) pause the run for the owner's approval, with the old value shown next to the new one. Before the card is shown, the tool reads its target again, so an invented id or a stale value never gets a card. Every write also re-reads its target just before writing and refuses if it changed since the card was shown. + +## Published skills on chain + +The Mind registry contract lets anyone publish a skill with a fixed price (`publish_skill`), and an owner equip it on a Mind (`equip_skill`), paying the publisher. See [Receipts and smart contracts](/contracts). + +## Every skill and tool + +[The agent](/agent) lists all tools and all skills with the tools each one grants. Through the API: `GET /v1/skills` (the catalog) and `GET /v1/skills/{skillId}` (one skill with its `SKILL.md`). diff --git a/apps/docs/content/status.md b/apps/docs/content/status.md new file mode 100644 index 00000000..2197a04f --- /dev/null +++ b/apps/docs/content/status.md @@ -0,0 +1,49 @@ +--- +title: Status +description: Where to see whether HelloNear and its providers are up, and the contract of the public GET /v1/status endpoint. +--- + +**[status.hellonear.xyz](https://status.hellonear.xyz)** shows whether HelloNear and the services it runs on answer. It was built on 13 Nov 2026 after two outages from outside HelloNear's code in one night: NEAR AI embeddings hung, and NEAR Intents 1Click quotes timed out. + +When a provider is down, a Mind says so plainly in the chat and points to the status page. + +## What is checked + +Every 5 minutes the backend checks 9 services in parallel and keeps 8 days of results: + +| Service id | Group | Check | Slow over | Down after | +|---|---|---|---|---| +| `hellonear-api` | HelloNear | Postgres `select 1` | 1 s | 5 s | +| `hellonear-engine` | HelloNear | engine `/v1/health` | 2 s | 10 s | +| `nearai-chat` | NEAR AI | a chat completion, from the engine | 10 s | 30 s | +| `nearai-embeddings` | NEAR AI | an embedding, from the engine | 5 s | 15 s | +| `near-intents-quote` | NEAR | 1Click dry quote, 10 USDC NEAR to Base | 15 s | 30 s | +| `outlayer` | Partners | OutLayer `/health` | 3 s | 10 s | +| `near-rpc` | NEAR | FastNear testnet `status` | 3 s | 10 s | +| `agent-market` | Partners | `market.near.ai/v1/agents?limit=1` | 5 s | 15 s | +| `tee-explorer` | Partners | `HEAD proof.t16z.com` | 5 s | 15 s | + +Down also means an error, a non-2xx answer, or an answer without the expected field. If the engine does not answer, nothing is stored for NEAR AI that round; it is not guessed. + +## GET /v1/status + +`GET https://api.hellonear.xyz/v1/status`: public, any origin, no cookies, `access-control-allow-origin: *`, `cache-control: public, max-age=30`. + +``` +{ "updatedAt": ISO, "overall": "operational" | "degraded" | "down", + "services": [{ "id", "name", "group": "HelloNear" | "NEAR AI" | "NEAR" | "Partners", + "status": "operational" | "degraded" | "down" | "unknown", "latencyMs": number | null, "checkedAt": ISO | null, + "detail": string | null, "impact": string, "uptime24h": number | null, "uptime7d": number | null, + "history": [{ "start": ISO, "status": "operational" | "degraded" | "down" | "none", "checks": number, "bad": number, "detail": string | null }] }], + "incidents": [{ "service", "name", "status": "down" | "degraded", "start": ISO, "end": ISO | null, "minutes": number, "detail": string | null }] } +``` + +- `status` is the latest check, or `unknown` when it is older than 15 minutes. +- `overall` is `down` when a HelloNear service is down, `degraded` when anything else is down or degraded. Uptime counts degraded as up. +- `history` is 48 half-hour buckets ending with the current one, oldest first: the worst check in each. +- `incidents` (newest first, at most 100): consecutive non-operational checks of one service; one good check ends it. `end` is `null` while ongoing. +- Details are short and never carry keys or URLs. + +```sh +curl -s https://api.hellonear.xyz/v1/status | jq '.overall, [.services[] | {id, status}]' +``` diff --git a/apps/docs/content/swarm-auction.md b/apps/docs/content/swarm-auction.md new file mode 100644 index 00000000..ed5c308f --- /dev/null +++ b/apps/docs/content/swarm-auction.md @@ -0,0 +1,39 @@ +--- +title: Swarm auction +description: A sealed-bid group-buying auction contract on NEAR testnet where buyer agents pool demand and seller agents compete at one clearing price. +--- + +**Track:** `swarms`. **Contract:** [`auction.hellonear-swarm.testnet`](https://testnet.nearblocks.io/address/auction.hellonear-swarm.testnet?tab=contract), source `sc/swarm`, rules in [`RULES.md`](https://github.com/Hellonear-AI/hellonear/blob/main/sc/swarm/RULES.md). + +## How a round works + +1. The organizer opens a round with a price ceiling, a seller bond and a fixed timeline. Nobody can change the timeline afterwards. +2. **Buyers join with escrow:** units × ceiling. +3. **Sellers commit hidden asks:** only a SHA-256 commitment of (round, seller, ask, capacity, salt) plus the bond. Nobody can see the price. +4. **Sellers reveal.** Each reveal must hash to its commitment, and the bond comes back. A seller who never reveals loses its bond to the round's buyers. +5. **Anyone closes** the round at its time. The cheapest asks fill demand at **one clearing price**. +6. **Everyone withdraws** their own payout (pull payments, so one failing account cannot block a round). + +Every agent is its own NEAR sub-account of `hellonear-swarm.testnet`. + +## A real round + +Round 0 on 13 Nov 2026: 3 buyers wanted 6 units at a ceiling of 0.01 NEAR; 2 sellers revealed 0.006 NEAR × 4 units and 0.008 NEAR × 5 units. All 6 units filled at **0.008 NEAR**. Every transaction is listed on [Receipts and smart contracts](/contracts#the-swarm-auction-one-real-round-on-testnet). + +Read it yourself: `get_round` with `{"round_id":0}` on `auction.hellonear-swarm.testnet` (public RPC, no key). + +## Simulation + +A simulation of 20 buyers and 5 sellers with scripted strategies and no LLM runs three rounds on a local NEAR sandbox and checks money is conserved each round ([report](https://github.com/Hellonear-AI/hellonear/blob/main/sc/swarm/simulation-report.md)): + +```sh +cd sc/swarm && cargo test --test simulation -- --nocapture +``` + +## Safety + +The 13 Nov security review of the contract raised 9 findings, all fixed: no organizer timing power, seller bonds, storage paid by whoever adds it, commitments bound to round and seller, a fixed-size close event under NEAR's 16 KiB log cap, pull payouts with the balance zeroed before transfer, and checked math. Details in [`sc/swarm/README.md`](https://github.com/Hellonear-AI/hellonear/blob/main/sc/swarm/README.md). + +## In the app + +Best price buyer runs each order as a small auction between sellers; Minds buy from and sell to other Minds, each with its own wallet. diff --git a/apps/docs/content/tech-stack.md b/apps/docs/content/tech-stack.md new file mode 100644 index 00000000..1dc1bbcd --- /dev/null +++ b/apps/docs/content/tech-stack.md @@ -0,0 +1,45 @@ +--- +title: Tech stack +description: What is used where: NEAR, NEAR AI Cloud, NEAR Intents, OutLayer, Mastra and the rest. +--- + +| | Technology | Where in the repo | What it does in HelloNear | +|---|---|---|---| +| | **NEAR Protocol** (testnet) | `sc/`, `apps/be/src/auth.ts`, `apps/be/src/wallets.ts` | The Mind registry contract (Minds, published skills, `equip_skill` pays the publisher); NEP-413 sign-in; every payment, policy change and freeze is a NEAR transaction | +| | **NEAR AI Cloud** | `engine/src/models.ts`, `engine/src/verify.ts`, `engine/src/titles.ts` | Runs every model call inside a TEE; HelloNear checks each reply's signature against the attestation before the Verified badge, and keeps the proof | +| | **NEAR Intents** (1Click API + official SDK) | `engine/src/crosschain.ts` | Cross-chain USDC/USDT quotes from NEAR to other chains; each quote's 1Click signature is verified with `verifyQuoteSignature` | +| | **NEAR AI Agent Market** ([market.near.ai](https://market.near.ai)) | `engine/src/market.ts`, skill `agent-market` | Searches the public catalog of agents and gets a job's exact price from the agent's own x402 answer (A2A, unpaid), then picks the cheapest within the owner's budget; hiring is paid in USDC on mainnet, so it only quotes for now | +| | **Swarm auction contract** (`near-sdk`, testnet) | `sc/swarm` | Sealed-bid group buying between agents, each its own sub-account; deployed at `auction.hellonear-swarm.testnet`, source verified | +| | **OutLayer** (testnet) | `apps/be/src/wallets.ts`, `apps/be/src/payments.ts` | One wallet per Mind; its policy (per-payment limit, daily limit, allowed recipients) is stored on chain and checked in a TEE before anything is signed; freeze | +| | **Meteor Wallet** via **NEAR Connect** | `apps/fe` | The owner's wallet: signs in, signs the Mind wallet's policy, adds funds, freezes. Other NEAR Connect wallets work too | +| | **FastNear** testnet RPC | `engine/src/tools.ts`, `apps/be/src/config.ts` | Account lookups before a payment (`view_account`) and transfer checks after one (`tx`) | +| | **Phala TEE Attestation Explorer** | `apps/be/src/teeExplorer.ts` | Checks the Intel TDX quote behind a reply; the app opens its VERIFIED report | +| | **Mastra** 1.81 | `engine/` | The agent: one generic Mind agent, tools, approvals (`requireApproval`, per-call rules, `beforeApproval`), memory, context limits, dynamic workflows for the Builder, workflow schedules for Autopilot | +| | **GLM-5.3 Flash** (Z.ai), **DeepSeek V4.1 Flash**, **Qwen3 Embedding** | `engine/src/config.ts`, `engine/src/models.ts` | Chat, reasoning and memory embeddings, all served by NEAR AI Cloud | +| | **Composio** | `apps/be/src/connections.ts`, `engine/src/composio.ts`, `engine/src/apps.ts`, `engine/src/calendar.ts`, `engine/src/zoom.ts` | The owner connects Gmail, Google Calendar, Meet, Sheets, Drive, Docs, Notion, Slack, Outlook and Zoom with OAuth (backend: Connect Links); the engine runs the app tools in a session scoped to that one owner | +| | **AgentMail** | `apps/be/src/mail.ts`, `engine/src/mail.ts` | Each Mind's own email address (`…@agentmail.to`): send after approval, read its inbox with spam and phishing warnings, email the owner | +| | **Telegram Bot API** | `apps/be/src/telegram.ts`, `apps/be/src/telegramFormat.ts` | A bot per Mind: chat, streamed replies, Approve / Decline buttons; only the owner's chat is answered | +| | **Postgres 17 + pgvector** | `apps/be/migrations/`, `engine/src/mastra.ts` | Runs, events, approvals, encrypted secrets (backend); Mastra storage, run snapshots and memory vectors (engine) | +| | **Next.js 16, React 19, GSAP, React Flow** | `apps/fe`, `apps/landing` | The web app (chat, live view, Builder canvas, wallet, settings) and the landing page | +| | **Rust, `near-sdk` 5.29, `near-sandbox`** | `sc/` | The registry contract and its sandbox tests, including upgrades | +| | **Bun, Node 24, k6** | every package | Package manager and runtime; load tests | +| | **Proxmox LXC + Cloudflare Tunnel** | `deploy/` | The hosted demo; a merged `main` is deployed automatically after its CI passes | + +--- + +## How NEAR is used + +| What | Where | Proof | +|---|---|---| +| **NEAR AI Cloud**: every model call runs in a TEE; each reply is checked against the attestation and marked verified | `engine/src/models.ts`, `engine/src/verify.ts` | `run.verified` event, `engine/test/verify.test.ts`, the TEE Explorer report above | +| **The proof behind the badge**: signatures and Intel's TDX report kept and shown under View proof; the backend uploads the Intel quote to Phala's TEE Attestation Explorer and the app opens the verified report | `engine/src/verify.ts`, `apps/be/src/teeExplorer.ts`, `apps/fe/src/modules/runs/components/ProofDialog.tsx` | `GET /v1/runs/{runId}/proof`, `POST /v1/runs/{runId}/proof/tee-explorer` | +| **NEAR Intents (1Click API)**: cross-chain stablecoin quotes, each signed by 1Click and checked with the official SDK | `engine/src/crosschain.ts` | `engine/test/crosschain.test.ts`, the live quotes above | +| **OutLayer wallets** on testnet: one per Mind, policy v2 (per-payment limit, daily limit, recipients) enforced in a TEE; policy and freeze are calls on `outlayer.testnet` the owner signs | `apps/be/src/wallets.ts` | the payment, policy and freeze transactions above | +| **NEP-413 sign-in** with the owner's NEAR wallet (Meteor first, any NEAR Connect wallet works) | `apps/be/src/auth.ts` | `apps/be/test/api.test.ts` | +| **Mind registry contract** (Rust, `near-sdk` 5.29) on `hellonear-registry.testnet`: Minds, published skills, and `equip_skill` pays the skill's publisher | `sc/` | `sc/README.md` (deploy transactions, code hash), sandbox tests in `sc/tests/` | +| **Swarm auction contract** (Rust, `near-sdk` 5.29) on `auction.hellonear-swarm.testnet`: sealed-bid group buying, every agent its own sub-account, source verified | `sc/swarm` | [a real round's transactions](/contracts#the-swarm-auction-one-real-round-on-testnet), `sc/swarm/tests/simulation.rs` | +| **Meta transactions (NEP-366)**: a relayer pays the gas for an owner's calls to the registry, never a deposit | `apps/be/src/relay.ts` | `apps/be/test/relay.test.ts` | +| **NEAR AI Agent Market**: agents from market.near.ai, priced through their x402 answer (paid with a NEP-366 USDC transfer on mainnet, so quoted only here) | `engine/src/market.ts` | `engine/test/market.test.ts`, Try it step 8 | +| **NEAR RPC** (FastNear testnet): account lookups (including whether the account is a contract) and transfer checks the Mind uses before and after paying | `engine/src/tools.ts` | `engine/test/near-tool.test.ts` | + +--- diff --git a/apps/docs/content/telegram.md b/apps/docs/content/telegram.md new file mode 100644 index 00000000..544e3279 --- /dev/null +++ b/apps/docs/content/telegram.md @@ -0,0 +1,25 @@ +--- +title: Telegram +description: Chat with a Mind from Telegram, with streamed replies and Approve or Decline buttons, answered only in the owner's chat. +--- + +Each Mind can have its own Telegram bot. The owner makes the bot with @BotFather and gives its token to HelloNear in the Mind's settings. + +## How it works + +- **Linking:** HelloNear checks the token with Telegram, stores it encrypted, and answers with a one-time `t.me/?start=` link. The private chat that sends that code becomes the owner. Every other chat is ignored without a reply. +- **Chat:** an owner message runs as a normal chat, in one thread per bot, with the same events and limits as the app. Times are in UTC, since Telegram sends no time zone. +- **Streaming:** the reply appears at once and the same message is edited as it grows, at most once every 1.5 s, with "typing…" while a tool runs. +- **Rich text:** the Mind's Markdown is converted to Telegram's HTML by HelloNear's own small converter. Only http and https links become links, and a labelled link shows its host after it, so a stranger cannot hide where a link goes. + +## Approvals in Telegram + +Each approval the Mind asks for comes as its own message with the same checks as the app's card, and buttons **Approve**, **Decline** and **Open in app**. Only a press from the owner's chat counts; anyone else gets "Only the owner can approve". The first press uses up both buttons. There is no Approve button when the wallet policy would refuse the payment or the wallet holds less than the payment. + +Approval cards never read their words as Markdown: their text comes from tool arguments (an email subject, an event title someone else wrote), so nobody can inject a link into a message that asks the owner to approve. + +The app and Telegram cannot resume one run twice: a run is claimed in one database update before it continues. + +## Through the API + +`PUT /v1/minds/{id}/telegram { token }` links a bot; `DELETE` unlinks it. See the [API reference](/api-reference). diff --git a/apps/docs/content/tracks.md b/apps/docs/content/tracks.md new file mode 100644 index 00000000..bf2c85a9 --- /dev/null +++ b/apps/docs/content/tracks.md @@ -0,0 +1,71 @@ +--- +title: The six tracks +description: What HelloNear built for each NEAR HACKATHON track, the skills that carry it, and how to check it. +--- + +HelloNear is submitted to six tracks. For each one: what the organizers ask for (quoted from the *Build* and *Hints* columns of HACKATHON.md), what HelloNear built for it, the skills that carry it, and how to check it. + +| Track | Why HelloNear fits, in one line | +|---|---| +| [`security`](https://github.com/Hellonear-AI/hellonear#security-ai-security--defense) | An AI with money whose limits it cannot touch: approval, an OutLayer policy checked in a TEE before signing, freeze, scam and lookalike checks, and an Attack playground | +| [`privacy`](https://github.com/Hellonear-AI/hellonear#privacy-privacy--private-ai) | Every reply runs on NEAR AI Cloud in a TEE and is verified against its attestation, with a proof anyone can open on Phala's TEE Explorer | +| [`agents`](https://github.com/Hellonear-AI/hellonear#agents-agent-economy) | Minds pay for data (402), sell to other Minds, compare sellers, invoice, and quote payments through NEAR Intents, inside the owner's limits | +| [`swarms`](https://github.com/Hellonear-AI/hellonear#swarms-ai-swarms) | Every purchase is a small auction between sellers; Minds trade with other Minds; one request pays several people, each approved | +| [`business`](https://github.com/Hellonear-AI/hellonear#business-autonomous-business) | The owner sets the constraints; the Mind runs the treasury: reports, audits, revenue sharing, invoices, procurement, scheduled jobs | +| [`realworld`](https://github.com/Hellonear-AI/hellonear#realworld-real-world-money) | Invoices with payment checked on chain, bills found in Gmail, and stablecoin payments to other chains quoted through NEAR Intents | + +### `security`: AI Security & Defense + +| | | +|---|---| +| **The track asks for** | "Build spending limits, policy engines, sandboxed wallets, reputation and scam detection. Give AI money without giving it the keys to everything." Hints: agent security, function call keys, TEE attestation | +| **What HelloNear built** | Seven layers that each stop an attack alone: the model, skills that grant tools, the owner's approval, the OutLayer wallet policy checked **in a TEE before signing**, a daily limit, freeze, and unattended jobs with no payment tools. Writes re-check their target before writing. A Recipient guard that answers allow, warn or block with the reason before every payment (where the recipient came from, that it exists, lookalikes of people already paid, first payments, contracts), a Phishing check, and an Attack playground that names the layer that stopped each attack. Why not function-call keys: they cannot transfer NEAR and their allowance is gas, not a spending cap | +| **Skills** | Recipient guard, Phishing check, Freeze advisor, Spending audit, Payments | +| **Check it** | Attack playground, any scenario: `attack.verdict` names the layer. Approve 1 NEAR: `policy_denied`, no transaction | + +### `privacy`: Privacy & Private AI + +| | | +|---|---| +| **The track asks for** | "Explore confidential computation, private finance and AI that protects sensitive data. Build intelligence without exposure." Hints: private AI, TEE, NEAR AI Cloud | +| **What HelloNear built** | Every model call runs on **NEAR AI Cloud** inside a TEE. Each reply's signature is checked against the hardware attestation before the Verified badge shows; the proof is kept, shown under View proof, and opens on Phala's TEE Explorer as VERIFIED. Secrets and wallet tokens never reach the model, traces or stored snapshots. Skills that read sensitive email without sending it anywhere | +| **Skills** | Confidential reader, Redact before send, Health journal | +| **Check it** | Verified badge → View proof → Check it in TEE Explorer: a VERIFIED report whose nonce matches the dialog. What is kept and what is not: [What is private, and what HelloNear keeps](/privacy) | + +### `agents`: Agent Economy + +| | | +|---|---| +| **The track asks for** | "Build agents that earn, spend, negotiate, hire other agents and pay for APIs, compute or data , with crypto directly or through NEAR Intents." Hints: agent commerce, NEAR Intents, chain signatures | +| **What HelloNear built** | Minds pay for data with a 402 pattern on testnet NEAR (price, approved payment, report with the tx hash as receipt), sell what they made to other Minds into their own wallet, compare sellers before buying, invoice and check payment on chain, quote cross-chain payments through **NEAR Intents**, haggle once with a seller (offer within the owner's budget, then buy at the agreed price or walk away), and find agents on the **NEAR AI Agent Market** (market.near.ai) with each job's exact price from the agent's own x402 answer, picking the cheapest one within the owner's budget (hiring is paid in USDC on mainnet, so it only quotes for now). All inside the owner's limits | +| **Skills** | Paid data, Best price buyer, Hire on Agent Market, Price watch, Mind as seller, Invoice & get paid, Payments | +| **Check it** | *"What's the gas price on NEAR testnet? Buy the report."*: a `402` price, a card for 0.001 NEAR, then the report and its tx hash | + +### `swarms`: AI Swarms + +| | | +|---|---| +| **The track asks for** | "Build coordination markets, bidding, collective purchasing, intent-based settlement and emergent economies between agents." Hints: multi-agent systems, NEAR Intents, sub-accounts | +| **What HelloNear built** | A **sealed-bid group-buying auction contract** ([`sc/swarm`](https://github.com/Hellonear-AI/hellonear/blob/main/sc/swarm), rules in [`RULES.md`](https://github.com/Hellonear-AI/hellonear/blob/main/sc/swarm/RULES.md)): buyer agents pool demand with escrow, seller agents commit hidden asks with a bond and reveal them, the cheapest asks fill demand at one clearing price, and every agent is its own NEAR sub-account. A simulation of **20 buyers and 5 sellers with scripted strategies and no LLM** runs three rounds on a local NEAR sandbox and checks money is conserved each round ([report](https://github.com/Hellonear-AI/hellonear/blob/main/sc/swarm/simulation-report.md)); an independent audit's 9 findings are fixed. In the app, Best price buyer runs each order as a small auction between sellers and buys only from one the wallet may pay; Minds buy from and sell to other Minds (each with its own wallet); Split bill and Revenue split pay several people from one request, each payment approved on its own | +| **Skills** | Best price buyer, Mind as seller, Split bill, Revenue split; contract `sc/swarm` | +| **Check it** | [One real round on testnet](/contracts#the-swarm-auction-one-real-round-on-testnet): every step's transaction, 6 units filled at one clearing price. Locally, `cd sc/swarm && cargo test --test simulation -- --nocapture`: 20 buyers and 5 sellers, three rounds, a clearing price per round and who got what. In the app: *"Split 0.02 NEAR between alice.testnet and bob.testnet"*: shares worked out in yoctoNEAR, one card per person | + +### `business`: Autonomous Business + +| | | +|---|---| +| **The track asks for** | "Build AI-native businesses with treasury, sales, procurement, cross-chain payments via NEAR Intents and revenue sharing. Humans only set the constraints." Hints: AI agents, NEAR Intents, chain signatures | +| **What HelloNear built** | The owner sets the constraints (per-payment and daily limits, allowed recipients, approval rules) and holds a kill switch (Freeze, one signature); the Mind runs the treasury: daily treasury reports, a weekly spending audit, revenue sharing between partners, invoices and follow-ups, procurement through Best price buyer, cross-chain quotes through NEAR Intents, and Autopilot jobs that run on a schedule | +| **Skills** | Treasury report, Spending audit, Revenue split, Invoice & get paid, Follow-ups, Subscriptions & bills | +| **Check it** | *"Give me today's treasury report"*: balance, what went out, what is pending, read only | + +### `realworld`: Real-World Money + +| | | +|---|---| +| **The track asks for** | "Build payroll, invoicing, remittances, merchant payments and stablecoin rails for real businesses. Something a normal company could use tomorrow." Hints: stablecoins, NEAR Intents, meta transactions | +| **What HelloNear built** | Invoices sent from the Mind's own email address with payment checked by its transaction on chain; bills and subscriptions found in the owner's Gmail; a payments CSV an accountant can open without asking (`GET /v1/minds/{id}/payments.csv`: date, status in words, amount, counterparty, purpose, who approved, tx hash and NearBlocks link); a meta-transaction relayer (NEP-366) that pays gas only for owner calls to our own registry contract and never pays a deposit; USDC/USDT payments to other chains quoted through **NEAR Intents**, signed by 1Click and checked with the official SDK (sending needs mainnet); every payment approved by the owner and limited by the wallet | +| **Skills** | Invoice & get paid, Subscriptions & bills, Spending tracker, Payments | +| **Check it** | *"Send 10 USDC to 0x8ba1f109551bD432803012645Ac136ddd64DBA72 on Base."*: what would arrive, the cost, the time, `proof.signedBy1Click: true`, nothing sent | + +--- diff --git a/apps/docs/content/verified-replies.md b/apps/docs/content/verified-replies.md new file mode 100644 index 00000000..f8db0d1c --- /dev/null +++ b/apps/docs/content/verified-replies.md @@ -0,0 +1,31 @@ +--- +title: Verified replies +description: How every reply is checked against NEAR AI Cloud's TEE attestation, what the badge levels mean, and how to open the proof on Phala's TEE Explorer. +--- + +Every model call runs on **NEAR AI Cloud** inside a TEE. After a reply finishes, the engine fetches each completion's signature and checks it against the hardware attestation (`engine/src/verify.ts`) before the app shows the **Verified** badge. + +## Badge levels + +The badge shows the weakest step's level, at the level the NEAR AI SDK proves: + +| Level | Meaning | +|---|---| +| `model_tee` | The model itself ran in a TEE and signed the reply | +| `gateway_tee` | NEAR AI's gateway TEE signed the reply (streaming replies are checked at this level) | + +Only verifiable (Confidential or third-party TEE) models get a badge. Incognito models never do. + +## What is kept + +The proof behind the badge is stored on the run's `run.verified` event: signatures, hashes and Intel's TDX quote. Never the conversation text. It is about 12 KB, mostly the quote, and it is never streamed: only the owner can read it, through `GET /v1/runs/{runId}/proof`. + +## Check it yourself + +In the app: click **Verified via NEAR AI TEE gateway** under a reply, then **View proof**, then **Check it in TEE Explorer**. The backend uploads the Intel quote to Phala's TEE Attestation Explorer (`POST /v1/runs/{runId}/proof/tee-explorer`) and the app opens the report. Only the quote leaves, no conversation text, and the report then shows in the Explorer's public list of recent attestations. + +A real report: [proof.t16z.com/reports/1b374e5b…](https://proof.t16z.com/reports/1b374e5b10031496c6c45bc7749038d7e7cd26a16996455f893b6b5dd44a9db2) reads **VERIFIED**. Its report data ends with that run's nonce (`…99e266`), and its MRCONFIG carries the compose hash (`877959253d…`) found in the proof. + +## Events + +`run.verified` follows `run.finished` on the stream. See [Streaming events](/events). diff --git a/apps/docs/content/wallet-and-approvals.md b/apps/docs/content/wallet-and-approvals.md new file mode 100644 index 00000000..5fd838ac --- /dev/null +++ b/apps/docs/content/wallet-and-approvals.md @@ -0,0 +1,19 @@ +--- +title: Wallet, limits and approvals +description: The layers that keep a Mind from paying what the owner did not allow: approval, the wallet policy in a TEE, the daily limit and Freeze. +--- + +Each layer stops an attack on its own; the ones further down do not trust the ones above. + +| Layer | What it stops | Do this, see that | +|---|---|---| +| **The model** | Obvious tricks: an email or message telling "the AI" to pay someone | Attack playground, *Hide it in an email*. See: the Mind lists the email under "Watch out" and does not ask to pay (`stoppedBy: model`) | +| **Skills grant tools** | A Mind without a payment skill has no payment tool, whatever it is told | Attack playground, *Use a skill it doesn't have*. See: `send_payment` never appears (`stoppedBy: no_tool`) | +| **The owner's approval** | Any payment the model was talked into: nothing is sent until the owner approves | Ask a Payments Mind to pay. See: an approval card that names the amount, the recipient and the checks below | +| **The wallet policy (OutLayer, in a TEE)** | A payment the owner approved by mistake: over the per-payment limit or to an address not on the list is refused before signing, with no transaction | Approve a payment above the limit. See: `policy_denied`, no tx hash. The card already says "blocked even if you approve" | +| **Daily limit (OutLayer, in a TEE)** | Many small payments that add up: once today's payments reach the daily limit, the next one is refused before signing; the day starts at 00:00 UTC | Wallet → Edit → *Per day*. See: "Spent today: X of Y NEAR" | +| **The owner's rules (opt-in)** | Nothing by themselves: they only skip the card the owner chose to skip, only up to the owner's amount and only to a listed address. Guests and the Attack playground always ask, and the TEE policy still checks every payment | Mind settings → Approvals → payments up to 0.01. See: no card, and the receipt says "Approved by your rule" | +| **Freeze (the kill switch)** | Everything, at once: one transaction the owner signs | Wallet → Freeze wallet (on your own Mind). See: every later payment ends `wallet_frozen` | +| **Unattended jobs** | Autopilot jobs get no payment or approval tools; they may only email the owner or add to the owner's calendar, as steps the owner placed | Builder → Use a tool → *Email me*. See: it can only send the Mind's notes, to your own Gmail | + +**Why not a capped function-call key?** NEAR function-call access keys cannot transfer NEAR, and their `allowance` is a gas budget for the key's whole life, not a spending cap ([docs](https://docs.near.org/protocol/accounts-contracts/access-keys)). The spending rules therefore live in the wallet's policy, which OutLayer checks in its TEE before every signature. From 15d9178fdfa9aa8aafc2593f292c71490e0efcae Mon Sep 17 00:00:00 2001 From: Lexirieru Date: Fri, 13 Nov 2026 04:37:32 +0700 Subject: [PATCH 3/9] feat(docs): docs pages with a sidebar, a phone menu and Swagger UI for the API reference One catch-all route renders every content page (GitHub-style heading ids, so README anchors still work). The API reference adds Swagger UI over /openapi.json, client-only, with the hosted server https://api.hellonear.xyz. The phone menu is a
, so it works without JavaScript. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e --- apps/docs/app/(docs)/[[...slug]]/page.tsx | 69 +++++++++++++ apps/docs/app/(docs)/layout.tsx | 19 ++++ apps/docs/app/_components/Brand.tsx | 13 +++ apps/docs/app/_components/Sidebar.tsx | 24 +++++ apps/docs/app/_components/Swagger.tsx | 15 +++ apps/docs/lib/content.ts | 116 ++++++++++++++++++++++ apps/docs/lib/markdown.ts | 34 +++++++ apps/docs/lib/nav.ts | 21 ++++ 8 files changed, 311 insertions(+) create mode 100644 apps/docs/app/(docs)/[[...slug]]/page.tsx create mode 100644 apps/docs/app/(docs)/layout.tsx create mode 100644 apps/docs/app/_components/Brand.tsx create mode 100644 apps/docs/app/_components/Sidebar.tsx create mode 100644 apps/docs/app/_components/Swagger.tsx create mode 100644 apps/docs/lib/content.ts create mode 100644 apps/docs/lib/markdown.ts create mode 100644 apps/docs/lib/nav.ts diff --git a/apps/docs/app/(docs)/[[...slug]]/page.tsx b/apps/docs/app/(docs)/[[...slug]]/page.tsx new file mode 100644 index 00000000..1b6bcbbc --- /dev/null +++ b/apps/docs/app/(docs)/[[...slug]]/page.tsx @@ -0,0 +1,69 @@ +import type { Metadata } from "next"; +import Link from "next/link"; +import { notFound } from "next/navigation"; +import { getPage, markdownUrl, orderedSections, pages } from "@/lib/content"; +import { render } from "@/lib/markdown"; +import { REPO_URL } from "@/lib/site"; +import { NavList } from "../../_components/Sidebar"; +import { Swagger } from "../../_components/Swagger"; + +type Props = { params: Promise<{ slug?: string[] }> }; + +export const dynamicParams = false; + +export function generateStaticParams() { + return pages.filter((p) => !p.slug.startsWith("trust")).map((p) => ({ slug: p.slug ? p.slug.split("/") : [] })); +} + +async function pageOf(props: Props) { + const { slug } = await props.params; + const page = getPage((slug ?? []).join("/")); + if (!page || page.slug.startsWith("trust")) notFound(); + return page; +} + +export async function generateMetadata(props: Props): Promise { + const page = await pageOf(props); + return { + title: page.slug ? page.title : { absolute: "HelloNear Docs" }, + description: page.description, + alternates: { canonical: `/${page.slug}`, types: { "text/markdown": markdownUrl(page.slug) } }, + }; +} + +export default async function DocPage(props: Props) { + const page = await pageOf(props); + const flat = orderedSections().flatMap((s) => s.pages).filter((p) => !p.slug.startsWith("trust")); + const i = flat.findIndex((p) => p.slug === page.slug); + const prev = flat[i - 1]; + const next = flat[i + 1]; + return ( +
+ +
+ Menu + +
+
+
+

{orderedSections().find((s) => s.pages.some((p) => p.slug === page.slug))?.title}

+

{page.title}

+

{page.description}

+
+ {page.slug === "api-reference" && } +
+ +
+
+ ); +} diff --git a/apps/docs/app/(docs)/layout.tsx b/apps/docs/app/(docs)/layout.tsx new file mode 100644 index 00000000..b8e6e2fc --- /dev/null +++ b/apps/docs/app/(docs)/layout.tsx @@ -0,0 +1,19 @@ +import Link from "next/link"; +import { Brand } from "../_components/Brand"; +import { REPO_URL, STATUS_URL } from "@/lib/site"; + +export default function DocsLayout({ children }: { children: React.ReactNode }) { + return ( + <> +
+ +
+ Trust + Status + GitHub +
+
+ {children} + + ); +} diff --git a/apps/docs/app/_components/Brand.tsx b/apps/docs/app/_components/Brand.tsx new file mode 100644 index 00000000..522f0228 --- /dev/null +++ b/apps/docs/app/_components/Brand.tsx @@ -0,0 +1,13 @@ +import Link from "next/link"; + +export function Brand({ href, label }: { href: string; label: string }) { + return ( + + {/* eslint-disable-next-line @next/next/no-img-element */} + + + HelloNear {label} + + + ); +} diff --git a/apps/docs/app/_components/Sidebar.tsx b/apps/docs/app/_components/Sidebar.tsx new file mode 100644 index 00000000..890cd8a0 --- /dev/null +++ b/apps/docs/app/_components/Sidebar.tsx @@ -0,0 +1,24 @@ +import Link from "next/link"; +import { orderedSections } from "@/lib/content"; + +// Server-rendered nav. On phones it sits inside a
menu, so it works without JavaScript. +export function NavList({ current }: { current: string }) { + return ( + + ); +} diff --git a/apps/docs/app/_components/Swagger.tsx b/apps/docs/app/_components/Swagger.tsx new file mode 100644 index 00000000..3fa170b4 --- /dev/null +++ b/apps/docs/app/_components/Swagger.tsx @@ -0,0 +1,15 @@ +"use client"; + +import dynamic from "next/dynamic"; +import "swagger-ui-react/swagger-ui.css"; + +// Swagger UI only runs in the browser; the prose above it is server-rendered and readable without JavaScript. +const SwaggerUI = dynamic(() => import("swagger-ui-react"), { ssr: false, loading: () =>

Loading the API reference…

}); + +export function Swagger({ url }: { url: string }) { + return ( +
+ +
+ ); +} diff --git a/apps/docs/lib/content.ts b/apps/docs/lib/content.ts new file mode 100644 index 00000000..cd5f56b3 --- /dev/null +++ b/apps/docs/lib/content.ts @@ -0,0 +1,116 @@ +import generated from './generated/pages.json' +import { NAV, TRUST_TABS } from './nav' +import { SITE_URL } from './site' + +export type Page = { slug: string; title: string; description: string; markdown: string } + +export const pages: Page[] = generated +const bySlug = new Map(pages.map((p) => [p.slug, p])) + +/** A page by slug ('' is the introduction), or undefined. Accepts '/x', 'x.md' and 'x/'. */ +export function getPage(path: string): Page | undefined { + return bySlug.get(normalize(path)) +} + +export function normalize(path: string): string { + let p = path.trim() + try { + if (/^https?:\/\//.test(p)) p = new URL(p).pathname + } catch {} + p = p.split(/[?#]/)[0].replace(/^\/+|\/+$/g, '').replace(/\.md$/, '') + if (p === 'index') return '' + return p.replace(/\/index$/, '') +} + +export const pageUrl = (slug: string) => `/${slug}` +export const markdownUrl = (slug: string) => (slug ? `/${slug}.md` : '/index.md') + +/** The page as one Markdown document: what /.md, llms-full.txt and MCP read_page return. */ +export function pageMarkdown(p: Page): string { + return `# ${p.title}\n\n> ${p.description}\n\n${p.markdown}` +} + +/** Docs pages in sidebar order, then the trust pages. */ +export function orderedSections(): { title: string; pages: Page[] }[] { + const take = (slugs: string[]) => slugs.map((s) => bySlug.get(s)).filter((p): p is Page => !!p) + return [...NAV.map((s) => ({ title: s.title, pages: take(s.slugs) })), { title: 'Trust', pages: take(TRUST_TABS.map((t) => t.slug)) }] +} + +export function llmsTxt(base = SITE_URL): string { + const intro = bySlug.get('')! + const sections = orderedSections() + .map((s) => `## ${s.title}\n\n${s.pages.map((p) => `- [${p.title}](${base}${markdownUrl(p.slug)}): ${p.description}`).join('\n')}`) + .join('\n\n') + return `# HelloNear\n\n> ${intro.description}\n\nEverything runs on NEAR testnet during NEAR HACKATHON (1 to 14 Nov 2026). Every page below is Markdown; the HTML version is the same path without \`.md\`. All pages in one file: ${base}/llms-full.txt. OpenAPI spec: ${base}/openapi.json. MCP server (search_docs, read_page): ${base}/mcp.\n\n${sections}\n` +} + +export function llmsFullTxt(base = SITE_URL): string { + return orderedSections() + .flatMap((s) => s.pages) + .map((p) => `${pageMarkdown(p)}\nSource: ${base}${pageUrl(p.slug)}\n`) + .join('\n---\n\n') +} + +export type Hit = { slug: string; title: string; url: string; description: string; snippet: string; score: number } + +const words = (s: string) => s.toLowerCase().match(/[a-z0-9_.\-]+/g)?.filter((w) => w.length > 1) ?? [] + +/** Keyword search: title matches weigh most, then the description, then how often the words occur in the body. */ +export function search(query: string, limit = 5, base = SITE_URL): Hit[] { + const terms = [...new Set(words(query))] + if (!terms.length) return [] + const hits: Hit[] = [] + for (const p of pages) { + const title = p.title.toLowerCase() + const desc = p.description.toLowerCase() + const body = p.markdown.toLowerCase() + let score = 0 + let matched = 0 + for (const t of terms) { + const inBody = body.split(t).length - 1 + const s = (title.includes(t) ? 10 : 0) + (desc.includes(t) ? 4 : 0) + Math.min(inBody, 10) + if (s > 0) matched++ + score += s + } + if (!score) continue + score *= matched / terms.length + if (title === query.toLowerCase().trim()) score += 20 + hits.push({ slug: p.slug, title: p.title, url: `${base}${pageUrl(p.slug)}`, description: p.description, snippet: snippet(p.markdown, terms), score: Math.round(score * 100) / 100 }) + } + return hits.sort((a, b) => b.score - a.score || a.slug.localeCompare(b.slug)).slice(0, Math.max(1, Math.min(limit, 20))) +} + +function snippet(markdown: string, terms: string[]): string { + const lines = markdown.split('\n').filter((l) => l.trim() && !l.startsWith('|---')) + const line = lines.find((l) => terms.some((t) => l.toLowerCase().includes(t))) ?? lines[0] ?? '' + const clean = line.replace(/[*`#>|]/g, ' ').replace(/\[([^\]]*)\]\([^)]*\)/g, '$1').replace(/\s+/g, ' ').trim() + return clean.length > 240 ? clean.slice(0, 237) + '...' : clean +} + +/** Splits Markdown at headings of one level: the text before the first one, then each section. */ +export function sections(markdown: string, level: 2 | 3): { intro: string; items: { title: string; id: string; body: string }[] } { + const mark = '#'.repeat(level) + ' ' + const parts = markdown.split('\n') + let intro: string[] = [] + const items: { title: string; id: string; body: string }[] = [] + let inFence = false + for (const line of parts) { + if (line.startsWith('```')) inFence = !inFence + if (!inFence && line.startsWith(mark)) { + const title = line.slice(mark.length).trim() + items.push({ title, id: slugify(title), body: '' }) + } else if (items.length) items[items.length - 1].body += line + '\n' + else intro.push(line) + } + return { intro: intro.join('\n').trim(), items: items.map((i) => ({ ...i, body: i.body.trim() })) } +} + +/** GitHub-style heading ids, so README anchors keep working. */ +export function slugify(text: string): string { + return text + .toLowerCase() + .replace(/<[^>]+>/g, '') + .replace(/[^\p{L}\p{N}\s_-]/gu, '') + .trim() + .replace(/\s/g, '-') +} diff --git a/apps/docs/lib/markdown.ts b/apps/docs/lib/markdown.ts new file mode 100644 index 00000000..e498fc10 --- /dev/null +++ b/apps/docs/lib/markdown.ts @@ -0,0 +1,34 @@ +import { Marked } from 'marked' +import { slugify } from './content' + +const marked = new Marked({ + gfm: true, + renderer: { + heading({ tokens, depth, text }) { + const id = slugify(text) + const inner = this.parser.parseInline(tokens) + return `${inner}\n` + }, + link({ href, title, tokens }) { + const inner = this.parser.parseInline(tokens) + const external = /^https?:\/\//.test(href) + const t = title ? ` title="${title}"` : '' + return external ? `${inner}` : `${inner}` + }, + }, +}) + +/** Markdown from content/ (ours, trusted) to HTML. */ +export function render(markdown: string): string { + const html = marked.parse(markdown, { async: false }) as string + // Wide tables scroll inside their own box, never the page. + return html.replace(//g, '
').replace(/<\/table>/g, '
') +} + +/** The trust overview's scope table: "Yes" cells become a check mark, "N/A" cells are dimmed. */ +export function renderMatrix(markdown: string): string { + return render(markdown) + .replace(/]*)>]*)>Yes<\/a><\/td>/g, ' Yes') + .replace(/]*)>Yes<\/td>/g, ' Yes') + .replace(/]*)>N\/A<\/td>/g, 'N/A') +} diff --git a/apps/docs/lib/nav.ts b/apps/docs/lib/nav.ts new file mode 100644 index 00000000..43ff63ce --- /dev/null +++ b/apps/docs/lib/nav.ts @@ -0,0 +1,21 @@ +// The sidebar, and the order of /llms.txt. Every docs page in content/ must appear here once (a test checks it); +// the trust pages have their own tabs. +export const NAV: { title: string; slugs: string[] }[] = [ + { title: 'Get started', slugs: ['', 'quickstart', 'how-it-works', 'tech-stack'] }, + { + title: 'Concepts', + slugs: ['minds', 'skills', 'wallet-and-approvals', 'verified-replies', 'privacy', 'autopilot', 'telegram', 'connections', 'agent'], + }, + { title: 'Track features', slugs: ['tracks', 'haggling', 'agent-market', 'contract-check', 'payments-csv', 'relayer', 'swarm-auction'] }, + { title: 'API', slugs: ['api-reference', 'api', 'events', 'errors', 'status'] }, + { title: 'Smart contracts', slugs: ['contracts'] }, + { title: 'More', slugs: ['run-locally', 'connectors', 'hackathon-phase'] }, +] + +export const TRUST_TABS: { slug: string; label: string }[] = [ + { slug: 'trust', label: 'Overview' }, + { slug: 'trust/resources', label: 'Resources' }, + { slug: 'trust/subprocessors', label: 'Subprocessors' }, + { slug: 'trust/faq', label: 'FAQ' }, + { slug: 'trust/updates', label: 'Updates' }, +] From 84f0a1b5fc4d4dcc064149159e19ac4e6310e0da Mon Sep 17 00:00:00 2001 From: Lexirieru Date: Fri, 13 Nov 2026 04:37:32 +0700 Subject: [PATCH 4/9] feat(docs): Trust Center at /trust: scope and controls, resources, subprocessors, FAQ and updates Laid out like a trust center (hero, tabs, cards), with HelloNear's own facts only: every Yes in the scope table links to its proof (TEE Explorer report, OutLayer policy tx, SourceScan, source files), N/A where a control does not apply, no compliance badges, no team names. Subprocessors and FAQ answers were checked against the code and the folders' CLAUDE.md; updates only from git log and the README. The git history (all branches, 1230 commits) was scanned for key-shaped strings on 13 Nov: only a 1Click quote signature in a test fixture and placeholder Telegram tokens in tests. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e --- apps/docs/app/_components/Faq.tsx | 31 ++++++++ apps/docs/app/_components/TrustTabs.tsx | 20 +++++ apps/docs/app/_components/UpdateCard.tsx | 17 +++++ apps/docs/app/trust/[section]/page.tsx | 95 ++++++++++++++++++++++++ apps/docs/app/trust/layout.tsx | 41 ++++++++++ apps/docs/app/trust/page.tsx | 65 ++++++++++++++++ apps/docs/content/trust/faq.md | 65 ++++++++++++++++ apps/docs/content/trust/index.md | 42 +++++++++++ apps/docs/content/trust/resources.md | 33 ++++++++ apps/docs/content/trust/subprocessors.md | 61 +++++++++++++++ apps/docs/content/trust/updates.md | 44 +++++++++++ 11 files changed, 514 insertions(+) create mode 100644 apps/docs/app/_components/Faq.tsx create mode 100644 apps/docs/app/_components/TrustTabs.tsx create mode 100644 apps/docs/app/_components/UpdateCard.tsx create mode 100644 apps/docs/app/trust/[section]/page.tsx create mode 100644 apps/docs/app/trust/layout.tsx create mode 100644 apps/docs/app/trust/page.tsx create mode 100644 apps/docs/content/trust/faq.md create mode 100644 apps/docs/content/trust/index.md create mode 100644 apps/docs/content/trust/resources.md create mode 100644 apps/docs/content/trust/subprocessors.md create mode 100644 apps/docs/content/trust/updates.md diff --git a/apps/docs/app/_components/Faq.tsx b/apps/docs/app/_components/Faq.tsx new file mode 100644 index 00000000..ddc4599f --- /dev/null +++ b/apps/docs/app/_components/Faq.tsx @@ -0,0 +1,31 @@ +"use client"; + +import { useEffect, useRef } from "react"; + +// Expand all / Collapse all for the FAQ's
, and open the one a #link points at. The answers are plain +//
, so they work without JavaScript. +export function FaqControls({ children }: { children: React.ReactNode }) { + const ref = useRef(null); + const setAll = (open: boolean) => ref.current?.querySelectorAll("details").forEach((d) => (d.open = open)); + useEffect(() => { + const openHash = () => { + const el = location.hash ? document.getElementById(decodeURIComponent(location.hash.slice(1))) : null; + if (el instanceof HTMLDetailsElement) { + el.open = true; + el.scrollIntoView({ block: "start" }); + } + }; + openHash(); + window.addEventListener("hashchange", openHash); + return () => window.removeEventListener("hashchange", openHash); + }, []); + return ( +
+
+ + +
+ {children} +
+ ); +} diff --git a/apps/docs/app/_components/TrustTabs.tsx b/apps/docs/app/_components/TrustTabs.tsx new file mode 100644 index 00000000..9f6de648 --- /dev/null +++ b/apps/docs/app/_components/TrustTabs.tsx @@ -0,0 +1,20 @@ +"use client"; + +import Link from "next/link"; +import { usePathname } from "next/navigation"; +import { TRUST_TABS } from "@/lib/nav"; + +export function TrustTabs() { + const path = usePathname().replace(/\/$/, ""); + return ( + + ); +} diff --git a/apps/docs/app/_components/UpdateCard.tsx b/apps/docs/app/_components/UpdateCard.tsx new file mode 100644 index 00000000..5486e57a --- /dev/null +++ b/apps/docs/app/_components/UpdateCard.tsx @@ -0,0 +1,17 @@ +import Link from "next/link"; +import { render } from "@/lib/markdown"; + +export function UpdateCard({ title, body, id, short }: { title: string; body: string; id: string; short?: boolean }) { + const [meta, ...rest] = body.split("\n"); + const [date, category] = meta.replace(/^Published /, "").split(" · "); + const text = rest.join("\n").trim(); + return ( +
+

+ {category} Published {date} +

+

{short ? {title} : title}

+ {!short &&
} +
+ ); +} diff --git a/apps/docs/app/trust/[section]/page.tsx b/apps/docs/app/trust/[section]/page.tsx new file mode 100644 index 00000000..b4e8f60a --- /dev/null +++ b/apps/docs/app/trust/[section]/page.tsx @@ -0,0 +1,95 @@ +import type { Metadata } from "next"; +import { notFound } from "next/navigation"; +import { getPage, sections } from "@/lib/content"; +import { render } from "@/lib/markdown"; +import { FaqControls } from "../../_components/Faq"; +import { UpdateCard } from "../../_components/UpdateCard"; + +const SECTIONS = ["resources", "subprocessors", "faq", "updates"] as const; +type Props = { params: Promise<{ section: string }> }; + +export const dynamicParams = false; +export const generateStaticParams = () => SECTIONS.map((section) => ({ section })); + +async function pageOf(props: Props) { + const { section } = await props.params; + const page = getPage(`trust/${section}`); + if (!page) notFound(); + return { section, page }; +} + +export async function generateMetadata(props: Props): Promise { + const { section, page } = await pageOf(props); + return { title: page.title, description: page.description, alternates: { canonical: `/trust/${section}`, types: { "text/markdown": `/trust/${section}.md` } } }; +} + +export default async function TrustSection(props: Props) { + const { section, page } = await pageOf(props); + return ( + <> +

{page.title}

+

{page.description}

+ {section === "faq" && } + {section === "subprocessors" && } + {section === "resources" && } + {section === "updates" && ( +
+ {sections(page.markdown, 3).items.map((u) => ( + + ))} +
+ )} + + ); +} + +function Cards({ markdown, className }: { markdown: string; className: string }) { + const s = sections(markdown, 3); + return ( + <> + {s.intro &&
} +
+ {s.items.map((c) => ( +
+

{c.title}

+
+
+ ))} +
+ + ); +} + +function Resources({ markdown }: { markdown: string }) { + return ( +
+ {sections(markdown, 2).items.map((g) => ( +
+

{g.title}

+
+
+ ))} +
+ ); +} + +function Faq({ markdown }: { markdown: string }) { + return ( + + {sections(markdown, 2).items.map((cat) => ( +
+

{cat.title}

+ {sections(cat.body, 3).items.map((q) => ( +
+ + {q.title} + # + +
+
+ ))} +
+ ))} +
+ ); +} diff --git a/apps/docs/app/trust/layout.tsx b/apps/docs/app/trust/layout.tsx new file mode 100644 index 00000000..9e201217 --- /dev/null +++ b/apps/docs/app/trust/layout.tsx @@ -0,0 +1,41 @@ +import type { Metadata } from "next"; +import { Brand } from "../_components/Brand"; +import { TrustTabs } from "../_components/TrustTabs"; +import { ISSUES_URL, REPO_URL, STATUS_URL, TRUST_URL } from "@/lib/site"; + +export const metadata: Metadata = { + title: { default: "HelloNear Trust Center", template: "%s · HelloNear Trust Center" }, + alternates: { canonical: TRUST_URL }, +}; + +export default function TrustLayout({ children }: { children: React.ReactNode }) { + return ( +
+
+ + +
+
+
+

Welcome to the HelloNear Trust Center

+

+ HelloNear lets an AI agent pay for you while the rules about money stay out of its reach. Here is what protects your data and + funds, and a link to check each claim yourself. +

+

+ Privacy · Security model · Receipts +

+
+
+ +
{children}
+
+ Everything here runs on NEAR testnet during NEAR HACKATHON (1 to 14 Nov 2026). This page as Markdown +
+
+ ); +} diff --git a/apps/docs/app/trust/page.tsx b/apps/docs/app/trust/page.tsx new file mode 100644 index 00000000..1341e7d5 --- /dev/null +++ b/apps/docs/app/trust/page.tsx @@ -0,0 +1,65 @@ +import type { Metadata } from "next"; +import Link from "next/link"; +import { getPage, sections } from "@/lib/content"; +import { render, renderMatrix } from "@/lib/markdown"; +import { UpdateCard } from "../_components/UpdateCard"; + +export const metadata: Metadata = { title: { absolute: "HelloNear Trust Center" }, description: getPage("trust")!.description }; + +export default function TrustOverview() { + const page = getPage("trust")!; + const top = sections(page.markdown, 2); + const scope = top.items.find((s) => s.title === "Scope and controls")!; + const controls = sections(top.items.find((s) => s.title === "Controls")!.body, 3); + const subs = sections(getPage("trust/subprocessors")!.markdown, 3).items; + const updates = sections(getPage("trust/updates")!.markdown, 3).items.slice(0, 3); + return ( + <> +
+ +
+

Scope and controls

+
+
+ +
+

Controls

+
+
+ {controls.items.map((c) => ( +
+

{c.title}

+
+
+ ))} +
+
+ +
+
+

Subprocessors

+ View all +
+
    + {subs.map((s) => ( +
  • + {s.title} +
  • + ))} +
+
+ +
+
+

Updates

+ View all +
+
+ {updates.map((u) => ( + + ))} +
+
+ + ); +} diff --git a/apps/docs/content/trust/faq.md b/apps/docs/content/trust/faq.md new file mode 100644 index 00000000..e0f434a0 --- /dev/null +++ b/apps/docs/content/trust/faq.md @@ -0,0 +1,65 @@ +--- +title: FAQ +description: Answers about security, data processing, model training, wallets and funds, taken only from what HelloNear's code does. +--- + +## Security + +### Can the AI pay someone the owner did not approve? +No payment tool runs without the owner's approval, unless the owner turned on a rule for small payments to listed addresses. Even after approval, OutLayer checks the wallet policy in a TEE before signing and refuses a payment over the limit or to an address not on the list. See [Wallet, limits and approvals](/wallet-and-approvals). + +### How are API keys stored? +Encrypted with AES-256-GCM, bound to the owner and the key's name. They are never returned by the API, never put in prompts, and filled in only by the tool for the hosts the owner listed. See [Connections and keys](/connections). + +### How are sessions stored? +Only the SHA-256 hash of the session token is stored. The cookie `hn_session` is `HttpOnly`, `SameSite=Lax` and `Secure` on the hosted demo. State-changing requests from an origin HelloNear does not list are refused (`403 bad_origin`). + +### Has the repository been checked for leaked keys? +Yes. On 13 Nov 2026 the full git history (all branches) was scanned for key-shaped strings. None were real: the matches are a 1Click quote signature in a test fixture and placeholder Telegram tokens in tests. Postgres credentials in the repository are for local development only. + +### Can someone else read my Mind or my runs? +Every route checks that the signed-in user owns the Mind or run. Another user's Mind answers `404`, never `403`, so ids cannot be probed. + +## Data processing + +### What does HelloNear store? +Chat history, the Mind's memory of its owner, encrypted keys, payments, and the proofs behind verified replies. The full table is on [Privacy](/privacy). + +### Does the verification proof contain my conversation? +No. It holds signatures, hashes and Intel's TDX quote only, never the conversation text. + +### How do I delete my data? +Deleting a chat hides it at once, asks the engine to forget it, and removes it for good after 30 days. Memory can be edited or cleared in the Mind's settings. Guest accounts are deleted with all their Minds after 7 days. + +### Who sees my prompts while the model runs? +Nobody outside the TEE: not the cloud provider, not the model host, not NEAR AI. HelloNear's own backend does keep the chat, so the Mind can continue it. + +## Model training + +### Does HelloNear train models on my data? +No. HelloNear does not train or fine-tune any model. Replies come from models on NEAR AI Cloud, called inside a TEE. + +### Which models are used? +`z-ai/glm-5.3-flash` by default, `deepseek-ai/DeepSeek-V4.1-Flash-1017` for reasoning and `Qwen/Qwen3-Embedding-0.6B` for memory, all on NEAR AI Cloud. See [The agent](/agent). + +## Wallet & funds + +### Is real money involved? +No. During the hackathon everything runs on NEAR testnet, whose tokens have no value. Cross-chain payments and Agent Market hiring are only quoted, since they need mainnet. See [Hackathon phase](/hackathon-phase). + +### Who holds the Mind's wallet? +Each Mind's wallet is an OutLayer wallet. HelloNear stores its key encrypted, one wallet per Mind. The owner's own NEAR wallet signs the policy and Freeze, so those changes are transactions anyone can see. + +### What happens to funds when a Mind is deleted? +Deleting a Mind deletes the only copy of its wallet key, so HelloNear refuses (`409 wallet_not_empty`) while the wallet holds more than 0.001 NEAR, until the owner confirms they have seen the balance. + +### Is a refused payment on chain? +No. OutLayer refuses it in the TEE before signing, so there is no transaction. HelloNear never shows a transaction link for one. + +## Other + +### How do I report a security issue? +Open an issue on [GitHub](https://github.com/Hellonear-AI/hellonear/issues/new). Please do not include keys, personal data or a working exploit in a public issue; describe the problem and we will follow up. + +### Where can I see whether HelloNear is up? +On [status.hellonear.xyz](https://status.hellonear.xyz), checked every 5 minutes. See [Status](/status). diff --git a/apps/docs/content/trust/index.md b/apps/docs/content/trust/index.md new file mode 100644 index 00000000..cf360b6d --- /dev/null +++ b/apps/docs/content/trust/index.md @@ -0,0 +1,42 @@ +--- +title: Trust Center +description: How HelloNear keeps an AI agent's money rules out of the model's reach, with every claim linked to something you can check yourself. +--- + +HelloNear gives a person an AI agent that can pay, so the limits that matter sit outside the model: the owner approves, the wallet's policy is checked in a TEE before signing, and every reply carries a proof from NEAR AI Cloud's TEE. This Trust Center lists what is protected, how, and where to check it, without asking you to take our word for it. + +## Scope and controls + +What each part of HelloNear is covered by. Every "Yes" links to its proof. "N/A" means the control does not apply to that part. + +| Scope | TEE-verified | Policy enforced before signing | Source verified (NEP-330, SourceScan) | Source public | Testnet only | +|---|---|---|---|---|---| +| Chat inference (NEAR AI Cloud) | [Yes](https://proof.t16z.com/reports/1b374e5b10031496c6c45bc7749038d7e7cd26a16996455f893b6b5dd44a9db2) | N/A | N/A | [Yes](https://github.com/Hellonear-AI/hellonear/blob/main/engine/src/verify.ts) | N/A | +| Mind wallet (OutLayer) | N/A | [Yes](https://testnet.nearblocks.io/txns/DhKqbLAX3zhH2tP3kJDx5Xsk8ZkMByfJbYLyWYyivXXZ) | N/A | [Yes](https://github.com/Hellonear-AI/hellonear/blob/main/apps/be/src/wallets.ts) | [Yes](https://github.com/Hellonear-AI/hellonear#hackathon-phase-testnet) | +| Mind registry contract | N/A | N/A | [Yes](https://testnet.nearblocks.io/address/hellonear-registry.testnet?tab=contract) | [Yes](https://github.com/Hellonear-AI/hellonear/tree/main/sc) | [Yes](https://testnet.nearblocks.io/address/hellonear-registry.testnet) | +| Swarm auction contract | N/A | N/A | [Yes](https://testnet.nearblocks.io/address/auction.hellonear-swarm.testnet?tab=contract) | [Yes](https://github.com/Hellonear-AI/hellonear/tree/main/sc/swarm) | [Yes](https://testnet.nearblocks.io/address/auction.hellonear-swarm.testnet) | +| Hosted demo (app and API) | N/A | N/A | N/A | [Yes](https://github.com/Hellonear-AI/hellonear) | [Yes](https://github.com/Hellonear-AI/hellonear#hackathon-phase-testnet) | + +"Source public" means the code is published to be read and run locally; the license is all rights reserved, not an open-source license ([LICENSE](https://github.com/Hellonear-AI/hellonear/blob/main/LICENSE)). The hosted API names the commit it runs at [api.hellonear.xyz/v1/health](https://api.hellonear.xyz/v1/health) (`revision`). + +## Controls + +HelloNear holds no compliance certification. These are the controls that exist in the code, each with where to check it. + +### Owner approval for every payment +Nothing is paid until the owner approves, in the app or in Telegram, unless the owner turned on a rule for small payments to listed addresses. See [Wallet, limits and approvals](/wallet-and-approvals). + +### Wallet policy checked in a TEE +Per-payment limit, daily limit and allowed addresses are stored on NEAR and checked by OutLayer in a TEE before signing. A refused payment has no transaction. [Policy tx](https://testnet.nearblocks.io/txns/DhKqbLAX3zhH2tP3kJDx5Xsk8ZkMByfJbYLyWYyivXXZ). + +### Freeze in one signature +The owner signs one transaction and every later payment ends `wallet_frozen`. [Freeze tx](https://testnet.nearblocks.io/txns/HHGf2pqGRGTEJuA7wn4R18swFC4ssL6XMyXyogFHkDgu). + +### Verified replies +Each reply's signature is checked against NEAR AI Cloud's TEE attestation before the badge shows, and the proof opens on Phala's TEE Explorer. See [Verified replies](/verified-replies). + +### Secrets the model never sees +API keys are encrypted with AES-256-GCM and filled in only by the tool, for the hosts the owner listed. A test scans every table for them. See [Connections and keys](/connections). + +### Verified contract source +Both contracts were built reproducibly and verified through SourceScan, so anyone can rebuild them and compare the code hash. See [Receipts and smart contracts](/contracts). diff --git a/apps/docs/content/trust/resources.md b/apps/docs/content/trust/resources.md new file mode 100644 index 00000000..227eee2a --- /dev/null +++ b/apps/docs/content/trust/resources.md @@ -0,0 +1,33 @@ +--- +title: Resources +description: Documents and commands to check HelloNear's claims yourself, grouped by verification, contracts, API and security. +--- + +## Verification + +- [Receipts: check them yourself](https://github.com/Hellonear-AI/hellonear#receipts-check-them-yourself): every on-chain claim with its transaction. +- [A verified reply's TEE Explorer report](https://proof.t16z.com/reports/1b374e5b10031496c6c45bc7749038d7e7cd26a16996455f893b6b5dd44a9db2): reads VERIFIED. +- [Verified replies](/verified-replies): badge levels and what the proof holds. +- [How the NEAR Intents quotes are checked](https://github.com/Hellonear-AI/hellonear#near-intents-quotes-signed-by-1click): 1Click's signature, checked with the official SDK. + +## Contracts + +- [Registry contract: verify it without a browser](/contracts#the-registry-contracts-source-is-verified): three RPC commands that print the code hash, the build info and SourceScan's record. +- [Registry contract interface](https://github.com/Hellonear-AI/hellonear/blob/main/sc/README.md): methods, events and upgrade rules. +- [Swarm auction rules](https://github.com/Hellonear-AI/hellonear/blob/main/sc/swarm/RULES.md): the round, the bond and who can close. +- [Swarm auction safety choices](https://github.com/Hellonear-AI/hellonear/blob/main/sc/swarm/README.md): the 9 findings of the 13 Nov review and how each was fixed. +- [Swarm simulation report](https://github.com/Hellonear-AI/hellonear/blob/main/sc/swarm/simulation-report.md): 20 buyers, 5 sellers, money conserved every round. + +## API + +- [OpenAPI spec](/openapi.json), rendered in the [API reference](/api-reference). +- [API contract](https://github.com/Hellonear-AI/hellonear/blob/main/docs/api-contract.md): every route, field and event. +- [Streaming events](/events) and [Errors](/errors). +- [Status page](https://status.hellonear.xyz) and its data at [GET /v1/status](https://api.hellonear.xyz/v1/status). + +## Security + +- [Security model](https://github.com/Hellonear-AI/hellonear#security-model): the layers and how to see each one stop an attack. +- [What is private, and what HelloNear keeps](/privacy). +- [Hosted demo setup](https://github.com/Hellonear-AI/hellonear/blob/main/deploy/README.md): firewall, tunnel, where keys live. +- [Report an issue](https://github.com/Hellonear-AI/hellonear/issues/new). diff --git a/apps/docs/content/trust/subprocessors.md b/apps/docs/content/trust/subprocessors.md new file mode 100644 index 00000000..478485a8 --- /dev/null +++ b/apps/docs/content/trust/subprocessors.md @@ -0,0 +1,61 @@ +--- +title: Subprocessors +description: The third-party services HelloNear uses, what each one does, and what data it receives. +--- + +Services outside HelloNear that receive data when you use it. Each entry says what it is for and what it gets. + +### NEAR AI Cloud +- **Function:** language model and embeddings +- **Runs in:** a TEE; each reply is verified against the attestation +- **Used for:** every chat reply, workflow step and memory search. Prompts and replies are processed inside the TEE. + +### OutLayer +- **Function:** the Mind's wallet +- **Runs in:** a TEE; NEAR testnet (`testnet-api.outlayer.ai`) +- **Used for:** signing payments after the wallet policy is checked. Receives the payment's amount and recipient. + +### Composio +- **Function:** app connections (OAuth) +- **Runs in:** Composio's hosted service +- **Used for:** Gmail, Google Calendar and Meet, Sheets, Drive, Docs, Notion, Slack, Discord, Outlook, HubSpot and Zoom. Stores and refreshes the OAuth tokens; the tools read and write the owner's app data through it. + +### AgentMail +- **Function:** a Mind's own email inbox +- **Runs in:** AgentMail's hosted service +- **Used for:** only Minds with the `email-address` skill. Receives the emails that Mind sends and receives. + +### NEAR Intents (1Click) +- **Function:** cross-chain payment quotes +- **Runs in:** NEAR Intents' hosted API +- **Used for:** dry quotes only (`dry: true`); nothing is sent. Receives the amount, tokens, chains and addresses of the quote. + +### NEAR AI Agent Market +- **Function:** catalog of agents and their prices +- **Runs in:** market.near.ai +- **Used for:** the Hire on Agent Market skill. A search sends the search terms; a quote sends the job description to the chosen agent. Nothing is hired or paid. + +### FastNear RPC +- **Function:** NEAR testnet RPC +- **Runs in:** NEAR testnet (`test.rpc.fastnear.com`) +- **Used for:** account lookups, payment checks, the relayer and the status checks. Receives public account names and transaction hashes. + +### Phala TEE Attestation Explorer +- **Function:** public report for a TEE quote +- **Runs in:** proof.t16z.com +- **Used for:** only when the owner clicks **Check it in TEE Explorer**. Receives the Intel quote, no conversation text; the report is public. + +### Vercel +- **Function:** web hosting +- **Runs in:** Vercel +- **Used for:** status.hellonear.xyz, and this docs and trust site. + +### Cloudflare +- **Function:** DNS and tunnel +- **Runs in:** Cloudflare +- **Used for:** the public names `hellonear.xyz`, `app.hellonear.xyz` and `api.hellonear.xyz`, through a Cloudflare Tunnel to the hosted demo. + +### Telegram +- **Function:** chat bot (optional) +- **Runs in:** Telegram +- **Used for:** only Minds whose owner linked a bot. Receives the owner's messages to the bot, the Mind's replies and approval cards. diff --git a/apps/docs/content/trust/updates.md b/apps/docs/content/trust/updates.md new file mode 100644 index 00000000..715a1371 --- /dev/null +++ b/apps/docs/content/trust/updates.md @@ -0,0 +1,44 @@ +--- +title: Updates +description: Dated changes to HelloNear's security, verification and availability, each backed by the repository. +--- + +### Status page live, after two provider outages +Published 13 November 2026 · Availability + +[status.hellonear.xyz](https://status.hellonear.xyz) checks HelloNear and its providers every 5 minutes. It was built after two outages from outside HelloNear's code in one night: NEAR AI embeddings hung, and NEAR Intents 1Click quotes timed out. Minds now say plainly when a provider is down and point to the status page. + +### Swarm auction contract live and source-verified +Published 13 November 2026 · Contracts + +`auction.hellonear-swarm.testnet` was built reproducibly from commit `64c9278` and verified through SourceScan (code hash `6Wn9K6b3DtoH4TnoXs2jx6zFzihdzFDQGw4ae2dzcCv1`). The 9 findings of the 13 Nov review were fixed before it was deployed, and round 0 ran on testnet. See [Swarm auction](/swarm-auction). + +### Gas relayer live on the hosted demo +Published 13 November 2026 · Wallet + +A NEP-366 relayer pays the gas for owners' `unequip_skill` and `set_wallet` calls to the registry, never a deposit, and refuses a bad request before sending it. See [Gas relayer](/relayer). + +### Registry contract redeployed from a reproducible build +Published 12 November 2026 · Contracts + +`hellonear-registry.testnet` v0.3.0 was redeployed code-only from a reproducible build of commit `95c2b3d` and verified through SourceScan (code hash `GUxsMNJdJKoFq7VJawNeCwW7GjGZE6TpURPj13ojEnub`, tx [`DmidjQmo…`](https://testnet.nearblocks.io/txns/DmidjQmoN15bj2qctXaXDefAW5NGJZFBPqqPPFJoa6Qb)). + +### Check a verified reply on Phala's TEE Explorer +Published 12 November 2026 · Verification + +**Check it in TEE Explorer** uploads a run's Intel quote and opens a report that reads VERIFIED. Only the quote leaves, no conversation text. + +### View proof behind the Verified badge +Published 11 November 2026 · Verification + +Every verified reply keeps its proof (signatures, hashes and Intel's TDX quote), and the owner can open it from the badge. + +### Daily limit proven on testnet +Published 10 November 2026 · Wallet + +A daily spending cap in the wallet policy was tested on a throwaway wallet: over the cap, OutLayer refuses before signing with no transaction; exactly at the cap goes through; a refused request does not count. + +### Demo wallet replaced after its key was exposed +Published 8 November 2026 · Security + +The demo Mind wallet's key was exposed, so the demo now uses a new wallet with a new key (`83e05486…`). The new key is kept only in gitignored `.env` files. From 888ec4265687937865142ac9876b56b603967d28 Mon Sep 17 00:00:00 2001 From: Lexirieru Date: Fri, 13 Nov 2026 04:37:32 +0700 Subject: [PATCH 5/9] feat(docs): llms.txt, Markdown for every page, skill.md and a read-only MCP server /.md and Accept: text/markdown serve the page's Markdown (proxy.ts); every response links /llms.txt; /skill.md is an Agent Skill. /mcp is stateless Streamable HTTP (initialize, ping, tools/list, tools/call) with search_docs and read_page, CORS *, and /.well-known/mcp describes it. trust.* hosts serve /trust/* at their root. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e --- apps/docs/app/.well-known/mcp/route.ts | 23 +++++++ apps/docs/app/llms-full.txt/route.ts | 5 ++ apps/docs/app/llms.txt/route.ts | 5 ++ apps/docs/app/mcp/route.ts | 32 +++++++++ apps/docs/app/md/[[...slug]]/route.ts | 12 ++++ apps/docs/app/skill.md/route.ts | 5 ++ apps/docs/lib/mcp.ts | 94 ++++++++++++++++++++++++++ apps/docs/lib/skill.ts | 41 +++++++++++ apps/docs/proxy.ts | 42 ++++++++++++ 9 files changed, 259 insertions(+) create mode 100644 apps/docs/app/.well-known/mcp/route.ts create mode 100644 apps/docs/app/llms-full.txt/route.ts create mode 100644 apps/docs/app/llms.txt/route.ts create mode 100644 apps/docs/app/mcp/route.ts create mode 100644 apps/docs/app/md/[[...slug]]/route.ts create mode 100644 apps/docs/app/skill.md/route.ts create mode 100644 apps/docs/lib/mcp.ts create mode 100644 apps/docs/lib/skill.ts create mode 100644 apps/docs/proxy.ts diff --git a/apps/docs/app/.well-known/mcp/route.ts b/apps/docs/app/.well-known/mcp/route.ts new file mode 100644 index 00000000..cad812ba --- /dev/null +++ b/apps/docs/app/.well-known/mcp/route.ts @@ -0,0 +1,23 @@ +import { SERVER_INFO, TOOLS } from "@/lib/mcp"; +import { SITE_URL } from "@/lib/site"; + +export const dynamic = "force-static"; + +// Discovery for agents that look for an MCP server at a well-known path. +export const GET = () => + Response.json( + { + servers: [ + { + name: SERVER_INFO.name, + title: SERVER_INFO.title, + description: "Read-only search and reading of the HelloNear docs and Trust Center.", + url: `${SITE_URL}/mcp`, + transport: "streamable-http", + authentication: "none", + tools: TOOLS.map((t) => ({ name: t.name, description: t.description })), + }, + ], + }, + { headers: { "access-control-allow-origin": "*" } }, + ); diff --git a/apps/docs/app/llms-full.txt/route.ts b/apps/docs/app/llms-full.txt/route.ts new file mode 100644 index 00000000..b7397455 --- /dev/null +++ b/apps/docs/app/llms-full.txt/route.ts @@ -0,0 +1,5 @@ +import { llmsFullTxt } from "@/lib/content"; + +export const dynamic = "force-static"; + +export const GET = () => new Response(llmsFullTxt(), { headers: { "content-type": "text/plain; charset=utf-8" } }); diff --git a/apps/docs/app/llms.txt/route.ts b/apps/docs/app/llms.txt/route.ts new file mode 100644 index 00000000..3eab9bee --- /dev/null +++ b/apps/docs/app/llms.txt/route.ts @@ -0,0 +1,5 @@ +import { llmsTxt } from "@/lib/content"; + +export const dynamic = "force-static"; + +export const GET = () => new Response(llmsTxt(), { headers: { "content-type": "text/plain; charset=utf-8" } }); diff --git a/apps/docs/app/mcp/route.ts b/apps/docs/app/mcp/route.ts new file mode 100644 index 00000000..44665fec --- /dev/null +++ b/apps/docs/app/mcp/route.ts @@ -0,0 +1,32 @@ +import { handle } from "@/lib/mcp"; + +// Stateless Streamable HTTP: POST one JSON-RPC message, get JSON back. No sessions, so GET (the server-to-client +// stream) and DELETE are 405. Read-only and public, hence CORS *. +const CORS = { + "access-control-allow-origin": "*", + "access-control-allow-methods": "POST, GET, OPTIONS", + "access-control-allow-headers": "content-type, accept, mcp-protocol-version, mcp-session-id, authorization", + "access-control-expose-headers": "mcp-protocol-version", +}; + +export const dynamic = "force-dynamic"; + +export async function POST(req: Request) { + let body: unknown; + try { + body = await req.json(); + } catch { + return Response.json({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "Parse error" } }, { status: 400, headers: CORS }); + } + const reply = handle(body); + if (!reply) return new Response(null, { status: 202, headers: CORS }); + return Response.json(reply, { headers: CORS }); +} + +export const GET = () => + new Response("This MCP server is stateless: POST JSON-RPC messages to this URL.\n", { + status: 405, + headers: { ...CORS, allow: "POST, OPTIONS", "content-type": "text/plain; charset=utf-8" }, + }); + +export const OPTIONS = () => new Response(null, { status: 204, headers: CORS }); diff --git a/apps/docs/app/md/[[...slug]]/route.ts b/apps/docs/app/md/[[...slug]]/route.ts new file mode 100644 index 00000000..998bc182 --- /dev/null +++ b/apps/docs/app/md/[[...slug]]/route.ts @@ -0,0 +1,12 @@ +import { getPage, pageMarkdown, pages } from "@/lib/content"; + +// Every page as Markdown. Reached through proxy.ts: /.md, or any path asked for with Accept: text/markdown. +export const dynamicParams = false; +export const generateStaticParams = () => pages.map((p) => ({ slug: p.slug ? p.slug.split("/") : [] })); + +export async function GET(_req: Request, ctx: { params: Promise<{ slug?: string[] }> }) { + const { slug } = await ctx.params; + const page = getPage((slug ?? []).join("/")); + if (!page) return new Response("Not found\n", { status: 404, headers: { "content-type": "text/plain; charset=utf-8" } }); + return new Response(pageMarkdown(page), { headers: { "content-type": "text/markdown; charset=utf-8", vary: "Accept" } }); +} diff --git a/apps/docs/app/skill.md/route.ts b/apps/docs/app/skill.md/route.ts new file mode 100644 index 00000000..b6a3ecbd --- /dev/null +++ b/apps/docs/app/skill.md/route.ts @@ -0,0 +1,5 @@ +import { skillMd } from "@/lib/skill"; + +export const dynamic = "force-static"; + +export const GET = () => new Response(skillMd(), { headers: { "content-type": "text/markdown; charset=utf-8" } }); diff --git a/apps/docs/lib/mcp.ts b/apps/docs/lib/mcp.ts new file mode 100644 index 00000000..31c252b1 --- /dev/null +++ b/apps/docs/lib/mcp.ts @@ -0,0 +1,94 @@ +// A minimal, stateless MCP server over Streamable HTTP: each POST carries one JSON-RPC message and gets one JSON +// answer (no sessions, no SSE). Read-only: it searches and reads the same pages the site renders. +import { getPage, pageMarkdown, search } from './content' +import { SITE_URL } from './site' + +export const PROTOCOL_VERSIONS = ['2025-06-18', '2025-03-26', '2024-11-05'] +export const SERVER_INFO = { name: 'hellonear-docs', title: 'HelloNear Docs', version: '0.1.0' } + +export const TOOLS = [ + { + name: 'search_docs', + title: 'Search the HelloNear docs', + description: 'Search the HelloNear documentation (concepts, API, contracts, trust) by keywords. Returns the best pages with a URL, a description and a matching line.', + inputSchema: { + type: 'object', + properties: { + query: { type: 'string', description: 'Keywords, for example "daily limit" or "run.verified"' }, + limit: { type: 'integer', minimum: 1, maximum: 20, description: 'How many pages to return (default 5)' }, + }, + required: ['query'], + additionalProperties: false, + }, + annotations: { readOnlyHint: true, openWorldHint: false }, + }, + { + name: 'read_page', + title: 'Read a HelloNear docs page', + description: 'Read one HelloNear docs page as Markdown, by path ("/quickstart", "trust/faq") or full URL. Use search_docs first to find the path.', + inputSchema: { + type: 'object', + properties: { path: { type: 'string', description: 'Page path or URL, for example "/wallet-and-approvals"' } }, + required: ['path'], + additionalProperties: false, + }, + annotations: { readOnlyHint: true, openWorldHint: false }, + }, +] + +type Id = string | number | null +type Message = { jsonrpc?: unknown; id?: Id; method?: unknown; params?: Record } +export type Reply = { jsonrpc: '2.0'; id: Id; result?: unknown; error?: { code: number; message: string } } + +const ok = (id: Id, result: unknown): Reply => ({ jsonrpc: '2.0', id, result }) +const fail = (id: Id, code: number, message: string): Reply => ({ jsonrpc: '2.0', id, error: { code, message } }) +const text = (t: string, isError = false) => ({ content: [{ type: 'text', text: t }], ...(isError ? { isError: true } : {}) }) + +/** One JSON-RPC message in, one answer out; null for a notification (the route answers 202 with no body). */ +export function handle(msg: unknown, base = SITE_URL): Reply | null { + if (!msg || typeof msg !== 'object' || Array.isArray(msg)) return fail(null, -32600, 'Invalid Request: send one JSON-RPC object') + const m = msg as Message + const id: Id = typeof m.id === 'string' || typeof m.id === 'number' ? m.id : null + if (m.jsonrpc !== '2.0' || typeof m.method !== 'string') return fail(id, -32600, 'Invalid Request') + const isNotification = !('id' in m) + if (isNotification) return null + const params = m.params && typeof m.params === 'object' ? m.params : {} + + switch (m.method) { + case 'initialize': { + const asked = typeof params.protocolVersion === 'string' ? params.protocolVersion : '' + return ok(id, { + protocolVersion: PROTOCOL_VERSIONS.includes(asked) ? asked : PROTOCOL_VERSIONS[0], + capabilities: { tools: { listChanged: false } }, + serverInfo: SERVER_INFO, + instructions: 'Read-only access to the HelloNear docs and Trust Center. Use search_docs to find pages, then read_page to read one as Markdown.', + }) + } + case 'ping': + return ok(id, {}) + case 'tools/list': + return ok(id, { tools: TOOLS }) + case 'tools/call': { + const args = params.arguments && typeof params.arguments === 'object' ? (params.arguments as Record) : {} + if (params.name === 'search_docs') { + if (typeof args.query !== 'string' || !args.query.trim()) return fail(id, -32602, 'search_docs needs a non-empty "query" string') + const limit = typeof args.limit === 'number' && Number.isFinite(args.limit) ? Math.trunc(args.limit) : 5 + const hits = search(args.query, limit, base) + if (!hits.length) return ok(id, text(`No pages match "${args.query}".`)) + return ok(id, { + ...text(hits.map((h, i) => `${i + 1}. ${h.title}\n ${h.url}\n ${h.description}\n ${h.snippet}`).join('\n\n')), + structuredContent: { results: hits.map(({ slug, title, url, description, snippet, score }) => ({ path: `/${slug}`, title, url, description, snippet, score })) }, + }) + } + if (params.name === 'read_page') { + if (typeof args.path !== 'string') return fail(id, -32602, 'read_page needs a "path" string') + const page = getPage(args.path) + if (!page) return ok(id, text(`No page at "${args.path}". Use search_docs to find one.`, true)) + return ok(id, text(`${pageMarkdown(page)}\nSource: ${base}/${page.slug}\n`)) + } + return fail(id, -32602, `Unknown tool: ${String(params.name)}`) + } + default: + return fail(id, -32601, `Method not found: ${m.method}`) + } +} diff --git a/apps/docs/lib/skill.ts b/apps/docs/lib/skill.ts new file mode 100644 index 00000000..40b47792 --- /dev/null +++ b/apps/docs/lib/skill.ts @@ -0,0 +1,41 @@ +import { API_URL, APP_URL, SITE_URL } from './site' + +// /skill.md: an Agent Skill (agentskills.io frontmatter) that tells another agent how to work with HelloNear. +export function skillMd(base = SITE_URL): string { + return `--- +name: hellonear +description: Use HelloNear, an AI agent platform on NEAR testnet where each Mind has a persona, memory, skills and its own wallet whose limits sit outside the model. Use when asked to try HelloNear, call its API, explain its wallet limits and approvals, or check its on-chain receipts. +--- + +# HelloNear + +HelloNear gives a person a Mind: an AI agent with a persona, memory, equippable skills and a NEAR wallet. Payments need the owner's approval, and the wallet's policy (per-payment limit, daily limit, allowed addresses) is checked by OutLayer in a TEE before signing. Everything runs on NEAR testnet. + +## Read the docs + +- Index of every page: ${base}/llms.txt +- Everything in one file: ${base}/llms-full.txt +- Any page as Markdown: add \`.md\` to its path, for example ${base}/quickstart.md +- MCP server (Streamable HTTP, tools \`search_docs\` and \`read_page\`): ${base}/mcp +- OpenAPI spec: ${base}/openapi.json + +## Try the API as a guest + +The hosted API is ${API_URL}. A guest session needs no wallet and is deleted after 7 days. + +\`\`\`sh +B=${API_URL} +curl -s -c jar -X POST $B/v1/auth/demo -H 'content-type: application/json' -d '{}' +curl -s -b jar $B/v1/templates +curl -s -b jar -X POST $B/v1/minds -H 'content-type: application/json' -d '{"templateId":"payments-mind","name":"Penny"}' +\`\`\` + +Chat replies stream as server-sent events (${base}/events). Errors are \`{ error, ...details }\` (${base}/errors). + +## Rules to respect + +- Never say a refused payment was "rejected on-chain" and never show a transaction link for one: OutLayer refuses it before signing, so no transaction exists. +- Cross-chain payments and Agent Market hiring are quotes only on testnet; nothing is sent. +- A person tries the web app at ${APP_URL} with *Continue as guest*. +` +} diff --git a/apps/docs/proxy.ts b/apps/docs/proxy.ts new file mode 100644 index 00000000..e52dfdde --- /dev/null +++ b/apps/docs/proxy.ts @@ -0,0 +1,42 @@ +import { NextResponse, type NextRequest } from "next/server"; + +const TRUST_SECTIONS = new Set(["", "resources", "subprocessors", "faq", "updates"]); + +/** Whether the client prefers Markdown over HTML (Accept lists text/markdown, and before text/html if both). */ +export function wantsMarkdown(accept: string | null): boolean { + if (!accept) return false; + const a = accept.toLowerCase(); + const md = a.indexOf("text/markdown"); + if (md < 0) return false; + const html = a.indexOf("text/html"); + return html < 0 || md < html; +} + +/** Where a request should be served from, or null to serve it as is. */ +export function rewriteTarget(host: string, path: string, accept: string | null): string | null { + let p = path.replace(/\/+$/, "") || "/"; + // trust.hellonear.xyz/faq is /trust/faq. + if (host.startsWith("trust.")) { + const rest = p.replace(/^\//, "").replace(/\.md$/, ""); + if (TRUST_SECTIONS.has(rest)) p = (rest ? `/trust/${rest}` : "/trust") + (path.endsWith(".md") ? ".md" : ""); + } + if (p.endsWith(".md") && p !== "/skill.md") { + const slug = p.slice(0, -3).replace(/^\/(index)?$/, "/"); + return `/md${slug === "/" ? "" : slug}`; + } + if (wantsMarkdown(accept) && !p.includes(".") && !p.startsWith("/md") && p !== "/mcp") return `/md${p === "/" ? "" : p}`; + return p !== (path.replace(/\/+$/, "") || "/") ? p : null; +} + +export function proxy(request: NextRequest) { + const host = request.headers.get("x-forwarded-host") ?? request.headers.get("host") ?? ""; + const target = rewriteTarget(host, request.nextUrl.pathname, request.headers.get("accept")); + if (!target) return NextResponse.next(); + const url = request.nextUrl.clone(); + url.pathname = target; + return NextResponse.rewrite(url); +} + +export const config = { + matcher: ["/((?!_next/|api/|icon.svg|favicon.ico|apple-icon.png|openapi.json|llms|\\.well-known/).*)"], +}; From d0d525c0c4efcdd8d343c0e938f59cef4bfab68b Mon Sep 17 00:00:00 2001 From: Lexirieru Date: Fri, 13 Nov 2026 04:37:32 +0700 Subject: [PATCH 6/9] test(docs): content, nav, links, llms, search, markdown, proxy and MCP bun run test: 16 tests, 16 pass. bun run typecheck: clean. bun run build: 77 static pages, /mcp dynamic. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e --- apps/docs/tests/content.test.ts | 98 +++++++++++++++++++++++++++++++++ apps/docs/tests/mcp.test.ts | 48 ++++++++++++++++ 2 files changed, 146 insertions(+) create mode 100644 apps/docs/tests/content.test.ts create mode 100644 apps/docs/tests/mcp.test.ts diff --git a/apps/docs/tests/content.test.ts b/apps/docs/tests/content.test.ts new file mode 100644 index 00000000..ef49af0e --- /dev/null +++ b/apps/docs/tests/content.test.ts @@ -0,0 +1,98 @@ +import assert from 'node:assert/strict' +import { test } from 'node:test' +import { getPage, llmsFullTxt, llmsTxt, normalize, pageMarkdown, pages, search, sections, slugify } from '../lib/content' +import { render, renderMatrix } from '../lib/markdown' +import { NAV, TRUST_TABS } from '../lib/nav' +import { rewriteTarget, wantsMarkdown } from '../proxy' + +test('every content page is in the nav or the trust tabs exactly once', () => { + const listed = [...NAV.flatMap((s) => s.slugs), ...TRUST_TABS.map((t) => t.slug)] + assert.equal(new Set(listed).size, listed.length, 'a slug is listed twice') + assert.deepEqual([...listed].sort(), pages.map((p) => p.slug).sort()) +}) + +test('pages load with title, description and body, and no en or em dashes', () => { + assert.ok(pages.length >= 30) + for (const p of pages) { + assert.ok(p.title && p.description && p.markdown.trim(), p.slug) + assert.doesNotMatch(p.markdown + p.title + p.description, /[–—]/, p.slug) + assert.doesNotMatch(p.markdown, / { + assert.equal(normalize('/quickstart.md'), 'quickstart') + assert.equal(normalize('https://docs.hellonear.xyz/trust/faq#security'), 'trust/faq') + assert.equal(normalize('/index.md'), '') + assert.equal(getPage('/')?.title, 'Introduction') + assert.equal(getPage('trust/subprocessors/')?.title, 'Subprocessors') + assert.equal(getPage('nope'), undefined) +}) + +test('internal links point at pages that exist', () => { + for (const p of pages) { + for (const [, href] of p.markdown.matchAll(/\]\((\/[^)#\s]*)/g)) { + if (href === '/openapi.json' || href === '/llms.txt' || href === '/llms-full.txt' || href === '/skill.md' || href === '/mcp') continue + assert.ok(getPage(href), `${p.slug || 'index'} links to missing ${href}`) + } + } +}) + +test('llms.txt lists every page as a .md link; llms-full.txt has every page', () => { + const txt = llmsTxt('https://x.test') + assert.match(txt, /^# HelloNear\n\n> /) + for (const p of pages) assert.ok(txt.includes(`https://x.test${p.slug ? `/${p.slug}.md` : '/index.md'}`), p.slug) + const full = llmsFullTxt('https://x.test') + for (const p of pages) assert.ok(full.includes(`# ${p.title}\n`), p.slug) + assert.ok(pageMarkdown(getPage('quickstart')!).startsWith('# Quickstart\n\n> ')) +}) + +test('search ranks the page about the words first', () => { + assert.equal(search('daily limit freeze')[0]?.slug, 'wallet-and-approvals') + assert.equal(search('subprocessors')[0]?.slug, 'trust/subprocessors') + assert.equal(search('swarm auction clearing price')[0]?.slug, 'swarm-auction') + assert.equal(search('run.verified')[0] !== undefined, true) + assert.deepEqual(search(' '), []) + assert.deepEqual(search('zzzqqq'), []) + assert.equal(search('near', 3).length, 3) + const hit = search('relayer')[0] + assert.ok(hit.url.startsWith('https://docs.hellonear.xyz/') && hit.snippet.length > 0 && hit.snippet.length <= 240) +}) + +test('headings get GitHub-style ids so README anchors keep working', () => { + assert.equal(slugify('The swarm auction: one real round on testnet'), 'the-swarm-auction-one-real-round-on-testnet') + assert.equal(slugify("The registry contract's source is verified"), 'the-registry-contracts-source-is-verified') + assert.match(render('## Hello, world'), /

/) + assert.match(render('| a |\n|---|\n| b |'), /
/) +}) + +test('sections splits at one heading level and ignores code fences', () => { + const s = sections('intro\n\n## A\none\n```\n## not a heading\n```\n## B\ntwo', 2) + assert.equal(s.intro, 'intro') + assert.deepEqual(s.items.map((i) => i.title), ['A', 'B']) + assert.match(s.items[0].body, /not a heading/) +}) + +test('the trust matrix renders Yes as a linked check and N/A dimmed', () => { + const html = renderMatrix('| Scope | X | Y |\n|---|---|---|\n| Chat | [Yes](https://e.test) | N/A |') + assert.match(html, /class="cell-yes">]*class="check"/) + assert.match(html, /class="cell-na">N\/A { + assert.equal(rewriteTarget('docs.hellonear.xyz', '/quickstart.md', null), '/md/quickstart') + assert.equal(rewriteTarget('docs.hellonear.xyz', '/index.md', null), '/md') + assert.equal(rewriteTarget('docs.hellonear.xyz', '/trust/faq.md', null), '/md/trust/faq') + assert.equal(rewriteTarget('docs.hellonear.xyz', '/skill.md', null), null) + assert.equal(rewriteTarget('docs.hellonear.xyz', '/quickstart', 'text/markdown'), '/md/quickstart') + assert.equal(rewriteTarget('docs.hellonear.xyz', '/', 'text/markdown, text/html;q=0.5'), '/md') + assert.equal(rewriteTarget('docs.hellonear.xyz', '/quickstart', 'text/html,application/xhtml+xml'), null) + assert.equal(rewriteTarget('trust.hellonear.xyz', '/', null), '/trust') + assert.equal(rewriteTarget('trust.hellonear.xyz', '/faq', null), '/trust/faq') + assert.equal(rewriteTarget('trust.hellonear.xyz', '/faq.md', null), '/md/trust/faq') + assert.equal(rewriteTarget('trust.hellonear.xyz', '/trust/faq', null), null) + assert.equal(rewriteTarget('trust.hellonear.xyz', '/quickstart', null), null) + assert.equal(wantsMarkdown('text/html, text/markdown'), false) +}) diff --git a/apps/docs/tests/mcp.test.ts b/apps/docs/tests/mcp.test.ts new file mode 100644 index 00000000..52b42183 --- /dev/null +++ b/apps/docs/tests/mcp.test.ts @@ -0,0 +1,48 @@ +import assert from 'node:assert/strict' +import { test } from 'node:test' +import { handle, PROTOCOL_VERSIONS, type Reply } from '../lib/mcp' + +const call = (method: string, params?: object, id: number | string = 1) => handle({ jsonrpc: '2.0', id, method, params }) as Reply +const result = (r: Reply) => r.result as { content: { type: string; text: string }[]; isError?: boolean; structuredContent?: { results: { path: string }[] } } + +test('initialize answers the asked protocol version when known, else the newest', () => { + const r = call('initialize', { protocolVersion: '2025-03-26', capabilities: {}, clientInfo: { name: 't', version: '1' } }) + assert.deepEqual((r.result as { protocolVersion: string }).protocolVersion, '2025-03-26') + assert.deepEqual((r.result as { capabilities: object }).capabilities, { tools: { listChanged: false } }) + assert.equal((call('initialize', { protocolVersion: '1999-01-01' }).result as { protocolVersion: string }).protocolVersion, PROTOCOL_VERSIONS[0]) +}) + +test('notifications get no answer; ping answers {}', () => { + assert.equal(handle({ jsonrpc: '2.0', method: 'notifications/initialized' }), null) + assert.deepEqual(call('ping', undefined, 'a'), { jsonrpc: '2.0', id: 'a', result: {} }) +}) + +test('tools/list offers search_docs and read_page, both read-only', () => { + const tools = (call('tools/list').result as { tools: { name: string; annotations: { readOnlyHint: boolean } }[] }).tools + assert.deepEqual(tools.map((t) => t.name), ['search_docs', 'read_page']) + assert.ok(tools.every((t) => t.annotations.readOnlyHint)) +}) + +test('search_docs returns ranked pages as text and structured content', () => { + const r = result(call('tools/call', { name: 'search_docs', arguments: { query: 'payments csv', limit: 2 } })) + assert.equal(r.structuredContent!.results.length, 2) + assert.equal(r.structuredContent!.results[0].path, '/payments-csv') + assert.match(r.content[0].text, /^1\. Payments CSV\n/) + assert.match(result(call('tools/call', { name: 'search_docs', arguments: { query: 'zzzqqq' } })).content[0].text, /No pages match/) +}) + +test('read_page returns the page as Markdown, or an error result for an unknown path', () => { + const r = result(call('tools/call', { name: 'read_page', arguments: { path: '/trust/faq' } })) + assert.match(r.content[0].text, /^# FAQ\n\n> /) + assert.match(r.content[0].text, /Source: https:\/\/docs\.hellonear\.xyz\/trust\/faq/) + const miss = result(call('tools/call', { name: 'read_page', arguments: { path: '/nope' } })) + assert.equal(miss.isError, true) +}) + +test('bad requests get JSON-RPC errors', () => { + assert.equal(call('tools/call', { name: 'search_docs', arguments: {} }).error?.code, -32602) + assert.equal(call('tools/call', { name: 'delete_everything', arguments: {} }).error?.code, -32602) + assert.equal(call('resources/list').error?.code, -32601) + assert.equal(handle([{ jsonrpc: '2.0', id: 1, method: 'ping' }])?.error?.code, -32600) + assert.equal(handle({ id: 1, method: 'ping' })?.error?.code, -32600) +}) From 62e1b9089bf52754fbee83db3b42d56991ab561c Mon Sep 17 00:00:00 2001 From: Lexirieru Date: Fri, 13 Nov 2026 04:37:32 +0700 Subject: [PATCH 7/9] docs: CI and CLAUDE.md for apps/docs docs.yml runs typecheck, tests and next build on Bun 1.3.9 and Node 24.22.1, like status.yml, also when docs/openapi.json changes. Root CLAUDE.md gets the layout and CI rows. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e --- .github/workflows/docs.yml | 38 ++++++++++++++++++++++++++++++++++++++ CLAUDE.md | 2 ++ apps/docs/CLAUDE.md | 37 +++++++++++++++++++++++++++++++++++++ 3 files changed, 77 insertions(+) create mode 100644 .github/workflows/docs.yml create mode 100644 apps/docs/CLAUDE.md diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml new file mode 100644 index 00000000..238418ef --- /dev/null +++ b/.github/workflows/docs.yml @@ -0,0 +1,38 @@ +# Docs and Trust Center CI: typecheck, unit tests (content, llms, search, MCP, proxy) and a production build. No secrets. +name: docs + +on: + pull_request: + paths: ['apps/docs/**', 'docs/openapi.json', '.github/workflows/docs.yml'] + push: + branches: [main] + paths: ['apps/docs/**', 'docs/openapi.json', '.github/workflows/docs.yml'] + +concurrency: + group: docs-${{ github.ref }} + cancel-in-progress: true + +permissions: + contents: read + +jobs: + build: + runs-on: ubuntu-latest + timeout-minutes: 15 + defaults: + run: + working-directory: apps/docs + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: 24.22.1 + - uses: oven-sh/setup-bun@v2 + with: + bun-version: 1.3.9 + - run: bun install --frozen-lockfile + - run: bun run typecheck + - run: bun run test + - run: bun run build + env: + NEXT_TELEMETRY_DISABLED: '1' diff --git a/CLAUDE.md b/CLAUDE.md index 2ce82901..edcf00fe 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -46,6 +46,7 @@ HelloNear is an AI agent persona platform on NEAR, built for NEAR HACKATHON (1 | `apps/be` | Backend API, Postgres + pgvector, NEP-413 login, OutLayer + Composio | James | | `engine` | AI engine (Mastra + NEAR AI Cloud) | Axel | | `sc` | Mind registry contract (Rust `near-sdk`) | Axel | +| `apps/docs` | Docs site (docs.hellonear.xyz) and Trust Center (trust.hellonear.xyz), with llms.txt, Markdown export and an MCP server; Vercel | Axel | | `docs` | Shared technical docs, incl. `api-contract.md` | James + Axel | | `design` | Design tokens, screens, Mind characters (`hellonear.pen`, pen.dev) | Nabil | | `deploy` | Hosted demo: systemd units + `deploy.sh` for one Proxmox LXC, and the automatic deploy after a merge (`deploy/autodeploy/`) (#22) | James | @@ -72,6 +73,7 @@ Each folder has its own workflow in `.github/workflows/`. It runs on pull reques | `fe` | `apps/fe` | lint, typecheck, `next build` | | `sc` | `sc` | unit tests, sandbox tests (incl. upgrades from the fixtures), clippy | | `landing` | `apps/landing` | typecheck, `next build` | +| `docs` | `apps/docs` (and `docs/openapi.json`) | typecheck, unit tests, `next build` | | `status` | `apps/status` | typecheck, unit tests, `next build` | CI does not replace the local integration and load tests required by the rules below. Nothing deploys from CI itself. A merged `main` is deployed to the hosted demo after its CI passes, by a poller on James's always-on LAN machine that comments the result on the merged PR (rule 3, `deploy/README.md`). diff --git a/apps/docs/CLAUDE.md b/apps/docs/CLAUDE.md new file mode 100644 index 00000000..0a27d4e9 --- /dev/null +++ b/apps/docs/CLAUDE.md @@ -0,0 +1,37 @@ +# CLAUDE.md — apps/docs + +The docs site, **docs.hellonear.xyz**, and the Trust Center, **trust.hellonear.xyz**: one Next.js app, one Vercel project (`hellonear-docs`). Built 13 Nov 2026. Owner: Axel. Root rules in `/CLAUDE.md` also apply. + +**Update this file in the same PR whenever you change setup, commands, routes, content rules or where it is deployed.** + +## How it works + +- **One source:** every page is a Markdown file in `content/` (frontmatter `title`, `description`). `scripts/build-content.mjs` turns them into `lib/generated/pages.json` (gitignored; runs before `dev`, `build`, `typecheck` and `test`) and copies `../../docs/openapi.json` to `public/openapi.json` (gitignored). The HTML pages, the `.md` export, `/llms.txt`, `/llms-full.txt` and the MCP tools all read that JSON, so nothing reads files at request time. The build fails on an en or em dash. +- **Content is true to the repo.** Most pages were sliced from `README.md` and `docs/api-contract.md` §3 on 13 Nov (README images stripped, relative links pointed at GitHub); they do not update by themselves, so change the page when the README section changes. Never invent features, numbers or claims; link proof (tx, report, file) where you can. +- **Sidebar order** is `lib/nav.ts`. A test fails if a page in `content/` is missing from it or listed twice; the trust pages are the `TRUST_TABS`. +- **Routes:** `app/(docs)/[[...slug]]` (docs pages; `api-reference` adds Swagger UI from `/openapi.json`, client-only), `app/trust` (Trust Center: Overview, `resources`, `subprocessors`, `faq`, `updates`, each built from its Markdown by heading: `###` sections become cards, FAQ `##` categories and `###` questions become `
`), `app/md/[[...slug]]` (Markdown), `app/llms.txt`, `app/llms-full.txt`, `app/skill.md` (`lib/skill.ts`, an Agent Skill), `app/mcp` and `app/.well-known/mcp`. +- **`proxy.ts`** (Next 16's middleware): `/.md` and requests that prefer `Accept: text/markdown` are served from `/md/`; on a `trust.*` host, `/`, `/resources`, `/subprocessors`, `/faq` and `/updates` are served from `/trust/...`. `next.config.ts` adds `Link: ; rel="llms-txt"` to every response. +- **MCP** (`lib/mcp.ts`): stateless Streamable HTTP, one JSON-RPC message per POST, JSON answers, no sessions. `initialize`, `ping`, `tools/list`, `tools/call` with `search_docs` (`search()` in `lib/content.ts`: keyword scoring, title > description > body) and `read_page`. Read-only, CORS `*`; GET answers 405. +- **Trust Center rules (Axel, 13 Nov):** no compliance badges or certifications (HelloNear has none), no "audit" as a claim, no team members' names, no emoji. Every "Yes" in the scope table links to its proof; "N/A" where a control does not apply. Updates only for what git log or the README proves. +- Styles: plain CSS (`app/globals.css`) with the web app's Stone & Lime tokens, light and dark by `prefers-color-scheme`. Sidebar on desktop, a `
` menu on phones (no JavaScript needed), 16px gutters, no horizontal scroll (checked at 390 px). + +## Commands + +```sh +bun install +bun run dev # http://localhost:3300 +bun run typecheck +bun run test # node:test: content, nav, links, llms, search, markdown, proxy, MCP +bun run build +``` + +Try the MCP server locally: + +```sh +curl -s localhost:3300/mcp -H 'content-type: application/json' \ + -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_docs","arguments":{"query":"daily limit"}}}' +``` + +## Deploy + +Not deployed yet. Plan: **Vercel**, by Axel with the Vercel CLI from this folder (`vercel` then `vercel --prod`), project `hellonear-docs`, root directory `apps/docs`. Then two domains on that project, `docs.hellonear.xyz` and `trust.hellonear.xyz`, each a `CNAME → cname.vercel-dns.com` in the `hellonear.xyz` Cloudflare zone (DNS only, not proxied). The DNS change is on the box owner's side (James), with Axel's approval. No env vars. From a6f4d1a6887721bb57ac6d0e689dd494324726be Mon Sep 17 00:00:00 2001 From: Lexirieru Date: Fri, 13 Nov 2026 04:41:09 +0700 Subject: [PATCH 8/9] fix(docs): Swagger UI from swagger-ui-dist, so opened operations load swagger-ui-react bundled by Turbopack threw "OpenApi3_1Element.refract is not a function" in resolveSubtree, and every operation opened on /api-reference spun forever (seen in Chrome on localhost:3300). The page now loads swagger-ui-dist 5.34.0's prebuilt bundle from /swagger, copied there by the content script, with next/script. Tests: bun run typecheck ok; bun run test 16 pass, 0 fail; bun run build ok. Chrome: GET /v1/minds/{mindId} opens with its parameters, no console errors. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01Q5ZrzK8une3S2YyhDG746e --- apps/docs/.gitignore | 1 + apps/docs/CLAUDE.md | 4 +- apps/docs/app/_components/Swagger.tsx | 32 ++- apps/docs/bun.lock | 395 +------------------------- apps/docs/next-env.d.ts | 4 +- apps/docs/package.json | 3 +- apps/docs/scripts/build-content.mjs | 8 +- 7 files changed, 42 insertions(+), 405 deletions(-) diff --git a/apps/docs/.gitignore b/apps/docs/.gitignore index 96538e7a..ecf83ecc 100644 --- a/apps/docs/.gitignore +++ b/apps/docs/.gitignore @@ -3,3 +3,4 @@ tsconfig.tsbuildinfo .env* lib/generated/ public/openapi.json +public/swagger/ diff --git a/apps/docs/CLAUDE.md b/apps/docs/CLAUDE.md index 0a27d4e9..c7c4cc2f 100644 --- a/apps/docs/CLAUDE.md +++ b/apps/docs/CLAUDE.md @@ -6,10 +6,10 @@ The docs site, **docs.hellonear.xyz**, and the Trust Center, **trust.hellonear.x ## How it works -- **One source:** every page is a Markdown file in `content/` (frontmatter `title`, `description`). `scripts/build-content.mjs` turns them into `lib/generated/pages.json` (gitignored; runs before `dev`, `build`, `typecheck` and `test`) and copies `../../docs/openapi.json` to `public/openapi.json` (gitignored). The HTML pages, the `.md` export, `/llms.txt`, `/llms-full.txt` and the MCP tools all read that JSON, so nothing reads files at request time. The build fails on an en or em dash. +- **One source:** every page is a Markdown file in `content/` (frontmatter `title`, `description`). `scripts/build-content.mjs` turns them into `lib/generated/pages.json` (gitignored; runs before `dev`, `build`, `typecheck` and `test`) and copies `../../docs/openapi.json` to `public/openapi.json` and Swagger UI to `public/swagger/` (both gitignored). The HTML pages, the `.md` export, `/llms.txt`, `/llms-full.txt` and the MCP tools all read that JSON, so nothing reads files at request time. The build fails on an en or em dash. - **Content is true to the repo.** Most pages were sliced from `README.md` and `docs/api-contract.md` §3 on 13 Nov (README images stripped, relative links pointed at GitHub); they do not update by themselves, so change the page when the README section changes. Never invent features, numbers or claims; link proof (tx, report, file) where you can. - **Sidebar order** is `lib/nav.ts`. A test fails if a page in `content/` is missing from it or listed twice; the trust pages are the `TRUST_TABS`. -- **Routes:** `app/(docs)/[[...slug]]` (docs pages; `api-reference` adds Swagger UI from `/openapi.json`, client-only), `app/trust` (Trust Center: Overview, `resources`, `subprocessors`, `faq`, `updates`, each built from its Markdown by heading: `###` sections become cards, FAQ `##` categories and `###` questions become `
`), `app/md/[[...slug]]` (Markdown), `app/llms.txt`, `app/llms-full.txt`, `app/skill.md` (`lib/skill.ts`, an Agent Skill), `app/mcp` and `app/.well-known/mcp`. +- **Routes:** `app/(docs)/[[...slug]]` (docs pages; `api-reference` adds Swagger UI from `/openapi.json`, client-only: `swagger-ui-dist`'s prebuilt bundle copied to `public/swagger/` by the content script and loaded with `next/script`, because swagger-ui-react bundled by Turbopack throws `OpenApi3_1Element.refract is not a function` and an opened operation never loads), `app/trust` (Trust Center: Overview, `resources`, `subprocessors`, `faq`, `updates`, each built from its Markdown by heading: `###` sections become cards, FAQ `##` categories and `###` questions become `
`), `app/md/[[...slug]]` (Markdown), `app/llms.txt`, `app/llms-full.txt`, `app/skill.md` (`lib/skill.ts`, an Agent Skill), `app/mcp` and `app/.well-known/mcp`. - **`proxy.ts`** (Next 16's middleware): `/.md` and requests that prefer `Accept: text/markdown` are served from `/md/`; on a `trust.*` host, `/`, `/resources`, `/subprocessors`, `/faq` and `/updates` are served from `/trust/...`. `next.config.ts` adds `Link: ; rel="llms-txt"` to every response. - **MCP** (`lib/mcp.ts`): stateless Streamable HTTP, one JSON-RPC message per POST, JSON answers, no sessions. `initialize`, `ping`, `tools/list`, `tools/call` with `search_docs` (`search()` in `lib/content.ts`: keyword scoring, title > description > body) and `read_page`. Read-only, CORS `*`; GET answers 405. - **Trust Center rules (Axel, 13 Nov):** no compliance badges or certifications (HelloNear has none), no "audit" as a claim, no team members' names, no emoji. Every "Yes" in the scope table links to its proof; "N/A" where a control does not apply. Updates only for what git log or the README proves. diff --git a/apps/docs/app/_components/Swagger.tsx b/apps/docs/app/_components/Swagger.tsx index 3fa170b4..4d54f87f 100644 --- a/apps/docs/app/_components/Swagger.tsx +++ b/apps/docs/app/_components/Swagger.tsx @@ -1,15 +1,37 @@ "use client"; -import dynamic from "next/dynamic"; -import "swagger-ui-react/swagger-ui.css"; +import Script from "next/script"; +import { useEffect, useRef, useState } from "react"; -// Swagger UI only runs in the browser; the prose above it is server-rendered and readable without JavaScript. -const SwaggerUI = dynamic(() => import("swagger-ui-react"), { ssr: false, loading: () =>

Loading the API reference…

}); +type SwaggerBundle = (options: Record) => unknown; +declare global { + interface Window { + SwaggerUIBundle?: SwaggerBundle; + } +} +// Swagger UI only runs in the browser; the prose above it is server-rendered and readable without JavaScript. +// It loads swagger-ui-dist's prebuilt bundle from /swagger (copied by scripts/build-content.mjs), not through the +// bundler: Turbopack breaks swagger-ui-react's OpenAPI resolver, so an opened operation never finished loading. export function Swagger({ url }: { url: string }) { + const node = useRef(null); + const [ready, setReady] = useState(false); + + useEffect(() => { + if (window.SwaggerUIBundle) setReady(true); + }, []); + + useEffect(() => { + if (!ready || !node.current || !window.SwaggerUIBundle) return; + window.SwaggerUIBundle({ url, domNode: node.current, docExpansion: "list", defaultModelsExpandDepth: 0, tryItOutEnabled: false }); + }, [ready, url]); + return (
- + +