Conductor SDK

@hellmai/lumenflow-conductor-sdk is the typed contract layer for conductor mode. A conductor-mode consumer imports it to read pack events and to call pack tools. The consumer does not import the pack packages directly.

The package is licensed. Access is granted with a licence grant. It is distributed through the private licence registry, not the public npm registry.

What it exports

The package mirrors the pack contracts that conductor mode exposes:

Module	Contracts
Software Delivery	Delivery event kinds and typed events, and the remote-callable tool descriptors.
Agent Runtime	Turn lifecycle events, and the remote-control tool contracts.
Sidekick	Event kinds and payloads for tasks, memory, channels and routines.
Kernel security	Kernel-intrinsic security events.
Campus telemetry	Facility telemetry contracts.
Tenant evidence	Proof-record contracts.
Flexible load	Load-curtailment contracts.
EMIT energy	Energy meter event values, with the joules unit and provenance tuples.
Channel bridge	The channel port: delivery guarantees and backpressure policy values.
Initiative admission	The admission plan schema (initiative-admission-plan/v1), digests and RFC 8785 canonical JSON.

The event shapes are described in Events Contract. Conductor mode is described in Conductor mode.

Example

import type {
  GateStartedEvent,
  SoftwareDeliveryRemoteToolContract,
  TurnStartedEvent,
  AgentRuntimeRemoteControlToolContract,
} from '@hellmai/lumenflow-conductor-sdk';

type ConductorPackEvent = GateStartedEvent | TurnStartedEvent;

type ConductorPackTool = SoftwareDeliveryRemoteToolContract | AgentRuntimeRemoteControlToolContract;

Most exports are types and constants. The initiative admission modules also include parsers and RFC 8785 canonical JSON digests. The package does not run pack behaviour.

Related

• Conductor mode: the surface these contracts describe.
• Control-plane SDK: the state contract the package depends on.
• Events Contract: how pack events are versioned and shaped.