@lssm/integration.personal-os-authos
v2.0.1
Published
Fail-closed AuthOS and Better Auth session bridge for PersonalOS.
Readme
@lssm/integration.personal-os-authos
AuthOS/Better Auth bridge for PersonalOS. It fixes the supported authentication methods, requires verified email sessions, maps a server-verified session to a one-way pseudonymous personal subject, and reloads full active delegation scopes from a host authority store. Each scope binds its identifier, target subject, exact actor, and allowed command names; bare delegation identifiers are never authoritative.
The host supplies the database adapter, secrets, email delivery callbacks, and delegation repository. Missing, expired, unverified, or malformed sessions fail closed. Browser, mobile, and desktop clients receive no authority from this package; they only present the Better Auth cookie or bearer token.
The bridge binds the Better Auth session userId to the verified user before
issuing the canonical PersonalAuthenticatedSessionV1. It rejects invalid or
future authentication times, expired sessions, malformed opaque identifiers,
provider failures, conflicting delegation duplicates, actor substitutions, and
undeclared delegation fields. Every request re-reads provider session state, so
revocation takes effect without trusting a client cache.
Session and subject identities use domain-separated one-way SHA-256 references; raw provider user IDs, session identifiers, email addresses, and bearer tokens never enter PersonalOS projections, receipts, or telemetry.
