{"id":"@lssm-tech/lib.provider-runtime","slug":"lib.provider-runtime","name":"@lssm-tech/lib.provider-runtime","version":"2.0.4","path":"packages/platform/agents/provider-runtime","manifestPath":"packages/platform/agents/provider-runtime/package.json","manifestBlobSha":"8aead2334c223d0272b40befaa6cf39cffb23f7e","layer":"platform","physicalArea":"agents","primaryArea":"integrations-and-providers","classification":{"privateDeclared":null,"catalogFamily":"runtime","catalogKind":"library","catalogStatus":"active","adoptionMode":"adoptable","stability":"experimental"},"description":"Builder provider-runtime helpers for routing, context prep, runtime targets, and receipt normalization.","descriptionOrigin":"package.json","catalog":{"family":"runtime","kind":"library","status":"active","adoptionMode":"adoptable","stability":"experimental","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./ai-improvement","./comparison-run","./execution-context","./execution-output","./managed-builder-bootstrap","./managed-builder-bootstrap.resources","./managed-builder-runtime-targets","./provider-runtime.feature","./providers","./recommended-builder-setup","./routing-policy","./runtime-targets","./sha256","./sha256-constants","./shared"],"documentation":[{"title":"Lib Provider Runtime documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Flib.provider-runtime","kind":"readme"}],"examples":[],"replacements":[],"capabilities":[{"id":"package.lssm.tech.lib.provider.runtime","title":"Lib Provider Runtime","description":"Builder provider-runtime helpers for routing, context prep, runtime targets, and receipt normalization.","status":"active","useCases":["Adopt builder provider-runtime helpers for routing, context prep, runtime targets, and receipt normalization"],"aliases":["contractspec","builder","provider","runtime","typescript","lib"],"pythonEquivalents":[],"canonicalImports":[{"from":"@lssm-tech/lib.provider-runtime","symbols":[]},{"from":"@lssm-tech/lib.provider-runtime/ai-improvement","symbols":[]},{"from":"@lssm-tech/lib.provider-runtime/comparison-run","symbols":[]},{"from":"@lssm-tech/lib.provider-runtime/execution-context","symbols":[]},{"from":"@lssm-tech/lib.provider-runtime/execution-output","symbols":[]},{"from":"@lssm-tech/lib.provider-runtime/managed-builder-bootstrap","symbols":[]},{"from":"@lssm-tech/lib.provider-runtime/managed-builder-bootstrap.resources","symbols":[]},{"from":"@lssm-tech/lib.provider-runtime/managed-builder-runtime-targets","symbols":[]},{"from":"@lssm-tech/lib.provider-runtime/provider-runtime.feature","symbols":[]},{"from":"@lssm-tech/lib.provider-runtime/providers","symbols":[]},{"from":"@lssm-tech/lib.provider-runtime/recommended-builder-setup","symbols":[]},{"from":"@lssm-tech/lib.provider-runtime/routing-policy","symbols":[]}],"constraints":{"platforms":["server"],"runtimes":["node"],"avoidWhen":["The @lssm-tech/lib.provider-runtime package constraints do not match the target runtime or platform."],"requires":["TypeScript"]},"alternatives":[],"relationships":[],"resolutionPriority":50}]},"canonicalImports":[{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime","symbols":[]},{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime/ai-improvement","symbols":[]},{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime/comparison-run","symbols":[]},{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime/execution-context","symbols":[]},{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime/execution-output","symbols":[]},{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime/managed-builder-bootstrap","symbols":[]},{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime/managed-builder-bootstrap.resources","symbols":[]},{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime/managed-builder-runtime-targets","symbols":[]},{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime/provider-runtime.feature","symbols":[]},{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime/providers","symbols":[]},{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime/recommended-builder-setup","symbols":[]},{"capabilityId":"package.lssm.tech.lib.provider.runtime","from":"@lssm-tech/lib.provider-runtime/routing-policy","symbols":[]}],"scripts":{"publish:pkg":"bun publish --tolerate-republish --ignore-scripts --verbose","publish:pkg:canary":"bun publish:pkg --tag canary","build":"contractspec-bun-build build","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types","dev":"contractspec-bun-build dev","clean":"rimraf dist .turbo","lint":"bun lint:fix","lint:fix":"node ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .","lint:check":"node ../../../../scripts/biome.cjs check .","test":"bun test","prebuild":"contractspec-bun-build prebuild","typecheck":"tsgo --noEmit"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.mobile-control":"workspace:^","@lssm-tech/lib.provider-spec":"workspace:^","@lssm-tech/lib.orchestration-spec":"workspace:^","@lssm-tech/lib.contracts-spec-core":"workspace:^"},"devDependencies":{"@lssm-tech/tool.bun":"workspace:*","@lssm-tech/tool.typescript":"workspace:*","typescript":"catalog:"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./ai-improvement":"./src/ai-improvement.ts","./comparison-run":"./src/comparison-run.ts","./execution-context":"./src/execution-context.ts","./execution-output":"./src/execution-output.ts","./managed-builder-bootstrap":"./src/managed-builder-bootstrap.ts","./managed-builder-bootstrap.resources":"./src/managed-builder-bootstrap.resources.ts","./managed-builder-runtime-targets":"./src/managed-builder-runtime-targets.ts","./provider-runtime.feature":"./src/provider-runtime.feature.ts","./providers":"./src/providers.ts","./recommended-builder-setup":"./src/recommended-builder-setup.ts","./routing-policy":"./src/routing-policy.ts","./runtime-targets":"./src/runtime-targets.ts","./sha256":"./src/sha256.ts","./sha256-constants":"./src/sha256-constants.ts","./shared":"./src/shared.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","browser":"./dist/browser/index.js","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./ai-improvement":{"types":"./dist/ai-improvement.d.ts","browser":"./dist/browser/ai-improvement.js","bun":"./dist/ai-improvement.js","node":"./dist/node/ai-improvement.js","default":"./dist/ai-improvement.js"},"./comparison-run":{"types":"./dist/comparison-run.d.ts","browser":"./dist/browser/comparison-run.js","bun":"./dist/comparison-run.js","node":"./dist/node/comparison-run.js","default":"./dist/comparison-run.js"},"./execution-context":{"types":"./dist/execution-context.d.ts","browser":"./dist/browser/execution-context.js","bun":"./dist/execution-context.js","node":"./dist/node/execution-context.js","default":"./dist/execution-context.js"},"./execution-output":{"types":"./dist/execution-output.d.ts","browser":"./dist/browser/execution-output.js","bun":"./dist/execution-output.js","node":"./dist/node/execution-output.js","default":"./dist/execution-output.js"},"./managed-builder-bootstrap":{"types":"./dist/managed-builder-bootstrap.d.ts","browser":"./dist/browser/managed-builder-bootstrap.js","bun":"./dist/managed-builder-bootstrap.js","node":"./dist/node/managed-builder-bootstrap.js","default":"./dist/managed-builder-bootstrap.js"},"./managed-builder-bootstrap.resources":{"types":"./dist/managed-builder-bootstrap.resources.d.ts","browser":"./dist/browser/managed-builder-bootstrap.resources.js","bun":"./dist/managed-builder-bootstrap.resources.js","node":"./dist/node/managed-builder-bootstrap.resources.js","default":"./dist/managed-builder-bootstrap.resources.js"},"./managed-builder-runtime-targets":{"types":"./dist/managed-builder-runtime-targets.d.ts","browser":"./dist/browser/managed-builder-runtime-targets.js","bun":"./dist/managed-builder-runtime-targets.js","node":"./dist/node/managed-builder-runtime-targets.js","default":"./dist/managed-builder-runtime-targets.js"},"./provider-runtime.feature":{"types":"./dist/provider-runtime.feature.d.ts","browser":"./dist/browser/provider-runtime.feature.js","bun":"./dist/provider-runtime.feature.js","node":"./dist/node/provider-runtime.feature.js","default":"./dist/provider-runtime.feature.js"},"./providers":{"types":"./dist/providers.d.ts","browser":"./dist/browser/providers.js","bun":"./dist/providers.js","node":"./dist/node/providers.js","default":"./dist/providers.js"},"./recommended-builder-setup":{"types":"./dist/recommended-builder-setup.d.ts","browser":"./dist/browser/recommended-builder-setup.js","bun":"./dist/recommended-builder-setup.js","node":"./dist/node/recommended-builder-setup.js","default":"./dist/recommended-builder-setup.js"},"./routing-policy":{"types":"./dist/routing-policy.d.ts","browser":"./dist/browser/routing-policy.js","bun":"./dist/routing-policy.js","node":"./dist/node/routing-policy.js","default":"./dist/routing-policy.js"},"./runtime-targets":{"types":"./dist/runtime-targets.d.ts","browser":"./dist/browser/runtime-targets.js","bun":"./dist/runtime-targets.js","node":"./dist/node/runtime-targets.js","default":"./dist/runtime-targets.js"},"./sha256":{"types":"./dist/sha256.d.ts","browser":"./dist/browser/sha256.js","bun":"./dist/sha256.js","node":"./dist/node/sha256.js","default":"./dist/sha256.js"},"./sha256-constants":{"types":"./dist/sha256-constants.d.ts","browser":"./dist/browser/sha256-constants.js","bun":"./dist/sha256-constants.js","node":"./dist/node/sha256-constants.js","default":"./dist/sha256-constants.js"},"./shared":{"types":"./dist/shared.d.ts","browser":"./dist/browser/shared.js","bun":"./dist/shared.js","node":"./dist/node/shared.js","default":"./dist/shared.js"}},"types":"./dist/index.d.ts","files":["dist","README.md"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/lib.provider-runtime","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"packages/platform/agents/provider-runtime/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./ai-improvement","importPath":"@lssm-tech/lib.provider-runtime/ai-improvement","target":"./src/ai-improvement.ts","targets":[{"conditions":[],"target":"./src/ai-improvement.ts","sourcePath":"packages/platform/agents/provider-runtime/src/ai-improvement.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/ai-improvement.ts","sourceStatus":"verified source file"}]},{"subpath":"./comparison-run","importPath":"@lssm-tech/lib.provider-runtime/comparison-run","target":"./src/comparison-run.ts","targets":[{"conditions":[],"target":"./src/comparison-run.ts","sourcePath":"packages/platform/agents/provider-runtime/src/comparison-run.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/comparison-run.ts","sourceStatus":"verified source file"}]},{"subpath":"./execution-context","importPath":"@lssm-tech/lib.provider-runtime/execution-context","target":"./src/execution-context.ts","targets":[{"conditions":[],"target":"./src/execution-context.ts","sourcePath":"packages/platform/agents/provider-runtime/src/execution-context.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/execution-context.ts","sourceStatus":"verified source file"}]},{"subpath":"./execution-output","importPath":"@lssm-tech/lib.provider-runtime/execution-output","target":"./src/execution-output.ts","targets":[{"conditions":[],"target":"./src/execution-output.ts","sourcePath":"packages/platform/agents/provider-runtime/src/execution-output.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/execution-output.ts","sourceStatus":"verified source file"}]},{"subpath":"./managed-builder-bootstrap","importPath":"@lssm-tech/lib.provider-runtime/managed-builder-bootstrap","target":"./src/managed-builder-bootstrap.ts","targets":[{"conditions":[],"target":"./src/managed-builder-bootstrap.ts","sourcePath":"packages/platform/agents/provider-runtime/src/managed-builder-bootstrap.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/managed-builder-bootstrap.ts","sourceStatus":"verified source file"}]},{"subpath":"./managed-builder-bootstrap.resources","importPath":"@lssm-tech/lib.provider-runtime/managed-builder-bootstrap.resources","target":"./src/managed-builder-bootstrap.resources.ts","targets":[{"conditions":[],"target":"./src/managed-builder-bootstrap.resources.ts","sourcePath":"packages/platform/agents/provider-runtime/src/managed-builder-bootstrap.resources.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/managed-builder-bootstrap.resources.ts","sourceStatus":"verified source file"}]},{"subpath":"./managed-builder-runtime-targets","importPath":"@lssm-tech/lib.provider-runtime/managed-builder-runtime-targets","target":"./src/managed-builder-runtime-targets.ts","targets":[{"conditions":[],"target":"./src/managed-builder-runtime-targets.ts","sourcePath":"packages/platform/agents/provider-runtime/src/managed-builder-runtime-targets.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/managed-builder-runtime-targets.ts","sourceStatus":"verified source file"}]},{"subpath":"./provider-runtime.feature","importPath":"@lssm-tech/lib.provider-runtime/provider-runtime.feature","target":"./src/provider-runtime.feature.ts","targets":[{"conditions":[],"target":"./src/provider-runtime.feature.ts","sourcePath":"packages/platform/agents/provider-runtime/src/provider-runtime.feature.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/provider-runtime.feature.ts","sourceStatus":"verified source file"}]},{"subpath":"./providers","importPath":"@lssm-tech/lib.provider-runtime/providers","target":"./src/providers.ts","targets":[{"conditions":[],"target":"./src/providers.ts","sourcePath":"packages/platform/agents/provider-runtime/src/providers.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/providers.ts","sourceStatus":"verified source file"}]},{"subpath":"./recommended-builder-setup","importPath":"@lssm-tech/lib.provider-runtime/recommended-builder-setup","target":"./src/recommended-builder-setup.ts","targets":[{"conditions":[],"target":"./src/recommended-builder-setup.ts","sourcePath":"packages/platform/agents/provider-runtime/src/recommended-builder-setup.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/recommended-builder-setup.ts","sourceStatus":"verified source file"}]},{"subpath":"./routing-policy","importPath":"@lssm-tech/lib.provider-runtime/routing-policy","target":"./src/routing-policy.ts","targets":[{"conditions":[],"target":"./src/routing-policy.ts","sourcePath":"packages/platform/agents/provider-runtime/src/routing-policy.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/routing-policy.ts","sourceStatus":"verified source file"}]},{"subpath":"./runtime-targets","importPath":"@lssm-tech/lib.provider-runtime/runtime-targets","target":"./src/runtime-targets.ts","targets":[{"conditions":[],"target":"./src/runtime-targets.ts","sourcePath":"packages/platform/agents/provider-runtime/src/runtime-targets.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/runtime-targets.ts","sourceStatus":"verified source file"}]},{"subpath":"./sha256","importPath":"@lssm-tech/lib.provider-runtime/sha256","target":"./src/sha256.ts","targets":[{"conditions":[],"target":"./src/sha256.ts","sourcePath":"packages/platform/agents/provider-runtime/src/sha256.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/sha256.ts","sourceStatus":"verified source file"}]},{"subpath":"./sha256-constants","importPath":"@lssm-tech/lib.provider-runtime/sha256-constants","target":"./src/sha256-constants.ts","targets":[{"conditions":[],"target":"./src/sha256-constants.ts","sourcePath":"packages/platform/agents/provider-runtime/src/sha256-constants.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/sha256-constants.ts","sourceStatus":"verified source file"}]},{"subpath":"./shared","importPath":"@lssm-tech/lib.provider-runtime/shared","target":"./src/shared.ts","targets":[{"conditions":[],"target":"./src/shared.ts","sourcePath":"packages/platform/agents/provider-runtime/src/shared.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/src/shared.ts","sourceStatus":"verified source file"}]}],"entryCount":16,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Lib Provider Runtime documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Flib.provider-runtime","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/lib.provider-runtime.txt"},"readme":{"status":"available","body":"# @lssm-tech/lib.provider-runtime\n\nWebsite: https://contractspec.io\n\nBuilder provider-runtime helpers for runtime-target normalization, provider registration, routing policy upserts, execution-context preparation, receipt normalization, and comparison records.\n\n## What It Provides\n\n- Runtime-target and external-provider record factories.\n- Routing-policy and execution-context normalization helpers.\n- Managed-first Builder routing-policy bootstrap helpers.\n- Provider-output normalization into receipts, sources, patch proposals, activity records, and mobile review cards.\n- Comparison-run record factories shared by Builder runtime and compatibility integrations.\n\n## Public Entry Points\n\n- `.` resolves through `./src/index.ts`\n- `./ai-improvement` exposes AI-improvement provider receipt normalization helpers.\n\n\n## Runtime and credential mode taxonomy\n\nRuntime 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.\n\nUse `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]`.\n\n## Notes\n\n- This package is a compatibility surface. Prefer additive evolution.\n- It carries provider/runtime control-plane logic that should remain reusable outside the Builder runtime package.\n\nProvider 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.\n","sourcePath":"packages/platform/agents/provider-runtime/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/platform/agents/provider-runtime/README.md","blobSha":"af456ce9e9082c384394c044d80086ba71dbb9d1","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"integrations-and-providers","areaTitle":"Integrations and provider selection","displayName":"lib.provider-runtime","runtimes":["node"],"platforms":["server"],"kind":"library","scope":"Package manifest","canonicalRoute":"/docs/packages/lib.provider-runtime/","contextUrl":"/docs/packages/lib.provider-runtime.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}