runner

runner is an execution engine designed to process nanoservice-based workflows efficiently. It provides a structured way to execute bloks within a defined workflow, enabling modular, reusable backend logic.

​

Relationship to the rest of the project

In addition, it also tracks important parameters and metrics during the workflow execution that can be used for debugging and monitoring purposes.

​

**Guide to Contributing to the Runner in Blok **

​

1. Clone the Repository

git clone https://github.com/deskree-inc/blok.git
cd blok/core/runner
npm install

​

2. Run the Runner Locally

npm run dev

This will start the Runner in development mode, allowing you to test changes in real-time.

​

Understanding the Runner

The Runner is responsible for:
✅ Executing nanoservices in an isolated environment.
✅ Managing resource allocation (CPU, memory).
✅ Handling retries, error logging, and state management.

​

Adding Features or Fixing Bugs

​

1. Create a Feature Branch

git checkout -b feature/improve-runner-logging

​

2. Make Your Changes

Modify the relevant files inside /core/runner/src/.
Example: Improving logging in executor.ts

import { logInfo } from './logger';

async function executeNode(node: NodeConfig) {
  logInfo(`Executing node: ${node.id} (${node.type})`);
  // Execution logic...
}

​

3. Test Your Changes

Run unit tests:

npm test

Manually test with:

npm run dev

​

4. Submit a Pull Request

Push your changes and open a PR on GitHub.

git push origin feature/improve-runner-logging

In the PR description, include:

• What was changed?
• Why was it changed?
• How was it tested?

​

Best Practices

✅ Keep functions modular and reusable.
✅ Write unit tests for new features.
✅ Use consistent logging for observability.
✅ Ensure changes do not break existing workflows.

​

Final Notes

Contributing to the Runner helps improve the efficiency and reliability of Blok. If you have any questions, open an issue on GitHub! 🚀

🔗 GitHub Repository