lib.provider-runtime
Builder provider-runtime helpers for routing, context prep, runtime targets, and receipt normalization.
@lssm-tech/lib.provider-runtimebun add @lssm-tech/lib.provider-runtimeManifest declarations describe the current workspace; they do not verify registry publication or runtime execution.
Package guide
Website: https://contractspec.io
Builder provider-runtime helpers for runtime-target normalization, provider registration, routing policy upserts, execution-context preparation, receipt normalization, and comparison records.
What It Provides
- Runtime-target and external-provider record factories.
- Routing-policy and execution-context normalization helpers.
- Managed-first Builder routing-policy bootstrap helpers.
- Provider-output normalization into receipts, sources, patch proposals, activity records, and mobile review cards.
- Comparison-run record factories shared by Builder runtime and compatibility integrations.
Public Entry Points
.resolves through./src/index.ts./ai-improvementexposes AI-improvement provider receipt normalization helpers.
Runtime and credential mode taxonomy
Runtime target modes are limited to managed, local, and hybrid. Credential ownership modes are a separate resolver taxonomy (managed, byok, local, ephemeral, and none) and must not be accepted as runtime target modes. Provider-runtime helpers filter mixed mode arrays and preserve existing runtime defaults instead of coercing credential ownership tokens such as byok into managed runtime execution.
Use redactCredentialResolverPayload before logging resolver payloads that may include credential-looking fields. The helper preserves non-secret taxonomy fields such as runtimeMode while replacing token, secret, API key, authorization, password, credential, and private-key fields with [redacted].
Notes
- This package is a compatibility surface. Prefer additive evolution.
- It carries provider/runtime control-plane logic that should remain reusable outside the Builder runtime package.
Provider helpers accept only the supplied workspace fields they read. Normalized output preserves its existing literal shapes and remains structurally assignable to Builder-owned records; the platform never imports Builder workspace/state definitions.
Relationships
Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.
4 declarations
@lssm-tech/lib.mobile-controlworkspace:^
Read the package manual ↗@lssm-tech/lib.provider-specworkspace:^
Read the package manual ↗@lssm-tech/lib.orchestration-specworkspace:^
Read the package manual ↗@lssm-tech/lib.contracts-spec-coreworkspace:^
Read the package manual ↗
Declared capabilities
Builder provider-runtime helpers for routing, context prep, runtime targets, and receipt normalization.
Scripts
publish:pkgbun publish --tolerate-republish --ignore-scripts --verbosepublish:pkg:canarybun publish:pkg --tag canarybuildcontractspec-bun-build buildbuild:bundlecontractspec-bun-build transpilebuild:typescontractspec-bun-build typesdevcontractspec-bun-build devcleanrimraf dist .turbolintbun lint:fixlint:fixnode ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .lint:checknode ../../../../scripts/biome.cjs check .testbun testprebuildcontractspec-bun-build prebuildtypechecktsgo --noEmit