Pre-alpha design preview • Source-available • Not on npm yet

LexThority is pre-alpha authority seam research.

Agents should be free to operate inside the environment they are given. They also need a concrete way to ask whether an effect is allowed before they mutate something important.

LexThority does not manage identity, credentials, scheduling, or swarms. The current preview explores authority envelopes, effect requests, escalation, and receipts, but the boundary is expected to change.

GitHub preview Stack context

Core contract

ThorityEnvelope
  what this run may attempt

EffectRequest
  what an agent or adapter is about to do

ThorityDecision
  allow | escalate | deny

EffectReceipt
  what was decided and what happened

Why it matters

Capabilities are not authority

AXF may tell an agent how to run a deploy capability. LexThority explores where the authority boundary should sit before a run mutates something important.

Personas are not credentials

LexSona can express posture and caution. LexThority is exploring how that posture relates to concrete effects, envelopes, and receipts.

IAM remains the source of truth

LexThority should not replace OAuth, cloud IAM, GitHub permissions, or enterprise brokers. The research question is how agents should describe and record boundary crossings around those systems.

Stack boundary

LexSona	Posture, duty, default caution, role-like context.
LexThority	Pre-alpha authority boundary research.
AXF	Workspace bearings, capability declarations, and effect hints.
Adapters	Wrappers around tools such as git, gh, cloud CLIs, and orchestrators.
Lex	Receipts, memory, denials, fallbacks, and learned access reality.

Current preview shape

Classify

Classify an attempted command or effect, starting with simple gates like `git push`.

Check

Evaluate a structured effect request against an envelope and return a decision.

Execute dry-run

Wrap an attempted command path and produce receipts without pretending to own the whole runtime.

npm install
npm run build

npm run cli -- classify -- git push origin feature/test
npm run cli -- check examples/effects/git-push.json \
  --envelope examples/envelopes/thority.local.engineer.json
npm run cli -- exec --dry-run \
  --envelope examples/envelopes/thority.local.engineer.json \
  -- git push origin feature/test

Anti-drift rule

If LexThority starts scheduling agents, managing swarms, owning credentials, or modeling every standard operating procedure, it is drifting. The current research target is the boundary around meaningful effects, not the whole runtime.