@mrclrchtr/supi-code-runtime
v7.3.0
Published
Shared workspace context and capability contracts for code intelligence
Maintainers
Readme
@mrclrchtr/supi-code-runtime
Shared workspace context, capability contracts, and canonical types for the SuPi code-understanding stack.
This is a library-only package — it has no pi extension surface, no user-facing tools, and no UI. It is not installed directly — supi-lsp, supi-tree-sitter, and supi-code-intelligence bundle it and use its shared abstractions to communicate capability availability.
Package surfaces
@mrclrchtr/supi-code-runtime/api— shared canonical types, capability interfaces, and the workspace runtime registry
Read-only provider methods return CodeQueryResult<T>:
completed— collection completed;datamay be empty ornullpartial— usable data was collected, but one or more provider branches failedunavailable— no result was established; includes a reason
This keeps successful zero-result facts distinct from routing, transport, and provider failures.
Semantic and structural provider methods also accept optional CodeRequestControl metadata. It contains a caller AbortSignal, an absolute Unix-epoch deadline, and an optional opaque Debug Operation ID. Adapters preserve the same object. The ID does not change cancellation semantics. Canonical helpers identify cancellation and deadline expiry across bundled package copies. Cooperative structural substrates apply the control; unsupported substrates can preserve it without applying behavior.
License
MIT
