feat(website): publish agent discovery documents for spiceai.org (#2319)
* feat(website): publish agent discovery documents for spiceai.org
Implement the isitagentready.com checks that apply to a static docs site:
- Serve each page as Markdown to requests that prefer text/markdown
(functions/_middleware.js, using the files the llms-txt plugin now writes)
- Send RFC 8288 Link headers on the homepage
- Publish an RFC 9727 API catalog and /openapi.json for the runtime HTTP API
- Publish the spiceai/skills v2.3.2 skills with an Agent Skills Discovery index
- Publish an ARD manifest at /.well-known/ard.json and ai-catalog.json
- Register WebMCP tools (search_docs, get_page_markdown)
- Declare Content Signals in robots.txt
* fix(website): download the agent skills at a pinned commit, not a tag
A tag can be moved to different content, and the index digests describe only the
downloaded bytes. Pin skillsCommit to the v2.3.2 release commit and reject an
archive of any other commit before publishing.
* fix(website): use the standard ARD media types for skills
A single SKILL.md is text/markdown; profile="urn:air:agent-skills" in the ARD
conformance definitions, not application/agent-skills+md. Drop the llms.txt entry,
whose plain text/markdown type ARD reads as a skill missing its profile.
* fix(website): read search result URLs with get_page_markdown on any deployment
search_docs returns canonical https://spiceai.org URLs, which get_page_markdown
rejected on preview and local deployments. Read the same path from the current
deployment instead. Also write the zero-width space regex as \u200b.
* fix(website): serve openapi.json with its OpenAPI media type, skip Functions for favicons
/openapi.json was served as application/json although the API catalog and Link
headers advertise application/vnd.oai.openapi+json. Root favicon requests invoked
the middleware; exclude them in _routes.json.
7 days ago
docs(deployment): document cluster-sidecar architecture from the blog (#2092)
* docs(deployment): add cluster-sidecar architecture header image
Add the application-tier sidecar and distributed cluster diagram to the
Cluster-Sidecar deployment architecture page.
* docs(deployment): pull cluster-sidecar details from the architecture blog
Reference the cluster-sidecar blog post and add the isolation model,
latency tiers, snapshot topology, example Spicepods, and request path
from that write-up.
2 months ago
[Blog] 1.0-stable announcement (#782)
* Initial draft of blog post
* Grammer tweaks and updates
* Additional tweaks
* Tweaks
* Fix twtter
* Improve getting started section to have data-grounded AI quickstart (#779)
* Tweak the getting started section
* Add updated video
* Change to mdx and use ReactPlayer
* Center the player
* Fix link
* Try Open Sans font (#784)
* Fix fetch URL
* Title tweaks
* Add use-case images
* Update NRC image
* Add clippy image
* Add images and quotes
* Tweak
* Remove theme
* Fix player
* Update image
* Add X
* Update quotes and image
* Add quote
* Tweak order
* Add quote
* Fix spelling
* Add profile images
* Add margin
* Fix
* Fix
* Copy tweaks
* Tweak word
* Update Peter photo
* Add OSS image
* Update quote
* Add release
* Tweak Twilio use-case copy.
* Tweak wording
---------
Co-authored-by: Phillip LeBlanc <phillip@spiceai.io>
2 years ago
feat(website): publish agent discovery documents for spiceai.org (#2319)
* feat(website): publish agent discovery documents for spiceai.org
Implement the isitagentready.com checks that apply to a static docs site:
- Serve each page as Markdown to requests that prefer text/markdown
(functions/_middleware.js, using the files the llms-txt plugin now writes)
- Send RFC 8288 Link headers on the homepage
- Publish an RFC 9727 API catalog and /openapi.json for the runtime HTTP API
- Publish the spiceai/skills v2.3.2 skills with an Agent Skills Discovery index
- Publish an ARD manifest at /.well-known/ard.json and ai-catalog.json
- Register WebMCP tools (search_docs, get_page_markdown)
- Declare Content Signals in robots.txt
* fix(website): download the agent skills at a pinned commit, not a tag
A tag can be moved to different content, and the index digests describe only the
downloaded bytes. Pin skillsCommit to the v2.3.2 release commit and reject an
archive of any other commit before publishing.
* fix(website): use the standard ARD media types for skills
A single SKILL.md is text/markdown; profile="urn:air:agent-skills" in the ARD
conformance definitions, not application/agent-skills+md. Drop the llms.txt entry,
whose plain text/markdown type ARD reads as a skill missing its profile.
* fix(website): read search result URLs with get_page_markdown on any deployment
search_docs returns canonical https://spiceai.org URLs, which get_page_markdown
rejected on preview and local deployments. Read the same path from the current
deployment instead. Also write the zero-width space regex as \u200b.
* fix(website): serve openapi.json with its OpenAPI media type, skip Functions for favicons
/openapi.json was served as application/json although the API catalog and Link
headers advertise application/vnd.oai.openapi+json. Root favicon requests invoked
the middleware; exclude them in _routes.json.
7 days ago
feat(website): publish agent discovery documents for spiceai.org (#2319)
* feat(website): publish agent discovery documents for spiceai.org
Implement the isitagentready.com checks that apply to a static docs site:
- Serve each page as Markdown to requests that prefer text/markdown
(functions/_middleware.js, using the files the llms-txt plugin now writes)
- Send RFC 8288 Link headers on the homepage
- Publish an RFC 9727 API catalog and /openapi.json for the runtime HTTP API
- Publish the spiceai/skills v2.3.2 skills with an Agent Skills Discovery index
- Publish an ARD manifest at /.well-known/ard.json and ai-catalog.json
- Register WebMCP tools (search_docs, get_page_markdown)
- Declare Content Signals in robots.txt
* fix(website): download the agent skills at a pinned commit, not a tag
A tag can be moved to different content, and the index digests describe only the
downloaded bytes. Pin skillsCommit to the v2.3.2 release commit and reject an
archive of any other commit before publishing.
* fix(website): use the standard ARD media types for skills
A single SKILL.md is text/markdown; profile="urn:air:agent-skills" in the ARD
conformance definitions, not application/agent-skills+md. Drop the llms.txt entry,
whose plain text/markdown type ARD reads as a skill missing its profile.
* fix(website): read search result URLs with get_page_markdown on any deployment
search_docs returns canonical https://spiceai.org URLs, which get_page_markdown
rejected on preview and local deployments. Read the same path from the current
deployment instead. Also write the zero-width space regex as \u200b.
* fix(website): serve openapi.json with its OpenAPI media type, skip Functions for favicons
/openapi.json was served as application/json although the API catalog and Link
headers advertise application/vnd.oai.openapi+json. Root favicon requests invoked
the middleware; exclude them in _routes.json.
7 days ago
Add blog (#735)
* Add blog
* Update
* Update authors.yml
* Update v1.0-rc.4.md
* Fixes
* Update v0.20-beta.md
* Update v0.19.4-beta.md
* Update v0.17.2-beta.md
* Update v0.17.1-beta.md
* Update v0.17-beta.md
* Update v0.13.3-alpha.md
* Update v0.12.1-alpha.md
* Update v0.10-alpha.md
* Update v0.7-alpha.md
* Update v0.6-alpha.md
* Update v0.5.1-alpha.md
* Update v0.5-alpha.md
* Update v0.4-alpha.md
* Update v0.3-alpha.md
* Update authors, update releases (#736)
* Update authors.yml
* Update v0.19-beta.md
* Update v1.0-rc.2.md
* Add website
* add jeadie author, add to releases
* Fixes
* Update packages
* Fixes for react
* Fixes
* Merge
* Update names
* Use hosted generator
* Tweak
* fix scoped tailwind styles
* Fix images
* use scpoed preflight.css, adjust home page styles
* Update links
* Update inline HTML to Markdown
* add evgenii to authors
* fix expressions
* fix static links
* fix linnks
* fix url docs links
* fix blog links
* prefix docs links with /docs
* fix fonts and tweak styles
* apply fonts
* add sgrebnov to authors
* Fix broken links
---------
Co-authored-by: Phillip LeBlanc <phillip@spiceai.io>
Co-authored-by: peasee <98815791+peasee@users.noreply.github.com>
Co-authored-by: jeadie <jack@spice.ai>
Co-authored-by: Evgenii Khramkov <evgenii@spice.ai>
Co-authored-by: Sergei Grebnov <sergei.grebnov@gmail.com>
2 years ago
feat(website): publish agent discovery documents for spiceai.org (#2319)
* feat(website): publish agent discovery documents for spiceai.org
Implement the isitagentready.com checks that apply to a static docs site:
- Serve each page as Markdown to requests that prefer text/markdown
(functions/_middleware.js, using the files the llms-txt plugin now writes)
- Send RFC 8288 Link headers on the homepage
- Publish an RFC 9727 API catalog and /openapi.json for the runtime HTTP API
- Publish the spiceai/skills v2.3.2 skills with an Agent Skills Discovery index
- Publish an ARD manifest at /.well-known/ard.json and ai-catalog.json
- Register WebMCP tools (search_docs, get_page_markdown)
- Declare Content Signals in robots.txt
* fix(website): download the agent skills at a pinned commit, not a tag
A tag can be moved to different content, and the index digests describe only the
downloaded bytes. Pin skillsCommit to the v2.3.2 release commit and reject an
archive of any other commit before publishing.
* fix(website): use the standard ARD media types for skills
A single SKILL.md is text/markdown; profile="urn:air:agent-skills" in the ARD
conformance definitions, not application/agent-skills+md. Drop the llms.txt entry,
whose plain text/markdown type ARD reads as a skill missing its profile.
* fix(website): read search result URLs with get_page_markdown on any deployment
search_docs returns canonical https://spiceai.org URLs, which get_page_markdown
rejected on preview and local deployments. Read the same path from the current
deployment instead. Also write the zero-width space regex as \u200b.
* fix(website): serve openapi.json with its OpenAPI media type, skip Functions for favicons
/openapi.json was served as application/json although the API catalog and Link
headers advertise application/vnd.oai.openapi+json. Root favicon requests invoked
the middleware; exclude them in _routes.json.
7 days ago