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.

  1. DeclareWho you are, the actions an assistant may take, and the triggers you will send.
  2. Answer toolsOne route, POST /api/olv/v1/tools/<name>, with the same reply shape on every website.
  3. 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.