@governed-ai/padp-runtime

Governed AI decision runtime — the application-neutral core of the Programmable AI Decision Platform (PADP). It provides a deterministic intelligence pipeline, a governance gate that evaluates policy before any skill executes, artifact and decision lifecycle management, and a copilot foundation. It carries no application domain logic and no database driver — a host application supplies both through documented extension seams.

• Deterministic — intelligence output is derived from platform state (KPIs, insights, records). No LLM call is required to operate the core paths.
• Governed — every pipeline request passes through a governance gate (allow / deny / require-approval) before a skill runs.
• Persistence-agnostic — the runtime talks to a RuntimePersistence port; the host injects a concrete adapter (e.g. a Drizzle/Postgres implementation).
• Package-extensible — domain capabilities (entities, KPIs, skills, semantics) are contributed by package plugins registered at bootstrap.

Install

npm install @governed-ai/padp-runtime

Requires Node.js >=22. See docs/INSTALLATION.md.

Quick start

import {
  configureRuntimePersistence,
  pluginRegistry,
  Intelligence,
} from "@governed-ai/padp-runtime";

// 1. Inject a persistence adapter (host-owned).
configureRuntimePersistence(myRuntimePersistenceAdapter);

// 2. Register one or more domain package plugins.
pluginRegistry.register(myDomainPackagePlugin);

// 3. Issue a governed intelligence request through the pipeline.
const pipeline = new Intelligence.IntelligencePipeline(/* ... */);
const result = await pipeline.request({ /* ... */ });

A complete runnable walkthrough is in docs/QUICK_START.md.

Public API surface

The package exposes a single curated entry point — @governed-ai/padp-runtime. Internal modules are not importable from the published package.

| Export | Kind | Purpose | | --- | --- | --- | | configureRuntimePersistence, getRuntimePersistence | function | Persistence injection seam | | RuntimePersistence + port types | type | Contract the host adapter implements | | pluginRegistry | object | Register/resolve domain package plugins | | logger | object | Structured (pino) logger singleton | | Intelligence | namespace | Pipeline, artifact manager, skill registry, registries | | Governance | namespace | Governance gate, policies, certification, adapters | | Copilot | namespace | Copilot service, intent registry, response builder | | Contracts | namespace | Zod/TS contracts (intelligence, packages, shared, openapi) | | ConfigurationDomain | namespace | Entity / KPI / skill domain definition types |

Full enumeration: docs/EXTENSION_GUIDE.md and the repository's docs/PUBLIC_API_INVENTORY.md.

Documentation

• docs/INSTALLATION.md — install, peer requirements, host wiring
• docs/QUICK_START.md — minimal end-to-end embedding
• docs/EXTENSION_GUIDE.md — persistence adapters & package plugins
• docs/VERSIONING_POLICY.md — semver & stability guarantees
• docs/OPERATIONS_GUIDE.md — running, health, governance modes

License

UNLICENSED — distribution is controlled by the platform owner. See docs/VERSIONING_POLICY.md for release governance.