AREA GUIDE / 9 PACKAGES

Handlers, runtimes and transports

Connect declared operations to supplied handlers, client state and the transport your application actually runs.

What are you trying to do?

  • What belongs in the portable runtime kernel?
  • Which adapter matches my REST, GraphQL or MCP host?
  • Where are approvals and authenticated context enforced?
FIND YOUR WAY THROUGH THIS AREA

Start with the work you want to do.

Choose a practical step, then inspect a package before opening its full manual.

STEP 01

Choose one vertical slice

Select a query and a command already declared in source. Identify their registry bindings, handler context, adapter entry and consumer call. Start with the smallest actual host composition that exercises these pieces together.

THE PACKAGE LANDSCAPE

9 packages. Choose an entry point.

9 packages · first 6 shownSELECT TO INSPECT

Task guidance and package membership come from this area’s captured source guide.

Start with these packages.

lib.contracts-runtime-kernel

Start with the framework-neutral engine, canonical registries and caller-supplied runtime ports.

Read the package guide →
lib.contracts-runtime-server-rest

Inspect the REST adapter matching your framework and its request/context handling.

Read the package guide →
lib.contracts-runtime-server-mcp

Use the existing contract-to-MCP adapter when exposing a selected operation registry to tools.

Read the package guide →
lib.contracts-runtime-client-react

Locate the React consumer integration for the shared query/cache runtime.

Read the package guide →

Separate reusable runtime from host composition

The runtime kernel owns the shared engine and registry identities while accepting storage, transport, approval, policy and audit responsibilities through supplied ports. Host/environment wiring and concrete providers live above that foundation. Select the server adapter by the application framework and transport, then inspect the client adapter that consumes it. REST, GraphQL and MCP are related projections of selected contracts; registering a contract does not by itself establish an authenticated endpoint or a configured handler.

Follow the request context

The REST README documents createFetchHandler with an asynchronous-capable context factory and an approvalReceipt adapter. Approval evidence is kept outside operation input and is passed to the common handler context. Required approvals are checked before handler invocation by the shared registry. Parameterized REST routes decode path values and make them authoritative over conflicting query/body fields. These details matter when replacing a handwritten endpoint: preserving the public input shape also requires preserving trusted context and precedence rules.

Keep query behavior consistent

REST requests rebuild the canonical QueryEnvelope, including supported search, filter, sort, pagination and consistency metadata. That metadata is separate from flat business input. The documented client deliberately avoids sending client cache policy by default because cache key material may contain tenant or user identifiers that would enter URL logs. Inspect caching, invalidation and offline behavior at the kernel/client boundary instead of hiding those concerns inside each handler. A transport success must still produce the expected canonical result.

Follow a practical path.

  1. Choose one vertical slice

    Select a query and a command already declared in source. Identify their registry bindings, handler context, adapter entry and consumer call. Start with the smallest actual host composition that exercises these pieces together.

  2. Inspect the negative path

    Trace invalid input, missing trusted identity, required-but-missing approval and an unavailable handler/provider. The relevant question is whether execution stops at the correct boundary and returns a result the caller can handle.

  3. Qualify the selected environment

    Use the host’s existing test and build setup for the exact runtime and package versions. Record separately whether you checked source, local handler execution, the transport boundary or a deployed endpoint; those observations answer different questions.

All packages in this area.

9 packages
foundation / library

lib.contracts-runtime-kernel

v0.1.0
Package manifestGuide availablenodebunbrowser

Canonical framework-neutral ContractSpec engine, ports and storage; no Forms or backend authority

@lssm-tech/lib.contracts-runtime-kernel
33Declared imports
7Direct dependencies
Inspect this packageImports · dependencies · qualification

Declared import paths

manifest-declared export entrypoints and catalog-declared imports

  • @lssm-tech/lib.contracts-runtime-kernel
    ./src/index.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-kernel/engine/events
    ./src/engine/events.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-kernel/forms/form-registry
    ./src/forms/form-registry.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-kernel/forms/projection-lookup
    ./src/forms/projection-lookup.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-kernel/redaction
    ./src/redaction.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-kernel/storage/async-storage
    ./src/storage/async-storage.native.tsOpen the source

Showing 6 of 33 declared entry points.

Dependency declarations
Runtime
5
Peer
0
Development
2
Optional
0
  • @lssm-tech/lib.schemaworkspace:^ · runtime
  • compare-versionscatalog:data · runtime
  • @lssm-tech/lib.contracts-spec-coreworkspace:^ · runtime
  • @lssm-tech/lib.crypto-utilsworkspace:^ · runtime
  • zodcatalog: · runtime
  • @lssm-tech/tool.bunworkspace:* · development

Showing 6 of 7 declarations across scopes. A package may appear in more than one scope.

Package and source context
Package scope
No private flag declared in the manifest
Source guide
README available
Declared runtimes
node, bun, browser
Declared stability
experimental
Source path
packages/foundation/contracts-runtime-kernel

Manifest declarations describe this source snapshot; they do not verify registry publication or runtime execution.

platform / library

lib.contracts-runtime-client-react

v6.0.4
Package manifestGuide availablebrowserbunnode

React runtime adapters for ContractSpec contracts

@lssm-tech/lib.contracts-runtime-client-react
24Declared imports
18Direct dependencies
Inspect this packageImports · dependencies · qualification

Declared import paths

manifest-declared export entrypoints and catalog-declared imports

  • @lssm-tech/lib.contracts-runtime-client-react
    ./src/index.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-client-react/adaptive-form
    ./src/adaptive-form.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-client-react/contract-data-engine-context
    ./src/contract-data-engine-context.tsxOpen the source
  • @lssm-tech/lib.contracts-runtime-client-react/contract-result-client
    ./src/contract-result-client.tsxOpen the source
  • @lssm-tech/lib.contracts-runtime-client-react/contracts-runtime-client-react.feature
    ./src/contracts-runtime-client-react.feature.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-client-react/drivers/rn-reusables
    ./src/drivers/rn-reusables.tsOpen the source

Showing 6 of 24 declared entry points.

Dependency declarations
Runtime
8
Peer
5
Development
5
Optional
0
  • @lssm-tech/lib.personalizationworkspace:^ · runtime
  • @lssm-tech/lib.schemaworkspace:^ · runtime
  • @lssm-tech/lib.lssm-os-runtimeworkspace:^ · runtime
  • @lssm-tech/lib.presentation-runtime-coreworkspace:^ · runtime
  • @lssm-tech/lib.contracts-runtime-kernelworkspace:^ · runtime
  • @lssm-tech/lib.contracts-spec-coreworkspace:^ · runtime

Showing 6 of 18 declarations across scopes. A package may appear in more than one scope.

Package and source context
Package scope
No private flag declared in the manifest
Source guide
README available
Declared runtimes
browser, bun, node
Declared stability
stable
Source path
packages/platform/delivery/contracts-runtime-client-react

Manifest declarations describe this source snapshot; they do not verify registry publication or runtime execution.

platform / library

lib.contracts-runtime-core

v3.0.4
Package manifestGuide availablenode

Framework-neutral in-house query/cache/offline engine and Transport port for ContractSpec data fetching

@lssm-tech/lib.contracts-runtime-core
24Declared imports
14Direct dependencies
Inspect this packageImports · dependencies · qualification

Declared import paths

manifest-declared export entrypoints and catalog-declared imports

  • @lssm-tech/lib.contracts-runtime-core
    ./src/index.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-core/contracts-runtime-core.feature
    ./src/contracts-runtime-core.feature.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-core/observability
    ./src/observability.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-core/storage/async-storage
    ./src/storage/async-storage.native.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-core/storage/indexeddb
    ./src/storage/indexeddb.web.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-core/serialization/serializers
    ./src/serialization/serializers.tsOpen the source

Showing 6 of 24 declared entry points.

Dependency declarations
Runtime
11
Peer
1
Development
3
Optional
0
  • @lssm-tech/lib.observabilityworkspace:^ · runtime
  • @lssm-tech/lib.contracts-spec-coreworkspace:^ · runtime
  • @lssm-tech/lib.contracts-runtime-kernelworkspace:^ · runtime
  • @lssm-tech/lib.forms-runtimeworkspace:^ · runtime
  • @lssm-tech/lib.assurance-specworkspace:^ · runtime
  • @lssm-tech/lib.lssm-os-specworkspace:^ · runtime

Showing 6 of 15 declarations across scopes. A package may appear in more than one scope.

Package and source context
Package scope
No private flag declared in the manifest
Source guide
README available
Declared runtimes
node
Declared stability
stable
Source path
packages/platform/delivery/contracts-runtime-core

Manifest declarations describe this source snapshot; they do not verify registry publication or runtime execution.

platform / library

lib.contracts-runtime-server-graphql

v5.0.4
Package manifestGuide availablenode

GraphQL server runtime adapters for ContractSpec contracts

@lssm-tech/lib.contracts-runtime-server-graphql
3Declared imports
15Direct dependencies
Inspect this packageImports · dependencies · qualification

Declared import paths

manifest-declared export entrypoints and catalog-declared imports

  • @lssm-tech/lib.contracts-runtime-server-graphql
    ./src/index.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-graphql/contracts-runtime-server-graphql.feature
    ./src/contracts-runtime-server-graphql.feature.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-graphql/graphql-pothos
    ./src/graphql-pothos.tsOpen the source

Showing 3 of 3 declared entry points.

Dependency declarations
Runtime
11
Peer
1
Development
3
Optional
0
  • @lssm-tech/lib.contracts-runtime-coreworkspace:^ · runtime
  • @lssm-tech/lib.contracts-runtime-kernelworkspace:^ · runtime
  • @lssm-tech/lib.contracts-runtime-server-restworkspace:^ · runtime
  • @lssm-tech/lib.contracts-spec-coreworkspace:^ · runtime
  • @lssm-tech/lib.schemaworkspace:^ · runtime
  • @lssm-tech/lib.utils-typescriptworkspace:^ · runtime

Showing 6 of 15 declarations across scopes. A package may appear in more than one scope.

Package and source context
Package scope
No private flag declared in the manifest
Source guide
README available
Declared runtimes
node
Declared stability
stable
Source path
packages/platform/delivery/contracts-runtime-server-graphql

Manifest declarations describe this source snapshot; they do not verify registry publication or runtime execution.

platform / library

lib.contracts-runtime-server-mcp

v5.0.4
Package manifestGuide availablenode

MCP server runtime adapters for ContractSpec contracts

@lssm-tech/lib.contracts-runtime-server-mcp
13Declared imports
13Direct dependencies
Inspect this packageImports · dependencies · qualification

Declared import paths

manifest-declared export entrypoints and catalog-declared imports

  • @lssm-tech/lib.contracts-runtime-server-mcp
    ./src/index.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-mcp/contracts-runtime-server-mcp.feature
    ./src/contracts-runtime-server-mcp.feature.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-mcp/marketing
    ./src/marketing/index.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-mcp/marketing/marketing-agent-config
    ./src/marketing/marketing-agent-config.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-mcp/marketing/marketing-mcp
    ./src/marketing/marketing-mcp.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-mcp/marketing/marketing-registry
    ./src/marketing/marketing-registry.tsOpen the source

Showing 6 of 13 declared entry points.

Dependency declarations
Runtime
7
Peer
0
Development
6
Optional
0
  • @lssm-tech/lib.contracts-runtime-coreworkspace:^ · runtime
  • @lssm-tech/lib.contracts-specworkspace:^ · runtime
  • @lssm-tech/lib.contracts-spec-coreworkspace:^ · runtime
  • @lssm-tech/lib.loggerworkspace:^ · runtime
  • @lssm-tech/lib.utils-typescriptworkspace:^ · runtime
  • @modelcontextprotocol/sdkcatalog:ai · runtime

Showing 6 of 13 declarations across scopes. A package may appear in more than one scope.

Package and source context
Package scope
No private flag declared in the manifest
Source guide
README available
Declared runtimes
node
Declared stability
stable
Source path
packages/platform/delivery/contracts-runtime-server-mcp

Manifest declarations describe this source snapshot; they do not verify registry publication or runtime execution.

platform / library

lib.contracts-runtime-server-rest

v5.0.4
Package manifestGuide availablenode

REST server runtime adapters for ContractSpec contracts

@lssm-tech/lib.contracts-runtime-server-rest
17Declared imports
16Direct dependencies
Inspect this packageImports · dependencies · qualification

Declared import paths

manifest-declared export entrypoints and catalog-declared imports

  • @lssm-tech/lib.contracts-runtime-server-rest
    ./src/index.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-rest/ai-cost-guard
    ./src/ai-cost-guard.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-rest/contracts-adapter-hydration
    ./src/contracts-adapter-hydration.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-rest/contracts-adapter-input
    ./src/contracts-adapter-input.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-rest/contracts-runtime-server-rest.feature
    ./src/contracts-runtime-server-rest.feature.tsOpen the source
  • @lssm-tech/lib.contracts-runtime-server-rest/pwa-update
    ./src/pwa-update.tsOpen the source

Showing 6 of 17 declared entry points.

Dependency declarations
Runtime
6
Peer
6
Development
4
Optional
0
  • @lssm-tech/lib.contracts-runtime-coreworkspace:^ · runtime
  • @lssm-tech/lib.contracts-runtime-kernelworkspace:^ · runtime
  • @lssm-tech/lib.contracts-spec-coreworkspace:^ · runtime
  • @lssm-tech/lib.schemaworkspace:^ · runtime
  • @lssm-tech/lib.utils-typescriptworkspace:^ · runtime
  • zodcatalog: · runtime

Showing 6 of 16 declarations across scopes. A package may appear in more than one scope.

Package and source context
Package scope
No private flag declared in the manifest
Source guide
README available
Declared runtimes
node
Declared stability
stable
Source path
packages/platform/delivery/contracts-runtime-server-rest

Manifest declarations describe this source snapshot; they do not verify registry publication or runtime execution.

platform / library

lib.graphql-core

v5.1.3
Package manifestGuide availablenode

Shared GraphQL core: Pothos builder factory, scalars, tracing & complexity

@lssm-tech/lib.graphql-core
2Declared imports
11Direct dependencies
Inspect this packageImports · dependencies · qualification

Declared import paths

manifest-declared export entrypoints and catalog-declared imports

Showing 2 of 2 declared entry points.

Dependency declarations
Runtime
8
Peer
1
Development
3
Optional
0
  • @pothos/corecatalog:graphql · runtime
  • @pothos/plugin-complexitycatalog:graphql · runtime
  • @pothos/plugin-dataloadercatalog:graphql · runtime
  • @pothos/plugin-relaycatalog:graphql · runtime
  • @pothos/plugin-tracingcatalog:graphql · runtime
  • graphqlcatalog:graphql · runtime

Showing 6 of 12 declarations across scopes. A package may appear in more than one scope.

Package and source context
Package scope
No private flag declared in the manifest
Source guide
README available
Declared runtimes
node
Declared stability
stable
Source path
packages/platform/delivery/graphql-core

Manifest declarations describe this source snapshot; they do not verify registry publication or runtime execution.

platform / library

lib.graphql-federation

v6.0.3
Package manifestGuide availablenode

Pothos federation helpers and subgraph schema export utilities

@lssm-tech/lib.graphql-federation
2Declared imports
9Direct dependencies
Inspect this packageImports · dependencies · qualification

Declared import paths

manifest-declared export entrypoints and catalog-declared imports

Showing 2 of 2 declared entry points.

Dependency declarations
Runtime
6
Peer
1
Development
3
Optional
0
  • @pothos/corecatalog:graphql · runtime
  • @pothos/plugin-federation^4.5.3 · runtime
  • @pothos/plugin-directives^4.3.2 · runtime
  • graphqlcatalog:graphql · runtime
  • @apollo/subgraph^2.15.1 · runtime
  • @lssm-tech/lib.contracts-spec-coreworkspace:^ · runtime

Showing 6 of 10 declarations across scopes. A package may appear in more than one scope.

Package and source context
Package scope
No private flag declared in the manifest
Source guide
README available
Declared runtimes
node
Declared stability
stable
Source path
packages/platform/delivery/graphql-federation

Manifest declarations describe this source snapshot; they do not verify registry publication or runtime execution.

platform / library

lib.graphql-prisma

v6.1.3
Package manifestGuide availablenode

Pothos + Prisma builder factory with injectable client/DMMF

@lssm-tech/lib.graphql-prisma
2Declared imports
13Direct dependencies
Inspect this packageImports · dependencies · qualification

Declared import paths

manifest-declared export entrypoints and catalog-declared imports

Showing 2 of 2 declared entry points.

Dependency declarations
Runtime
10
Peer
1
Development
3
Optional
0
  • @lssm-tech/lib.schemaworkspace:^ · runtime
  • @pothos/corecatalog:graphql · runtime
  • @pothos/plugin-complexitycatalog:graphql · runtime
  • @pothos/plugin-dataloadercatalog:graphql · runtime
  • @pothos/plugin-prisma^4.17.0 · runtime
  • @pothos/plugin-relaycatalog:graphql · runtime

Showing 6 of 14 declarations across scopes. A package may appear in more than one scope.

Package and source context
Package scope
No private flag declared in the manifest
Source guide
README available
Declared runtimes
node
Declared stability
stable
Source path
packages/platform/delivery/graphql-prisma

Manifest declarations describe this source snapshot; they do not verify registry publication or runtime execution.

Your view

Make room for your context.

Shape the presentation around this moment. You can change it whenever you need.

Your context

The different parts of you

Choose a starting point

A useful mix of context, visuals and gentle guidance.

Tune each dimension
Each dimension can change independently. Product permissions and available actions stay unchanged.

Support the way you begin and return

Tune your support

Reading comfort

Choose your language

Interface language changes text only. Markets, prices and workflows keep their own settings.

Translation coverage

Original source

Navigation151
Graph616
Categories378
Portfolio833
Examples2,035
Source preview1,542

More translations will be added as content is reviewed.

This preference is saved on this browser.

Search the website

Useful starting points

No results. Try a shorter phrase, an operation name or another search area.

A LITTLE ROOM TO EXPLORE

Find something to explore.

Open a closer look on this page, try a different perspective, or follow the detail into its own page.

How previews and controls work
01

Look before you leave

Hover a link or focus it with Tab to see a preview. Clicking the original link or pressing Enter always opens its destination.

02

Stay with the context

Move into the preview to explore its sections. Use Alt + ↓ from a focused link to enter it with the keyboard. Escape closes it.

03

Open the possibilities

Disclosure rows, perspective choices and highlighted controls reveal more. Your view changes reading comfort and the context you explore.

A separate button for a closer look

Show small preview buttons beside links where there is room. Tap the eye to inspect, or tap the link to go straight there. This choice stays in this tab.

No browsing history is collected. Reduced motion follows your device and Your view.