openvibers/openvibe.surf Commits

/.well-known/agent.json: what this site serves, for agents (SEO-2) (#70)

OP OpenVibers committed 10 days ago · 497650b05e · 3 files, +36 −0

It answered 404. The shared agent layer serves server/agent-descriptor.js: the site's
purpose (its llms.txt summary), its API, docs and MCP where it has them, and its auth.

Changes

ddiff --git a/server/agent-descriptor.js b/server/agent-descriptor.js
nnew file mode 100644
iindex 0000000..723fe89
---- /dev/null
++++ b/server/agent-descriptor.js
@@@ -0,0 +1,15 @@
++'use strict';
++// What OpenVibe.Surf tells an agent about itself (openvibe-shared/agent-layer): /.well-known/agent.json (SEO-2).
++// Every field is something this site really serves; the purpose is its own llms.txt summary.
++module.exports = {
++ id: "surf",
++ name: "OpenVibe.Surf",
++ purpose: "Ride CS-style surf maps in the browser, surf live streams, clips and AI moments, and let an agent surf the web for you with its sources cited.",
++ home: "https://openvibe.surf",
++ site: "openvibe.surf",
++ api: "/api/v1",
++ docs: "/developers",
++ policy: {
++ auth: ["none"],
++ },
++};
ddiff --git a/server/app.js b/server/app.js
iindex d930589..5fbbc68 100644
---- a/server/app.js
++++ b/server/app.js
@@@ -71,6 +71,8 @@ function createApp(opts = {}) {
views.configure({ baseUrl: config.baseUrl });
const app = express();
++ // /.well-known/agent.json (openvibe-shared/agent-layer, SEO-2): what this site serves, for agents.
++ require('openvibe-shared/agent-layer').mount(app, { descriptor: require('./agent-descriptor') });
app.disable('x-powered-by');
app.set('trust proxy', config.trustProxy);
app.locals.ctx = ctx;
ddiff --git a/test/agent-json.test.js b/test/agent-json.test.js
nnew file mode 100644
iindex 0000000..c4e925d
---- /dev/null
++++ b/test/agent-json.test.js
@@@ -0,0 +1,19 @@
++'use strict';
++// SEO-2: /.well-known/agent.json answered 404 here (11-03 check of all 55 sites). The shared agent layer serves this
++// site's descriptor; every field is something it really serves.
++const assert = require('assert');
++const fs = require('fs');
++const path = require('path');
++const descriptor = require('../server/agent-descriptor');
++const { agentManifest } = require('openvibe-shared/agent-layer');
++
++const m = agentManifest(descriptor);
++assert.strictEqual(m.network, 'OpenVibe');
++assert.strictEqual(m.home, 'https://openvibe.surf');
++assert.ok(m.purpose && m.purpose.length > 40, 'a purpose');
++assert.ok(/^https:\/\//.test(m.api), 'its API, absolute');
++assert.strictEqual(m.llms, 'https://openvibe.surf/llms.txt');
++assert.ok(Array.isArray(m.policy.auth) && m.policy.auth.length, 'how it is called');
++const app = fs.readFileSync(path.join(__dirname, '..', 'server', 'app.js'), 'utf8');
++assert.match(app, /require\('openvibe-shared\/agent-layer'\)\.mount\(app, \{ descriptor: require\('\.\/agent-descriptor'\) \}\);/);
++console.log('agent.json: ok');