Connectors · For websites
Bring a website into the network
A website becomes a connector with one manifest and one signed call. People then install it in their own agent, the agent acts there for them, and the website tells the agent when something happens. All of it runs through OneLifeVibe.
- DeclareWho you are, the actions an assistant may take, and the triggers you will send.
- Answer toolsOne route,
POST /api/olv/v1/tools/<name>, with the same reply shape on every website. - Send triggersOne signed call per happening. Nothing is stored unless the person installed your connector.
1. Send a trigger
Copy the kit into your site: olv-connect.ts (TypeScript, any Node or edge runtime) or olv-connect.php (PHP). Set OLV_CONNECT_WORLD and OLV_CONNECT_KEY, then after your own write commits:
import { olvEmit } from "@/lib/olv/connect";
olvEmit({
id: `gift:${gift.id}`, // yours, stable: a retry never duplicates
topic: "gift.received", // declared in your manifest
subject: member.olvSub, // the person's OneLifeVibe id
title: "A $25 gift reached your ask", // one human line, no dashes
url: "https://yoursite.com/needs/77", // on your own domain
data: { amount_cents: 2500, currency: "usd" },
actions: [{ label: "See my asks", tool: "yoursite_list_my_needs", arguments: {} }],
});
Only the fields your manifest declares travel, an event for someone with no installation is dropped on arrival, and a hub outage never loses an event when you set OLV_CONNECT_OUTBOX_DIR.
2. Answer a tool
People with an OneLifeVibe sign-in reach you with a five-minute token for your site only. A website with its own accounts links them once with a one-time approval and then receives a 60-second signed assertion (keys at /.well-known/olv-connect-jwks.json). Reply {"ok":true,"result":{...}} or {"ok":false,"error":{"code","message"}}; amounts are integer cents, times ISO 8601 UTC.
3. Publish more triggers yourself
Serve /.well-known/olv-connector.json as {"spec":"olv.connect/1","triggers":[{"topic","title","description","importance","fields"}]}. OneLifeVibe reads it every night, applies the same rules as its own manifests, and a new trigger works with no deploy on our side. You can add triggers, never change ours.
4. Get your keys
Keys are issued by hand while the network is small. Tell us about your website and we will register its connector and send the world key.
The full design, every route and the security rules are in the architecture notes. The catalogue itself is open JSON at /api/connect/v1/connectors.