@openagentid/http (TypeScript)

HTTP adapter for the OpenAgent Auth Protocol (OAAP). Middleware, client, and discovery for agent-to-service mutual authentication.

Purpose

HTTP adapter for the OpenAgent Auth Protocol (OAAP). Middleware, client, and discovery for agent-to-service mutual authentication.

Read the protocol adapters guide.

Source contract

Field	Value
Package	`@openagentid/http`
Version	`0.1.1`
Language	TypeScript
Runtime floor	`{'node': '>=20'}`
Manifest	`openagent-sdk/adapters/http/typescript/package.json`
Distribution	Source package; registry publication not verified

Manifest SHA-256: 8ddc0b86ce6740a639ef5e47a27eb98b0cadb31e84f638b90bc183ec75731a5d. The recorded Git revision identifies the containing repository; the manifest and entry-point hashes identify this working-tree snapshot.

Integration

Use the package root above from an authorized source checkout. Preserve sibling dependencies and their version/feature requirements. Install the runtime and compile the selected package before using its generated artifacts. The task guide describes configuration, trust boundaries, and error behavior. Test/conformance and deployment packages are supporting tools, not interchangeable production identity providers.

Declared package subpaths

{
  ".": {
    "types": "./dist/index.d.ts",
    "import": "./dist/index.js",
    "require": "./dist/index.cjs"
  },
  "./client": {
    "types": "./dist/client.d.ts",
    "import": "./dist/client.js",
    "require": "./dist/client.cjs"
  },
  "./middleware": {
    "types": "./dist/middleware.d.ts",
    "import": "./dist/middleware.js",
    "require": "./dist/middleware.cjs"
  },
  "./server": {
    "types": "./dist/server.d.ts",
    "import": "./dist/server.js",
    "require": "./dist/server.cjs"
  },
  "./discovery": {
    "types": "./dist/discovery.d.ts",
    "import": "./dist/discovery.js",
    "require": "./dist/discovery.cjs"
  }
}

Exported entry points

The declarations below are extracted from the named entry files. This is a navigable source reference, not compiler-generated documentation of every transitive module. Feature gates and runtime requirements still apply. Private implementation files are not promoted to public APIs merely because they contain a public declaration.

`openagent-sdk/adapters/http/typescript/src/index.ts`

Source SHA-256: afe27f9a9be6735cacbaac8da89933c85a7a8afa52a16ec3ba631d7e85ad66bc.

export {
  OPENAGENT_AUTH_SCHEME,
  HEADER_OPENAGENT_DID,
  HEADER_OPENAGENT_SESSION,
  CONTENT_TYPE_JSON,
  extractOpenAgentToken,
  buildOpenAgentHeader,
} from './headers.js';
export {
  HttpTransport,
  TransportError,
  CHALLENGE_TYPE,
  canonicalChallengeBytes,
  identityChallengeSchema,
  identityVerifiedSchema,
  type IdentityChallenge,
  type IdentityProof,
  type IdentityVerified,
  type KeyType,
  type TrustTier,
  type HttpTransportConfig,
} from './transport.js';
export {
  type ConformanceLevel,
  type DiscoveryDocument,
  discoveryDocumentSchema,
  WELL_KNOWN_PATH,
  AUTH_ENDPOINT_PATH,
  PROVE_ENDPOINT_PATH,
  fetchDiscovery,
  resolveAuthEndpoint,
  resolveProveEndpoint,
} from './discovery.js';
export {
  DEFAULT_SESSION_TTL_SECS,
  DEFAULT_CHALLENGE_TTL_SECS,
  type ServerConfig,
  type SessionState,
  type StoredSession,
  type SessionStore,
  type VerifySignatureFn,
  type AuthResult,
  InMemorySessionStore,
  CoreAuthError,
  createServerConfig,
  handleDiscovery,
  handleChallenge,
  handleProve,
  authenticateRequest,
} from './server.js';
export {
  type MiddlewareOptions,
  createOpenAgentHandler,
  createOpenAgentMiddleware,
} from './middleware.js';
export {
  type ClientConfig,
  type SignFn,
  HttpAuthClient,
} from './client.js';
export { AuthenticatedSession } from './session.js';
export const VERSION = '0.1.1';

Exported API signatures

Read resolved TypeScript exports and source documentation.