Orkestrel Core

Minimal, strongly-typed adapter/port toolkit for TypeScript. Compose capabilities with tokens, wire implementations via a tiny DI container, and drive lifecycles deterministically with an orchestrator.

• Package: @orkestrel/core
• TypeScript-first, ESM-only
• Works in Node and the browser (Node 18+)

Install

npm install @orkestrel/core

Documentation

• Overview: https://github.com/orkestrel/core/blob/main/docs/guide/overview.md
• Start: https://github.com/orkestrel/core/blob/main/docs/guide/start.md
• Concepts: https://github.com/orkestrel/core/blob/main/docs/guide/concepts.md
• Core: https://github.com/orkestrel/core/blob/main/docs/guide/core.md
• Examples: https://github.com/orkestrel/core/blob/main/docs/guide/examples.md
• Tips: https://github.com/orkestrel/core/blob/main/docs/guide/tips.md
• Tests: https://github.com/orkestrel/core/blob/main/docs/guide/tests.md
• Contribute: https://github.com/orkestrel/core/blob/main/docs/guide/contribute.md
• FAQ: https://github.com/orkestrel/core/blob/main/docs/guide/faq.md
• API: https://github.com/orkestrel/core/blob/main/docs/api/index.md
• LLM: https://github.com/orkestrel/core/blob/main/docs/llms.txt
• LLM Full: https://github.com/orkestrel/core/blob/main/docs/llms-full.txt

Notes

• Providers are synchronous (no async factories or Promise values). Do async work in Lifecycle hooks.
• Deterministic start/stop/destroy order with timeouts and rollback on failures.

Scripts

npm run check   # typecheck
npm run test    # unit tests
npm run docs    # generate API docs into docs/api
npm run build   # build ESM + types into dist

Links

• Issues: https://github.com/orkestrel/core/issues

License

MIT © 2025 Orkestrel