@sbo3l/perplexity

SBO3L adapter for the Perplexity agent / API surface.

npm i @sbo3l/perplexity @sbo3l/sdk

Wiring

import { SBO3LClient } from "@sbo3l/sdk";
import { sbo3lPerplexityTool, runSbo3lPerplexityToolCall } from "@sbo3l/perplexity";

const sbo3l = new SBO3LClient({ endpoint: "http://localhost:8730" });
const tool = sbo3lPerplexityTool({ client: sbo3l });

// Hand `tool.descriptor` to Perplexity's tool registry.
// Pair each emitted tool call with `runSbo3lPerplexityToolCall`.

Behaviour

• allow → { ok: true, output: PolicyReceipt }
• deny / requires_human → { ok: false, output: { error, deny_code, audit_event_id } }
• transport fail → { ok: false, output: { error: "transport.failed", detail } }

The runner never re-throws — every outcome is a structured envelope so the framework's loop can branch and self-correct.

Tests

npm test         # 11 vitest passing
npm run typecheck
npm run build    # ESM + CJS + d.ts