Skip to content

feat: publish custom agent manifest schema#382

Merged
Kinfe123 merged 6 commits into
mainfrom
feat/custom-agent-manifest-schema
Jul 24, 2026
Merged

feat: publish custom agent manifest schema#382
Kinfe123 merged 6 commits into
mainfrom
feat/custom-agent-manifest-schema

Conversation

@Kinfe123

@Kinfe123 Kinfe123 commented Jul 24, 2026

Copy link
Copy Markdown
Member

Summary

  • publish a stable JSON Schema Draft 2020-12 document for the existing Farming Labs /.well-known/agent.json extension
  • identify manifest responses with additive $schema and format fields plus a scoped rel="describedby" HTTP Link across Next.js, TanStack Start, Astro, SvelteKit, and Nuxt
  • preserve all existing manifest fields and routes; keep the opt-in A2A card separate at /.well-known/agent-card.json
  • document the distinction and add runtime, static-export, schema-validation, conformance, and deployed smoke coverage
  • patch the newly disclosed seroval and postcss transitive advisories surfaced by CI

Compatibility

This is additive. The custom manifest remains application/json, existing consumers can continue reading its current fields, and the A2A Agent Card wire format is unchanged.

Verification

  • core suite: 58 files, 976 tests passed
  • Fumadocs focused suite: 67 tests passed
  • agent-surface smoke suite: 14 checks passed
  • typechecks passed for all modified packages and the website
  • GitHub docs review, tests, lint/build, security audit, and package previews passed
  • primary docs-website Vercel preview passed

Baseline check

The secondary farming-labs-docs-docs-cloud Vercel project still reports the same Nuxt acorn-jsx install-cache failure present on main; it is not introduced by this branch.

@vercel

vercel Bot commented Jul 24, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs-website Error Error Jul 24, 2026 10:35pm
farming-labs-docs-docs-cloud Building Building Preview, Comment Jul 24, 2026 10:35pm

Request Review

@pkg-pr-new

pkg-pr-new Bot commented Jul 24, 2026

Copy link
Copy Markdown

Open in StackBlitz

@farming-labs/astro

pnpm add https://pkg.pr.new/farming-labs/docs/@farming-labs/astro@382

@farming-labs/astro-theme

pnpm add https://pkg.pr.new/farming-labs/docs/@farming-labs/astro-theme@382

@farming-labs/docs

pnpm add https://pkg.pr.new/farming-labs/docs/@farming-labs/docs@382

@farming-labs/theme

pnpm add https://pkg.pr.new/farming-labs/docs/@farming-labs/theme@382

@farming-labs/next

pnpm add https://pkg.pr.new/farming-labs/docs/@farming-labs/next@382

@farming-labs/nuxt

pnpm add https://pkg.pr.new/farming-labs/docs/@farming-labs/nuxt@382

@farming-labs/nuxt-theme

pnpm add https://pkg.pr.new/farming-labs/docs/@farming-labs/nuxt-theme@382

@farming-labs/svelte

pnpm add https://pkg.pr.new/farming-labs/docs/@farming-labs/svelte@382

@farming-labs/svelte-theme

pnpm add https://pkg.pr.new/farming-labs/docs/@farming-labs/svelte-theme@382

@farming-labs/tanstack-start

pnpm add https://pkg.pr.new/farming-labs/docs/@farming-labs/tanstack-start@382

commit: b1aa196

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Your trial has ended. Reactivate Greptile to resume code reviews.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue found across 27 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="package.json">

<violation number="1" location="package.json:31">
P2: Filtered package test runs can fail with `MODULE_NOT_FOUND` because `@farming-labs/docs` and `@farming-labs/theme` now import these validators without declaring them. Adding `ajv` and `ajv-formats` to the devDependencies of the packages that own these tests would make their test dependencies explicit.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread packages/docs/src/agent-conformance.ts Outdated
Comment thread packages/docs/src/agent-conformance.ts Outdated
Comment thread scripts/smoke-agent-surfaces.mjs Outdated
Comment thread scripts/smoke-agent-surfaces.mjs Outdated
Comment thread package.json Outdated
"@farming-labs/next": "workspace:*",
"@farming-labs/theme": "workspace:*",
"@tailwindcss/postcss": "^4.1.18",
"ajv": "^8.18.0",

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: Filtered package test runs can fail with MODULE_NOT_FOUND because @farming-labs/docs and @farming-labs/theme now import these validators without declaring them. Adding ajv and ajv-formats to the devDependencies of the packages that own these tests would make their test dependencies explicit.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At package.json, line 31:

<comment>Filtered package test runs can fail with `MODULE_NOT_FOUND` because `@farming-labs/docs` and `@farming-labs/theme` now import these validators without declaring them. Adding `ajv` and `ajv-formats` to the devDependencies of the packages that own these tests would make their test dependencies explicit.</comment>

<file context>
@@ -28,6 +28,8 @@
     "@farming-labs/next": "workspace:*",
     "@farming-labs/theme": "workspace:*",
     "@tailwindcss/postcss": "^4.1.18",
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1",
     "bumpp": "^10.4.1",
</file context>

Comment thread packages/docs/src/agent-manifest-schema.test.ts
Comment thread packages/docs/src/agent-conformance.test.ts Outdated
Comment thread packages/docs/src/agent-manifest-schema.test.ts Outdated
Comment thread packages/docs/src/agent-manifest-schema.test.ts

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue found across 9 files (changes from recent commits).

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="scripts/smoke-agent-surfaces.mjs">

<violation number="1" location="scripts/smoke-agent-surfaces.mjs:318">
P3: `includesLinkRelation` is now dead local code after this switch to `includesTypedLinkRelation`. Removing the obsolete helper avoids maintaining two Link-header matching implementations.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Re-trigger cubic

Comment thread packages/docs/src/agent-manifest-schema.test.ts Outdated
assert(manifest.version === "1", `${route} did not declare agent manifest version 1`);
assert(isNonEmptyString(manifest.name), `${route} did not declare a name`);
assert(
includesTypedLinkRelation(

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P3: includesLinkRelation is now dead local code after this switch to includesTypedLinkRelation. Removing the obsolete helper avoids maintaining two Link-header matching implementations.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At scripts/smoke-agent-surfaces.mjs, line 318:

<comment>`includesLinkRelation` is now dead local code after this switch to `includesTypedLinkRelation`. Removing the obsolete helper avoids maintaining two Link-header matching implementations.</comment>

<file context>
@@ -253,12 +314,14 @@ function validateManifest(json, route, response) {
   assert(
-    /type=(?:"application\/schema\+json"|application\/schema\+json)(?:[,;]|$)/iu.test(link),
-    `${route} omitted the manifest schema media type`,
+    includesTypedLinkRelation(
+      response,
+      AGENT_MANIFEST_SCHEMA,
</file context>

@Kinfe123
Kinfe123 merged commit dc7a3b3 into main Jul 24, 2026
11 of 13 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant