@bespokeagentics/microdots-runtime

Shared Effect layers for MicroDots — RPC client, service runner, Workers adapter, D1 and secret seams. Raw TypeScript source; consume with Bun or Vite.

Platform-specific Effect runtime helpers. The root import is browser code; /service is Bun/Node; /worker is Cloudflare. Never import /service into a browser or Worker bundle.

Quickstart

Start with a complete host that demonstrates the packages together:

# Bun is required
bunx @bespokeagentics/[email protected] app --yes
cd app
bun install
bun run check
bun run build
bun run dev
# Open http://localhost:5190
# Select a scope and watch the pulse readout
# Ctrl-C stops the services, watchers and host

The picker uses port 3201 and pulse uses 3202. No private-repository access is required. The generated README explains topology, attributes and adding a dot.

Package entry points

• .
• ./d1
• ./decisions
• ./decisions-sqlite
• ./llm
• ./rest
• ./secret
• ./service
• ./trace
• ./worker
• ./evidence
• ./evidence-evaluation
• ./semantic-records-sqlite

This README patch is based on package version 0.2.0 at release 63343b089b. Keep the scaffold's dependency versions together; newer workspace entry points are not part of this release.

Known limitations

• The scaffolder requires Bun.
• The hosted Platform runs Wiring; authoring, building, placement and deployment remain local.
• Partner write access is not offered; owner sign-in writes are a separate release gate.
• Ports is not built. Composition, customization and semantic checks are local opt-in previews.
• Container-backed services are a local proof.

Quickstart · API reference

License

Apache-2.0. See LICENSE in this package.