Ship

Webhooks and events

React to lifecycle changes and operational events in your backend.

Your backend

Server SDK · BeeOSClient

BeeOS Cloud

Agent runtime

harness-sdk.ts

import {
  RuntimeRegistrationCoordinator,
  type RuntimeRegistrationConfig,
  type RuntimeRegistrationTransport,
} from "@beeos-ai/cloud-harness-sdk";

async function startRuntime(
  transport: RuntimeRegistrationTransport,
  config: RuntimeRegistrationConfig,
  onLeaseLost: (reason: "fenced" | "expired" | "heartbeat_failed", cause?: unknown) => void,
) {
  const runtime = new RuntimeRegistrationCoordinator(transport, config, onLeaseLost);
  await runtime.start();
  return runtime;
}

Authorize from the backendIssue App-scoped server credentials and enforce your own user permissions before any request.

Connect the runtimeRegister the runtime, declare the methods it supports and deliver replies to your product.

Receive eventsSubscribe to lifecycle and operational webhooks, then update state in your own store.

Your backend owns end-user identity and ACLs. The frontend renders authorized data fetched through your backend; there is no separate App client SDK.

Documentation

01
Register a backend endpoint
02
Subscribe to relevant lifecycle events
03
Handle the event in your product

A practical use case

Receive an event when an agent task or instance changes state and update your product.

Lifecycle event delivery
Backend-driven reactions
Event-linked operational workflows

Start integrating

Read the integration guide, then connect your runtime and backend.

Documentation