integration.personal-os-authos
Fail-closed AuthOS and Better Auth session bridge for PersonalOS.
@lssm-tech/integration.personal-os-authosbun add @lssm-tech/integration.personal-os-authosManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
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.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
3 declarations
@lssm-tech/integration.authos-better-authworkspace:^
Read the package manual ↗@lssm-tech/lib.authos-specworkspace:^
Read the package manual ↗@lssm-tech/lib.personal-os-specworkspace:^
Read the package manual ↗
Declared capabilities
Fail-closed AuthOS and Better Auth session bridge for PersonalOS.
Scripts
buildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typescleanrimraf dist .turbolint:checknode ../../../scripts/biome.cjs check .lint:fixnode ../../../scripts/biome.cjs check --write .prebuildcontractspec-bun-build prebuildtestbun testtypechecktsgo --noEmit