Getting Started

Quickstart

The shape of a DecisionHypervisor integration — install the client, initialize the interception wedge, and evaluate an execution intent. The SDK, endpoints, and keys are issued with private preview access.

DecisionHypervisor is in private preview. The steps below describe the integration surface. The SDK package, preview endpoint, and API key are issued to approved design partners — they are not publicly downloadable yet.

Request Access

Step 1: Receive the SDK

Once your access request is approved you receive private-registry credentials and install the client SDK (Node.js first; Python and Go planned).

# Private registry — credentials issued with preview access
npm install @decisionhypervisor/client

Step 2: Initialize the interception wedge

Instantiate the client server-side using the endpoint and API key issued with your preview access.

import { DHClient } from "@decisionhypervisor/client";

const dh = new DHClient({
  endpoint: process.env.DH_ENDPOINT, // preview endpoint issued on access
  apiKey: process.env.DH_API_KEY
});

Step 3: Evaluate a proposed intent

Submit execution details before any consequential tool call and act only on an explicit AUTHORIZED token. (Illustrative schema — final field names ship with the SDK.)

const decision = await dh.evaluate({
  decision_id: "dec_01J4X7A",
  principal: "org_acme",
  requestor: "agent_refund_v4",
  action: { name: "payments.refund", amount: 24900 },
  target: "txn_stripe_9918"
});

if (decision.resolution === "AUTHORIZED") {
  // Execute only on an authorized token
  await runRefundTransaction(decision.token);
}