Skip to content
ContractSpec
Start here

Package manual · integrations

·Personal workflows, learning and progress

integration.personal-os-authos

Fail-closed AuthOS and Better Auth session bridge for PersonalOS.

integrationsintegrationv2.0.4experimentalservernode
@lssm-tech/integration.personal-os-authos
bun add @lssm-tech/integration.personal-os-authos
Package source ↗Manifest ↗

Manifest 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

THIS PACKAGEintegration.personal-os-authos4 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

3 declarations

Declared capabilities

Integration Personal Os Authos

Fail-closed AuthOS and Better Auth session bridge for PersonalOS.

Scripts

  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • cleanrimraf dist .turbo
  • lint:checknode ../../../scripts/biome.cjs check .
  • lint:fixnode ../../../scripts/biome.cjs check --write .
  • prebuildcontractspec-bun-build prebuild
  • testbun test
  • typechecktsgo --noEmit