v0.1.0 · Apache 2.0 · published

Open-source KYE Protocol™.

Integrate shadow-mode observation into your AI-agent runtime in five minutes. The open-source path covers the SDKs (TypeScript + Python), the Conformance Pack verifier, and the schema contracts — everything you need to run KYE locally. The hosted operational engines (Authority Gap detection, Guard Recommendation, drift detection) stay paid.

4 packages Apache 2.0 license 0 required cloud calls (local mode)

Quick paths

5 minutes

Getting started

Install @kye/shadow-mode-sdk, register an observed action, generate an Evidence Pack, verify it offline.

Step-by-step →

browse

Packages

SDKs (TS, Python), the Conformance Pack verifier CLI, the schema set, the widget protocol.

List →

community

Contributing

Code of conduct, governance, how to file an issue or open a PR.

Read →

In 30 seconds

TypeScript · Node 20+bash + ts

npm install @kye/shadow-mode-sdk

import { ObservedActionBuilder, KyeClient } from "@kye/shadow-mode-sdk";

const client = new KyeClient({
  gatewayUrl: process.env.KYE_GATEWAY_URL,
  tenant:     process.env.KYE_TENANT,
  apiKey:     process.env.KYE_API_KEY,
});

const action = new ObservedActionBuilder()
  .actor("kye:agent:acme.ap_processor_007")
  .principal("kye:user:acme.cfo.j_okonkwo")
  .action("payment.propose")
  .target("VND-217:£4,820.00")
  .context({ amount_gbp: 4820, vendor_id: "VND-217" })
  .build();

const decision = await client.ingest(action);
console.log(decision.decision, decision.evidence_pack_id);

What's in the box

@kye/shadow-mode-sdk · typescript

Typed builder for kye.evidence.observed_action.v1. HTTP ingest client. Local-only mode for offline development. Tree-shakeable ES modules.

npm install @kye/shadow-mode-sdk

kye-shadow-mode · python 3.11+

Pythonic equivalent. Same builder shape, same ingest semantics, same local-only mode.

pip install kye-shadow-mode

@kye/conformance-pack-verifier · cli

Verify Evidence Packs offline. Validates COSE-Sign1 signatures against the published KYE public-key set. Works without any cloud connection.

npx @kye/conformance-pack-verifier verify pack.cbor

@kye/cli · cli

Full-fat KYE command-line tool. Issue Purpose Permissions, submit decisions, verify Evidence Packs, run conformance pack locally.

npm install -g @kye/cli && kye --help

What's NOT open-source

Per constitution §21.11, the operational engines stay private: Authority Gap detection, Guard Recommendation, the drift detector, and the Conformance Pack signing key. These are why KYE Cloud is worth paying for. Apply for pilot →.