@aimount/engine
v0.1.0-alpha.0
Published
Provider-neutral execution engine shell for aimount runtimes
Readme
@aimount/engine
@aimount/engine is the provider-neutral execution core for aimount runtimes.
For the normative package contract, see ARCH.md.
Role
This package owns execution semantics that are independent of any specific provider framework.
Owns
- provider-neutral provider event, request, and port types
- continuation reconstruction and replay eligibility
- deterministic context-window selection
- internal runtime-event mapping and stream-state finalization
- the inline execution driver that emits canonical runtime events and final completion state
Does not own
- HTTP or gRPC transport publishing
- provider-framework adapters
- host-specific request wiring
- proxy-specific behavior
- persistence, queues, leases, and durable worker behavior
- framework-specific message conversion or tool mapping
Dependency direction
@aimount/engine depends on @aimount/core for canonical runtime model contracts. Adapter packages such as @aimount/engine-aisdk depend on @aimount/engine, while compatibility packages such as @aimount/runtime stay above the core-owned model layer for protocol, wire, and codec entrypoints.
Runtime API relation
The engine executes semantics that surface through the canonical RuntimeApi, but it does so through provider-neutral inputs and outputs rather than transport or provider SDK types.
Tool execution relation
The engine owns canonical tool lifecycle semantics, but concrete provider bindings stay in adapter packages above this layer.
Status
Experimental execution core implemented in the aw worktree extraction branch.
The package remains experimental while the extraction and cloud cutover are in progress.
Current public surface
- provider-neutral provider event types
- engine request and provider port types
- continuation and context-window helpers
- inline execution via
executeEngineInline(...)
Current implementation boundary
This package intentionally keeps provider-framework code out of the base layer. AI SDK conversion, streamText(...), and AI SDK chunk normalization live in @aimount/engine-aisdk instead.
