# maka | The Apache Software Foundation | Knowledge Base | Instagit

Apache Maka (Incubating) is a local-first AI agent workspace. Model messages, tool calls, tool results, permission decisions, and termination events are recorded as an append-only log.

GitHub Stars: 2.2k

Repository: https://github.com/apache/maka

---

## Articles

### [Latest Features in Apache Maka: Runtime Revamp, Typed APIs, and CLI Tools](/apache/maka/latest-features-apache-maka)

Explore the latest Apache Maka features including a runtime revamp, typed APIs for `request()`, and new CLI tools. Upgrade your experience today.

- Tags: getting-started
- Published: 2026-09-13

### [How to Upgrade Apache Maka: Complete Guide for Desktop and CLI](/apache/maka/how-to-upgrade-apache-maka)

Upgrade Apache Maka with this comprehensive guide. Learn the staged approach to backup, validate binaries, and migrate your SQLite schema seamlessly.

- Tags: how-to-guide
- Published: 2026-09-13

### [Community Support for Apache Maka: A Complete Guide to ASF Channels and GitHub Resources](/apache/maka/apache-maka-community-support)

Discover Apache Maka community support! Explore ASF channels and GitHub resources for help and engagement with this powerful Apache project.

- Tags: getting-started
- Published: 2026-09-13

### [How to Troubleshoot Apache Maka Issues: A Complete Diagnostic Guide](/apache/maka/troubleshoot-maka-issues)

Troubleshoot Apache Maka issues with our complete diagnostic guide. Learn to fix version mismatches, WebSocket connectivity, and missing Docker images using built-in commands.

- Tags: how-to-guide
- Published: 2026-09-13

### [Supported Platforms for Apache Maka: macOS Production and Cross-Platform Preview](/apache/maka/maka-supported-platforms)

Discover Apache Maka supported platforms. Get production-ready builds for macOS and preview builds for Windows and Linux. Develop cross-platform applications with ease.

- Tags: getting-started
- Published: 2026-09-13

### [How to Deploy Apache Maka: A Complete Guide to Runtime Host and CLI Installation](/apache/maka/how-to-deploy-apache-maka)

Deploy Apache Maka easily by cloning the repo, installing Node.js, and running npm commands. Learn how to build the runtime host and manage deployments efficiently with this complete guide.

- Tags: how-to-guide
- Published: 2026-09-13

### [Security Considerations for Apache Maka: Load-Bearing Boundaries and Heuristic Controls](/apache/maka/apache-maka-security)

Explore Apache Maka security with load-bearing boundaries and heuristic controls. Learn how Maka safeguards your system through robust defense-in-depth.

- Tags: security-considerations
- Published: 2026-09-13

### [How to Monitor Apache Maka Performance: A Complete Guide to the CDP-Based Profiling Harness](/apache/maka/monitor-maka-performance)

Learn to monitor Apache Maka performance using its CDP-based profiling harness. Collect key metrics like React commit counts and JS self-time for deeper insights.

- Tags: performance
- Published: 2026-09-13

### [Apache Maka APIs: Complete Reference for the Modular Runtime](/apache/maka/apache-maka-apis)

Explore Apache Maka's eight core public APIs including Runtime Host bridge, SessionManager, Model Provider, Tool contracts, SQLite Storage, CLI, React UI, and Peer-Mesh networking. Discover the modular runtime's capabilities.

- Tags: api-reference
- Published: 2026-09-13

### [How to Set Up an Apache Maka Development Environment: Complete Guide](/apache/maka/maka-development-environment-setup)

Set up your Apache Maka development environment quickly. Follow this guide to install dependencies, clone the repo, and launch the UI with npm commands for seamless development.

- Tags: getting-started
- Published: 2026-09-13

### [What Is the License for Apache Maka? Complete Guide to Apache 2.0 Compliance](/apache/maka/apache-maka-license)

Understand the Apache License 2.0 for Apache Maka. Learn your rights to use, modify, and distribute the code freely. Essential compliance guide.

- Tags: legal-info
- Published: 2026-09-13

### [How to Report a Bug in Apache Maka: A Step-by-Step Guide](/apache/maka/report-bug-apache-maka)

Learn how to report a bug in Apache Maka effectively. Follow our step-by-step guide to submit clear, reproducible bug reports on GitHub for faster resolution.

- Tags: how-to-guide
- Published: 2026-09-13

### [Where to Find Apache Maka Documentation: Repository and Website Guide](/apache/maka/apache-maka-documentation)

Find Apache Maka documentation easily. Explore the repository's docs/README.md for guides, policies, and the official website at maka.apache.org.

- Tags: getting-started
- Published: 2026-09-13

### [How to Contribute to Apache Maka: A Complete Guide for Developers](/apache/maka/contribute-to-apache-maka)

Contribute to Apache Maka easily. Clone the repo, install dependencies, build the project, and submit your PRs following our contribution guide.

- Tags: how-to-guide
- Published: 2026-09-13

### [Apache Maka Use Cases: 5 Practical Applications for Local AI Workflows](/apache/maka/apache-maka-use-cases)

Explore Apache Maka use cases for secure AI automation in development, data processing, and research. Discover 5 practical applications for local AI workflows with Maka.

- Tags: use-cases
- Published: 2026-09-13

### [How to Integrate Apache Maka with Other Systems: A Complete Developer Guide](/apache/maka/integrate-maka-with-other-systems)

Learn how to integrate Apache Maka with other systems using its Runtime Host for seamless session management backend registration and turn execution. Master Apache Maka integration today.

- Tags: how-to-guide
- Published: 2026-09-13

### [What Kind of Data Does Apache Maka Process? A Complete Guide to Its Data Pipeline](/apache/maka/maka-data-processing)

Discover the nine data categories Apache Maka processes, from user prompts and session metadata to binary artifacts and sandbox configurations. Understand Maka's data pipeline.

- Tags: deep-dive
- Published: 2026-09-13

### [How Does Apache Maka Work? Architecture, Event Log, and Runtime Host Explained](/apache/maka/how-does-apache-maka-work)

Explore Apache Maka's architecture, event log, and runtime host. Discover how this agent workspace enables deterministic UI, crash recovery, and multi-agent coordination.

- Tags: architecture
- Published: 2026-09-13

### [What Are the Core Components of Apache Maka?](/apache/maka/apache-maka-core-components)

Explore the ten core components of Apache Maka. Understand its layered architecture, runtime host, session identity, and tool execution for efficient data processing.

- Tags: getting-started
- Published: 2026-09-13

### [How to Configure Apache Maka: Complete Guide to Settings.json, CLI, and UI](/apache/maka/how-to-configure-apache-maka)

Learn to configure Apache Maka using settings.json, CLI, and UI. This comprehensive guide covers all essential settings for your Apache Maka instance.

- Tags: how-to-guide
- Published: 2026-09-13

### [Prerequisites for Running Apache Maka: Complete Setup Guide](/apache/maka/maka-prerequisites)

Discover the essential prerequisites for running Apache Maka. Install Node.js 22.19+, npm 11, Git, and ripgrep for a smooth setup. Learn about optional Rust requirements.

- Tags: getting-started
- Published: 2026-09-13

### [How to Build Apache Maka from Source: A Complete Development Guide](/apache/maka/how-to-build-apache-maka)

Learn how to build Apache Maka from source with this guide. Install Node 22+, clone the repo, and run npm commands to build the desktop or CLI application.

- Tags: how-to-guide
- Published: 2026-09-13

### [How to Enable Resuming an Interrupted Turn in Apache Maka](/apache/maka/how-to-enable-resuming-an-interrupted-turn-in-maka)

Enable Maka's interrupted turn resume feature by setting MAKA_RUNTIME_SAFE_BOUNDARY_RESUME=1. Restart Maka to use UI, CLI, or API for seamless continuation.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Refresh the Model Metadata Catalog in Apache Maka](/apache/maka/how-to-refresh-the-model-metadata-catalog-in-maka)

Refresh the model metadata catalog in Apache Maka using npm run sync:model-metadata -- --refresh. Fetch, validate, and regenerate catalog files efficiently.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Run the Apache Maka TUI or a One-Shot Turn from Source](/apache/maka/how-to-run-the-tui-or-a-one-shot-turn-from-a-maka-source-checkout)

Learn to run the Apache Maka TUI or a one-shot turn from source. Clone the repo, install dependencies, build the CLI, and execute for interactive use or single commands.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Enable the Peer-Enabled Entry Point in Apache Maka: Direct Peer + Mesh Setup](/apache/maka/how-to-enable-the-peer-enabled-entry-point-in-maka)

Learn how to enable the peer-enabled entry point in Apache Maka with direct peer and mesh setup. Configure environment variables and compile native addons for seamless integration.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Start the Desktop Development Environment with HMR in Apache Maka](/apache/maka/how-to-start-the-desktop-development-environment-with-hmr-in-maka)

Start the Maka Desktop development environment with HMR by running npm run dev. Enjoy instant reloads and incremental builds with Vite and Electron for a faster workflow.

- Tags: getting-started
- Published: 2026-09-12

### [How Apache Maka Handles Multiple Cell Attempts: Selection Logic and Best-Attempt Resolution](/apache/maka/how-are-cell-attempts-handled-when-multiple-exist-in-maka)

Discover how Apache Maka handles multiple Cell attempts. Learn its selection logic for choosing the best completed or newest attempt.

- Tags: deep-dive
- Published: 2026-09-12

### [What Is an Experiment in Maka's Eval Semantics?](/apache/maka/what-is-an-experiment-in-makas-eval-semantics)

Discover what an Experiment is in Apache Maka's eval semantics. Learn how this reproducible unit of work is defined and executed by the evaluation framework.

- Tags: deep-dive
- Published: 2026-09-12

### [How Maka Handles Secrets and Tool Execution Across Sandbox Boundaries](/apache/maka/how-does-maka-handle-secrets-and-tool-execution-that-requires-crossing-sandbox-boundaries)

Discover how Maka safely handles secrets and tool execution across sandbox boundaries using approved expansions and a secretMaterial structure for enhanced security.

- Tags: internals
- Published: 2026-09-12

### [Where Is Maka's Workspace Data Stored Locally? Apache Maka's Local‑First Directory Layout](/apache/maka/where-is-makas-workspace-data-stored-locally)

Discover where Apache Maka stores your workspace data locally within the Electron userData directory. Learn about the local-first data layout and key files like runtime.sqlite and settings.json.

- Tags: how-to-guide
- Published: 2026-09-12

### [How Maka Is Structured as an npm Workspaces Monorepo: Complete Architecture Guide](/apache/maka/how-is-maka-structured-as-an-npm-workspaces-monorepo)

Discover how Maka uses npm workspaces to structure its monorepo, managing core libraries, UI components, runtime, and more within a single repository for efficient development.

- Tags: architecture
- Published: 2026-09-12

### [How Apache Maka Ensures Data Integrity and Replayability After a Crash](/apache/maka/how-does-maka-ensure-data-integrity-and-replayability-after-a-crash)

Apache Maka safeguards data integrity and replayability post-crash with its append-only ledger and two-phase execution. Discover how Maka ensures zero data loss.

- Tags: internals
- Published: 2026-09-12

### [Runtime Event Log in Apache Maka: The Immutable Truth Backbone](/apache/maka/what-is-the-runtime-event-log-and-its-significance)

Discover the Apache Maka Runtime Event Log, the immutable truth backbone for agent execution. Understand its role as the single source of truth for model messages, tool calls, and results.

- Tags: deep-dive
- Published: 2026-09-12

### [How Apache Maka Handles Evaluation and Benchmarking Semantics: A Technical Deep Dive](/apache/maka/how-does-maka-handle-evaluation-and-benchmarking-semantics)

Explore how Apache Maka handles evaluation and benchmarking semantics. Discover reproducible versions, isolated Docker execution, and structured result verification. Learn more!

- Tags: deep-dive
- Published: 2026-09-12

### [What Is a State Root in Apache Maka? Architecture, Locking, and Persistence Explained](/apache/maka/what-is-a-state-root-in-the-context-of-maka)

Discover State Root in Apache Maka a durable directory and single source of truth for your runtime host's workspace. Learn about its architecture locking and persistence.

- Tags: architecture
- Published: 2026-09-12

### [Why Maka Uses One Runtime Host per State Root: Architecture Explained](/apache/maka/why-is-there-one-runtime-host-per-state-root-in-maka)

Discover why Maka uses one Runtime Host per State Root. Learn how this architecture ensures exclusive write authority, prevents race conditions, and offers a durable coordination point for workspace access.

- Tags: architecture
- Published: 2026-09-12

### [What Is the Agent Graph Control Plane in Apache Maka?](/apache/maka/what-is-the-purpose-of-the-agent-graph-control-plane)

Discover the Agent Graph Control Plane in Apache Maka. Learn how this central layer orchestrates autonomous agents into directed graphs for efficient AI workflows.

- Tags: deep-dive
- Published: 2026-09-12

### [How AgentRun and RuntimeKernel Handle Event Emission in Apache Maka](/apache/maka/how-are-agentrun-and-runtimekernel-involved-in-event-emission)

Discover how Apache Maka's AgentRun orchestrates event emission and RuntimeKernel ensures durable, ordered storage with RuntimeEventStore for audit trails.

- Tags: internals
- Published: 2026-09-12

### [SessionManager Responsibilities in Apache Maka: A Complete Guide to Session Lifecycle and Runtime Coordination](/apache/maka/what-are-the-responsibilities-of-the-sessionmanager)

Discover SessionManager responsibilities in Apache Maka. This guide covers session lifecycle, runtime coordination, creation, persistence, and more. Learn how Maka manages sessions.

- Tags: deep-dive
- Published: 2026-09-12

### [How Peer Mesh Host Connections Work in Apache Maka](/apache/maka/how-does-peer-mesh-work-in-maka-for-host-connections)

Explore how Apache Maka's Peer Mesh subsystem facilitates host connections through a verified, persistent network using JSON and signed invitations.

- Tags: internals
- Published: 2026-09-12

### [Understanding the Runtime Spine Pipeline in Apache Maka](/apache/maka/what-is-the-runtime-spine-pipeline-in-maka)

Discover the runtime spine pipeline in Apache Maka an immutable event log that guarantees deterministic AI replay and centralized cost control.

- Tags: deep-dive
- Published: 2026-09-12

### [How Apache Maka Uses Event Sourcing for Agent Runtime Persistence](/apache/maka/how-does-apache-maka-use-event-sourcing-for-its-runtime)

Discover how Apache Maka leverages event sourcing with an immutable SQLite log to create a single source of truth for agent runtime persistence and state.

- Tags: internals
- Published: 2026-09-12

### [What Is Apache Maka? Understanding the "Log Is the Runtime" Architecture](/apache/maka/what-is-apache-maka-and-its-core-principle)

Discover Apache Maka, an agent-centric workspace using a Runtime Event Log as its single source of truth for deterministic replay, transparent debugging, and verifiable benchmarking.

- Tags: getting-started
- Published: 2026-09-12

### [How Is Maka Licensed? Apache 2.0 Terms and Verification Guide](/apache/maka/how-is-maka-licensed)

Understand Maka's licensing with our guide to the Apache 2.0 terms. Verify its license easily within the repository for full compliance.

- Tags: getting-started
- Published: 2026-09-11

### [How Apache Maka Differs From Other Agent Frameworks: A Deep Architectural Comparison](/apache/maka/difference-between-maka-and-other-agent-frameworks)

Explore how Apache Maka's unique immutable workspace artifacts, deterministic sandboxing, versioning, and cost telemetry set it apart from other agent frameworks. Discover a new architectural approach.

- Tags: deep-dive
- Published: 2026-09-11

### [What Problem Does Apache Maka Solve? Complete Auditability for AI Agent Workflows](/apache/maka/what-problem-does-apache-maka-solve)

Apache Maka ensures complete auditability for AI agent workflows by creating an append-only record of every action, enabling efficient LLM inference.

- Tags: deep-dive
- Published: 2026-09-11

### [Apache Maka Examples: How to Use the Agent Workspace (Desktop, TUI, and CLI)](/apache/maka/are-there-examples-of-how-to-use-apache-maka)

Explore Apache Maka examples for Desktop, TUI, and CLI agent workspaces. Learn how Maka's Runtime Host executes tasks and records immutable RuntimeEvents for robust auditing.

- Tags: examples
- Published: 2026-09-11

### [Apache Maka Security Considerations: Trust Model, Boundaries, and Best Practices](/apache/maka/what-are-security-considerations-for-apache-maka)

Explore Apache Maka security considerations including trust models, boundaries, and best practices for secure application development. Learn how Maka protects your systems.

- Tags: security-considerations
- Published: 2026-09-11

### [How Are Agents Managed Within the Maka Workspace? Event-Driven Architecture Explained](/apache/maka/how-are-agents-managed-within-maka-workspace)

Discover how Maka manages agents as immutable event streams in SQLite. Learn about event replay and Runtime Host orchestration for robust agent management in Apache Maka.

- Tags: architecture
- Published: 2026-09-11

### [Apache Maka Roadmap: A Complete Guide to the Incubating Project's Development Plans](/apache/maka/what-is-roadmap-for-apache-maka-incubating)

Explore the Apache Maka roadmap for this incubating project. Discover development plans and track component updates to stay informed on Maka's evolution. Learn more now.

- Tags: roadmap
- Published: 2026-09-11

### [What Types of Agents Can Be Developed for Apache Maka: A Complete Guide](/apache/maka/what-kind-of-agents-can-be-developed-for-apache-maka)

Explore the diverse agent types for Apache Maka including coding assistants, search bots, and custom harnesses. Learn how Maka's interfaces enable flexible agent development.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Contribute to Apache Maka: A Complete Guide for New Contributors](/apache/maka/how-can-i-contribute-to-apache-maka-project)

Contribute to Apache Maka by cloning the repo, installing Node dependencies, building workspaces, and submitting a PR. Your first contribution starts here.

- Tags: how-to-guide
- Published: 2026-09-11

### [Apache Maka API Documentation: Complete Guide to Public Interfaces and Runtime Usage](/apache/maka/is-there-documentation-for-apache-maka-api)

Explore the Apache Maka API documentation for public interfaces and runtime usage. Master session management with SessionManager and orchestrate turns efficiently.

- Tags: api-reference
- Published: 2026-09-11

### [Apache Maka Build Dependencies: Complete Guide to Compiling from Source](/apache/maka/what-are-dependencies-for-building-apache-maka)

Master Apache Maka build dependencies and compile from source. Discover essential tools like Nodejs npm Rust Git ripgrep and platform-specific linkers for a smooth build process.

- Tags: how-to-guide
- Published: 2026-09-11

### [How the Maka Agent Workspace Architecture Works: Single-Authority Execution and Isolation](/apache/maka/how-agent-workspace-architecture-works-in-maka)

Explore Maka's agent workspace architecture. Discover how single-authority execution and isolation ensure secure, deterministic agent operations for your projects.

- Tags: architecture
- Published: 2026-09-11

### [Apache Maka High Performance: 8 Core Design Principles Explained](/apache/maka/design-principles-behind-apache-maka-high-performance)

Discover Apache Maka's 8 core design principles for high performance. Learn how its event-driven architecture, immutable logs, and strict boundaries boost efficiency. Read now.

- Tags: performance
- Published: 2026-09-11

### [Can Apache Maka Be Integrated with Other Systems? Technical Architecture and Implementation Guide](/apache/maka/can-apache-maka-be-integrated-with-other-systems)

Discover how Apache Maka integrates with external systems using its modular runtime host, pluggable AI, and WebSocket protocols. Learn about its technical architecture and implementation.

- Tags: architecture
- Published: 2026-09-11

### [Apache Maka Performance Benchmarks: Terminal-Bench 2.1 Results and Evaluation Framework](/apache/maka/what-are-the-performance-benchmarks-for-apache-maka)

Explore Apache Maka performance benchmarks with Terminal-Bench 2.1 results. Discover its impressive 68.54% pass rate and cost-effective execution.

- Tags: performance
- Published: 2026-09-11

### [How Maka Handles Agent Communication: Protocol, Schema, and Runtime Implementation](/apache/maka/how-does-maka-handle-agent-communication)

Discover how Maka handles agent communication with a typed protocol, compact binary schema, and efficient runtime implementation for state, commands, and telemetry.

- Tags: internals
- Published: 2026-09-11

### [Core Functionalities of Apache Maka: A Deep Dive Into the Agent Workspace Architecture](/apache/maka/what-are-the-core-functionalities-of-apache-maka)

Explore Apache Maka's core functionalities and agent workspace architecture. This high-performance tool logs LM actions into a persistent, queryable event log for Desktop, TUI, and CLI.

- Tags: deep-dive
- Published: 2026-09-11

### [How to Set Up an Apache Maka Development Environment: Complete Guide](/apache/maka/how-to-setup-development-environment-for-apache-maka)

Set up your Apache Maka development environment quickly. Follow our guide to install Node.js, clone the repo, install dependencies, and launch your client or CLI in minutes.

- Tags: getting-started
- Published: 2026-09-11

### [What Programming Languages Are Used in Apache Maka?](/apache/maka/what-programming-languages-are-used-in-apache-maka)

Discover the programming languages powering Apache Maka. Learn how TypeScript, JavaScript, and Rust combine for efficient application development and native module integration.

- Tags: getting-started
- Published: 2026-09-11

### [Where to Find Apache Maka Source Files: A Complete Monorepo Guide](/apache/maka/where-to-find-source-files-for-apache-maka)

Find Apache Maka source files on GitHub at apache/maka. Explore the monorepo structure, including desktop apps, core packages, runtime, and native Rust components.

- Tags: how-to-guide
- Published: 2026-09-11

### [Key Packages in Apache Maka: Monorepo Architecture Guide](/apache/maka/what-are-the-key-packages-in-apache-maka)

Explore Apache Maka's key packages, from core contracts to desktop apps. Discover how its monorepo architecture separates layers for composable development.

- Tags: architecture
- Published: 2026-09-11

### [What Is an Agent Workspace in Apache Maka?](/apache/maka/what-is-an-agent-workspace-in-apache-maka)

Discover the agent workspace in Apache Maka. Learn how this local-first directory stores logs, state, config, and artifacts while enforcing sandbox boundaries for your Runtime Host.

- Tags: getting-started
- Published: 2026-09-11

### [How Apache Maka Achieves High Performance: 7 Architectural Optimizations Explained](/apache/maka/how-does-apache-maka-achieve-high-performance)

Discover how Apache Maka achieves high performance with 7 architectural optimizations. Learn how its single-owner Runtime Host eliminates duplication for shared, optimized execution.

- Tags: performance
- Published: 2026-09-11

### [What Is Apache Maka Incubating? The AI Agent Workspace Explained](/apache/maka/what-is-apache-maka-incubating)

Discover Apache Maka Incubating, a high-performance AI agent workspace. It logs every AI task step in an immutable event log. Learn more about this Apache Incubator project.

- Tags: getting-started
- Published: 2026-09-11

### [What Is the Latest Context Projection Input in Apache Maka?](/apache/maka/what-is-purpose-of-latestcontextprojectioninput-in-maka)

Discover the purpose of Latest Context Projection Input in Apache Maka. This read-only structure provides the latest session view for efficient UI rendering.

- Tags: deep-dive
- Published: 2026-09-10

### [Permission-Related Events in Maka: Complete Event Reference](/apache/maka/what-are-permission-related-events-in-maka)

Explore Maka's permission event types like PermissionRequestEvent and PermissionDecisionMessage. Understand how they manage user consent for uninterrupted execution.

- Tags: api-reference
- Published: 2026-09-10

### [How Apache Maka Handles Model Resolution Events: A Deep Dive into the Runtime Pipeline](/apache/maka/how-does-maka-handle-model-resolution-events)

Discover how Apache Maka handles model resolution events through its deterministic runtime pipeline. Learn about configuration, dispatch, adapters, and logging.

- Tags: deep-dive
- Published: 2026-09-10

### [Maka AgentRunEvent Types: Complete Guide to Execution Lifecycle Events](/apache/maka/what-are-key-agentrunevent-types-in-maka)

Explore Maka's eight core AgentRunEvent types including run-start, run-end, tool-invocation, and more. Understand the agent execution lifecycle comprehensively.

- Tags: deep-dive
- Published: 2026-09-10

### [How Apache Maka Projects Linked Session Trees: A Technical Deep Dive](/apache/maka/how-are-linked-session-trees-projected-in-maka)

Learn how Apache Maka projects linked session trees by transforming flat logs into hierarchical views. Explore the `projectLinkedSessionTree` function and its handling of complex session data.

- Tags: deep-dive
- Published: 2026-09-10

### [What Is Graph Mode for Subagents in Maka?](/apache/maka/what-is-graph-mode-for-subagents-in-maka)

Discover Maka's Graph mode for subagents. Learn how this one-turn scheduling mechanism orchestrates child Sessions as a DAG without a second runtime. Optimize your Agent orchestration.

- Tags: deep-dive
- Published: 2026-09-10

### [Understanding Swarm Mode in Maka: Asynchronous Agent Orchestration Explained](/apache/maka/what-is-swarm-mode-in-maka)

Explore Maka Swarm mode for asynchronous agent orchestration. Learn how it enables parallel delegation and lightweight host supervision with the durable Agent Graph.

- Tags: deep-dive
- Published: 2026-09-10

### [How Maka Supports Subagent Sessions: Architecture and Implementation](/apache/maka/how-does-maka-support-subagent-sessions)

Discover how Maka supports subagent sessions with a durable three-layer metadata model in SQLite. Learn about isolated child conversations, idempotent creation, and runtime delegation.

- Tags: architecture
- Published: 2026-09-10

### [Session Status Lifecycles in Apache Maka: Complete Technical Guide](/apache/maka/what-are-session-status-lifecycles-in-maka)

Understand Apache Maka session status lifecycles. Explore active, running, waiting_for_user, blocked, and aborted states managed by the Session Manager's state machine. Master Maka's session flow.

- Tags: deep-dive
- Published: 2026-09-10

### [How Session Identity is Defined in Apache Maka: Architecture and Implementation](/apache/maka/how-is-session-identity-defined-in-maka)

Learn how Apache Maka defines session identity with a human-readable name and an immutable session ID for routing, management, and stream continuity in its peer-mesh runtime.

- Tags: architecture
- Published: 2026-09-10

### [What Is a Session in Maka? A Complete Technical Guide](/apache/maka/what-is-a-session-in-maka)

Learn what a session is in Apache Maka. Understand this core unit for managing conversational threads, tool invocations, and LLM replies with persistent state and metadata.

- Tags: deep-dive
- Published: 2026-09-10

### [What Is the CLI Package in Apache Maka?](/apache/maka/what-is-function-of-cli-package-in-maka)

Discover the CLI package in Apache Maka. It acts as the front-end entry point, offering an interactive TUI and scriptable command-line interface to orchestrate core subsystems.

- Tags: internals
- Published: 2026-09-10

### [What Is the Eval Package in Apache Maka? Understanding Experiment Execution](/apache/maka/what-is-eval-package-used-for-in-maka)

Discover the Maka eval package. Learn how it manages experiment specifications and enables verifiable benchmark runs through its execution framework.

- Tags: deep-dive
- Published: 2026-09-10

### [How the Apache Maka Runtime Package Handles Sessions and Tools](/apache/maka/how-does-runtime-package-in-maka-handle-sessions-and-tools)

Discover how the Apache Maka runtime package enforces session boundaries, persists state with SQLite snapshots, and manages tool lifecycles via a scoped ToolRuntime registry for secure execution.

- Tags: internals
- Published: 2026-09-10

### [What Is the Storage Package in Apache Maka? A Deep Dive into the Persistence Layer](/apache/maka/what-is-the-purpose-of-storage-package-in-maka)

Explore Apache Maka's storage package, the SQLite-backed persistence layer for managing state, config, artifacts, and session data. Learn how Maka ensures data reliability.

- Tags: deep-dive
- Published: 2026-09-10

### [What Is the Responsibility of the Core Package in Apache Maka?](/apache/maka/what-is-the-responsibility-of-core-package-in-maka)

Discover the core package's role in Apache Maka. It defines Maka's platform-neutral data model contract, ensuring seamless communication across all subsystems.

- Tags: internals
- Published: 2026-09-10

### [Apache Maka Monorepo: Complete Guide to the Main Packages in the Repository](/apache/maka/what-are-the-main-packages-in-maka-repository)

Explore the Apache Maka monorepo and discover its ten main npm packages for modular React components, runtime engines, storage, and CLI tooling. Learn about the Maka repository's structure.

- Tags: deep-dive
- Published: 2026-09-10

### [Where to Find Maka Backend Architecture Documentation: Complete Guide to ARCHITECTURE.md and Source Code](/apache/maka/where-can-i-find-maka-backend-architecture-documentation)

Locate Maka backend architecture documentation easily. Find the ARCHITECTURE.md file and explore deep dives in the source code for a complete guide.

- Tags: architecture
- Published: 2026-09-10

### [How Apache Maka Handles Crash Recovery: Safe-Boundary Transactions and Resumption](/apache/maka/how-does-maka-handle-crash-recovery)

Apache Maka ensures crash recovery with three layers: transactions, continuations, and quarantine bundles. Learn how Maka validates state before and after mutations.

- Tags: how-to-guide
- Published: 2026-09-10

### [How Apache Maka Manages Agent Lifecycle: A Deep Dive into RelayAgent](/apache/maka/how-does-maka-manage-agent-lifecycle)

Discover how Apache Maka manages agent lifecycle with RelayAgent's deterministic state machine for safe and isolated command execution. Learn about its process from setup to cleanup.

- Tags: deep-dive
- Published: 2026-09-10

### [Understanding the Runtime Host in Apache Maka: Architecture and Responsibilities](/apache/maka/what-is-the-role-of-runtime-host-in-maka)

Discover the Apache Maka Runtime Host architecture and responsibilities. Learn how this authoritative process ensures single-writer consistency for state roots, with clients acting as thin requesters.

- Tags: architecture
- Published: 2026-09-10

### [What Is a RuntimeEvent in Apache Maka? Complete Guide to the Atomic Event Log](/apache/maka/what-is-runtimeevent-in-maka)

Understand Apache Maka RuntimeEvents, the atomic event log capturing every agent interaction. Discover its role as the immutable source of truth for UI, storage, and replay.

- Tags: deep-dive
- Published: 2026-09-10

### [How Maka’s Log‑Centric Architecture Works: Immutable Events as the Source of Truth](/apache/maka/how-does-maka-log-centric-architecture-work)

Explore Apache Maka's log-centric architecture. Discover how immutable RuntimeEvents serve as the source of truth for agent execution, deriving state through deterministic projections.

- Tags: architecture
- Published: 2026-09-10

### [Context Budget and Compaction in Apache Maka: Managing LLM Token Limits for Long-Running Agents](/apache/maka/context-budget-compaction-apache-maka)

Learn about context budget and compaction in Apache Maka. These features manage LLM token limits for long-running agents, preserving auditable event history. Read more!

- Tags: deep-dive
- Published: 2026-09-09

### [How to Enable Safe Resume Functionality in Apache Maka](/apache/maka/enable-safe-resume-functionality-maka)

Learn how to enable Safe Resume in Apache Maka. Configure the resume_feature_enabled flag and ensure your storage backend supports continuation authority for seamless recovery.

- Tags: how-to-guide
- Published: 2026-09-09

### [How to Configure Network Settings in Apache Maka: Proxies and Timeouts Explained](/apache/maka/configure-network-settings-maka)

Learn how to configure network settings in Apache Maka. Master proxy servers and request timeouts by editing settings.json or using the SettingsStore API for efficient network management.

- Tags: how-to-guide
- Published: 2026-09-09

### [How Runtime Policies Are Encoded and Managed in Apache Maka](/apache/maka/runtime-policies-encoded-managed-maka)

Discover how Apache Maka encodes and manages runtime policies as versioned JSON documents within workspaces, leveraging an immutable mutation pipeline for type-safe, reproducible changes.

- Tags: internals
- Published: 2026-09-09

### [What Happens When a Committed Model or Capability Disappears from Maka's Catalog](/apache/maka/committed-model-capability-disappears-maka-catalog)

Discover what happens when a committed model or capability disappears from Maka's catalog. Learn about catalog-drift events, fallback mechanisms, and session handling.

- Tags: internals
- Published: 2026-09-09

### [How to Refresh Maka's Model Metadata Catalog: A Complete Guide](/apache/maka/refresh-maka-model-metadata-catalog)

Refresh Maka's AI model metadata catalog with a simple command. Learn how to sync the latest data, validate it, and regenerate TypeScript files for the apache mako repository.

- Tags: how-to-guide
- Published: 2026-09-09

### [How API Keys Are Securely Stored in Maka's Credential Vault: A Deep Dive into Apache Maka's Security Model](/apache/maka/securely-store-api-keys-maka-credential-vault)

Learn how Maka securely stores API keys in its credential vault using OS-level file permissions, size limits, and runtime access controls to protect sensitive data.

- Tags: deep-dive
- Published: 2026-09-09

### [Where Is Interactive Runtime State Stored in Apache Maka?](/apache/maka/interactive-runtime-state-storage-apache-maka)

Discover where Apache Maka stores interactive runtime state. Learn about its user-private storage, cache directory, and the `@maka/storage` package for efficient state management.

- Tags: internals
- Published: 2026-09-09

### [Build Requirements for Maka's Peer Mesh Native Addon: Complete Setup Guide](/apache/maka/build-requirements-maka-peer-mesh-native-addon)

Build Maka's Peer Mesh native addon by meeting Rust 1.98+, Node.js 18+, C/C++ compilers, and Python 3.7+ requirements. Learn how to compile the addon and generate the .node binary.

- Tags: how-to-guide
- Published: 2026-09-09

### [How to Set Up Peer Mesh Communication in Apache Maka](/apache/maka/setup-peer-mesh-communication-maka)

Learn to set up Peer Mesh communication in Apache Maka for secured, decentralized host discovery. Join via invitations and maintain synchronized state easily.

- Tags: how-to-guide
- Published: 2026-09-09

### [How Apache Maka Discovers and Loads MCP Servers: A Complete Technical Guide](/apache/maka/maka-discover-load-mcp-servers)

Learn how Apache Maka discovers and loads MCP servers. This guide details the McpConfigStore, protocol resolution, ToolDiscovery pipeline, and RuntimeHost registration for efficient server management.

- Tags: how-to-guide
- Published: 2026-09-09

### [What Is the Model Context Protocol (MCP) in Apache Maka?](/apache/maka/model-context-protocol-mcp-apache-maka)

Discover the Model Context Protocol MCP in Apache Maka. Learn how this provider-neutral protocol enables secure, versioned communication with external tools via standardized JSON and runtime proxies.

- Tags: deep-dive
- Published: 2026-09-09

### [How to Implement a Custom Bot Adapter for Maka](/apache/maka/implement-custom-bot-adapter-maka)

Learn how to implement a custom Bot Adapter for Maka by implementing ExternalSessionAdapter and registering it. Effortlessly manage bot sessions with your custom solution.

- Tags: how-to-guide
- Published: 2026-09-09

### [How Maka Integrates with Messaging Platforms via Bot Bridges: Architecture and Implementation Guide](/apache/maka/maka-integrate-messaging-platforms-bot-bridges)

Explore how Maka integrates with messaging platforms using Bot Bridges. Learn about the architecture, central BotRegistry management, and bidirectional message routing for seamless communication.

- Tags: architecture
- Published: 2026-09-09

### [How to Create Child Agents and Schedulers in Apache Maka](/apache/maka/create-child-agents-schedulers-maka)

Learn to create child agents and schedulers in Apache Maka using agent_spawn tool. Manage timers retries and cron tasks efficiently with Maka's scheduler.

- Tags: how-to-guide
- Published: 2026-09-09

### [How to Configure an Experiment in Maka’s Eval Framework: Complete Guide with Examples](/apache/maka/configure-experiment-maka-eval-framework)

Configure Maka experiments easily using experiment.json. This guide shows how to define benchmarks, executors, subjects, and tasks to run your benchmarks.

- Tags: how-to-guide
- Published: 2026-09-09

### [Maka Eval Framework Semantics: Goal Evaluation, Continuation, and Host Runtime](/apache/maka/maka-eval-framework-semantics)

Explore Maka Eval Framework semantics for deterministic, cancellable goal evaluation. Learn how the typed API supports retries, progress propagation, and lifecycle management for thin-client front-ends.

- Tags: deep-dive
- Published: 2026-09-09

### [How to Request a Sandbox Boundary in Apache Maka: A Complete Guide](/apache/maka/request-sandbox-boundary-maka)

Learn how to request a sandbox boundary in Apache Maka by configuring an ExecutionBoundary profile and approving the prompt. A complete guide for developers.

- Tags: how-to-guide
- Published: 2026-09-09

### [How Maka Handles Tool Execution Sandbox Boundary Crossings](/apache/maka/maka-handle-sandbox-boundary-crossings)

Discover how Maka manages tool execution sandbox boundary crossings with its deterministic six-step workflow, featuring platform-specific backends like Seatbelt, bubblewrap, and AppContainer.

- Tags: internals
- Published: 2026-09-09

### [Execution Flow Through Maka's Runtime Core: How AgentRun Orchestrates AI Turns](/apache/maka/maka-runtime-core-execution-flow)

Discover Maka's runtime core execution flow. AgentRun orchestrates AI turns through a six-stage pipeline from initialization to finalization. Understand how Maka processes agent actions.

- Tags: internals
- Published: 2026-09-09

### [How to Define a Custom RuntimeEvent in Apache Maka](/apache/maka/define-custom-runtimeevent-apache-maka)

Learn how to define a custom RuntimeEvent in Apache Maka. Declare a payload interface, extend RuntimeEvent, and emit using RuntimeEventStore append for custom event handling.

- Tags: how-to-guide
- Published: 2026-09-09

### [What Is the Runtime Event Log in Apache Maka? The Single Source of Truth for Agent Execution](/apache/maka/role-of-runtime-event-log-apache-maka)

Discover the Apache Maka Runtime Event Log, the immutable record of agent execution facts. Learn how this single source of truth enables replay, recovery, and state projections.

- Tags: deep-dive
- Published: 2026-09-09

### [How Apache Maka's Event-Sourced Architecture Works: A Deep Dive into the Runtime Event Log](/apache/maka/how-apache-maka-event-sourced-architecture-works)

Explore Apache Maka's event-sourced architecture. Learn how its append-only SQLite event log stores immutable RuntimeEvents and derives application state through projections.

- Tags: deep-dive
- Published: 2026-09-09

### [How to Enable Safe Resume for Maka Sessions: A Complete Configuration Guide](/apache/maka/how-can-i-enable-safe-resume-for-maka-sessions)

Enable safe resume for Maka sessions by setting MAKA_RUNTIME_SAFE_BOUNDARY_RESUME=1. Follow this complete configuration guide for a seamless Maka experience.

- Tags: how-to-guide
- Published: 2026-09-08

### [How Maka Attributes Sandbox Boundary Restarts to Specific Runs: Session Recovery Explained](/apache/maka/how-does-maka-attribute-sandbox-boundary-restarts-to-specific-runs)

Maka attributes sandbox boundary restarts to specific runs by persisting host_restarted reason in session store. Learn how this recovery process tags affected turns and invocations.

- Tags: internals
- Published: 2026-09-08

### [How Maka Classifies Agent Run Recovery After a Crash](/apache/maka/how-does-maka-classify-agent-run-recovery-after-a-crash)

Discover how Maka classifies agent run recovery after a crash. Maka inspects the AgentRun ledger to determine the best recovery action resume retry or escalate.

- Tags: internals
- Published: 2026-09-08

### [How Apache Maka Handles Multi-Agent Coordination: Runtime Host and Agent Graph Architecture](/apache/maka/how-does-maka-handle-multi-agent-coordination)

Discover how Apache Maka handles multi-agent coordination with its Runtime Host and Agent Graph architecture. Learn about session scheduling and WorkHub communication for efficient agent management.

- Tags: architecture
- Published: 2026-09-08

### [What Does a Turn Represent in Maka's Session Architecture](/apache/maka/what-does-a-turn-represent-in-maka-s-session-architecture)

Understand what a Turn represents in Apache Maka's session architecture. Learn how this immutable unit captures the entire agent-runtime interaction cycle, from input to completion.

- Tags: internals
- Published: 2026-09-08

### [Why Is My Maka Session Blocked? Complete Guide to BlockedReason Codes and Causes](/apache/maka/what-are-the-reasons-a-maka-session-might-be-blocked)

Troubleshoot blocked Maka sessions. Understand common causes like missing config, bad credentials, and permission errors. Resolve your Maka session issues fast.

- Tags: how-to-guide
- Published: 2026-09-08

### [Maka Session States Explained: Lifecycle vs. CUA Statuses](/apache/maka/what-are-the-different-states-a-maka-session-can-be-in)

Understand Maka session states including lifecycle (absent, live, terminal) and CUA statuses (unobserved, active, etc.) to manage UI interaction permissions effectively.

- Tags: internals
- Published: 2026-09-08

### [How Apache Maka Manages Experiments and Evaluations: A Technical Deep Dive](/apache/maka/how-are-experiments-and-evaluations-managed-in-maka)

Learn how Apache Maka manages experiments and evaluations using JSON specs and a dedicated framework. Explore schema validation, concurrency, and distributed results aggregation for efficient ML workflows.

- Tags: deep-dive
- Published: 2026-09-08

### [What Is the Function of the packages/runtime-host Package in Apache Maka?](/apache/maka/what-is-the-function-of-the-packages-runtime-host-package)

Discover the Maka Runtime Host package in Apache Maka. This vital component enables remote Maka clients to access your State Root and Projects via secure WebSocket.

- Tags: internals
- Published: 2026-09-08

### [What Does the `packages/runtime` Package Handle in Apache Maka?](/apache/maka/what-does-the-packages-runtime-package-handle)

Discover how the packages runtime in Apache Maka powers Node agent execution. It manages model runs, sandboxing, event projection, and more for stateful AI agents.

- Tags: internals
- Published: 2026-09-08

### [What Is the Model Context Protocol (MCP) in Maka?](/apache/maka/what-is-the-model-context-protocol-mcp-in-maka)

Discover the Model Context Protocol MCP in Maka, a provider-neutral protocol unifying external tool connectors as native MakaTools through a single execution boundary.

- Tags: deep-dive
- Published: 2026-09-08

### [How Operational State and Configuration Management Works in Apache Maka](/apache/maka/how-is-operational-state-and-configuration-managed-in-maka)

Learn how Apache Maka manages operational state and configuration using a robust SQLite database with lease-based API, automatic schema versioning, and atomic transactions for reliable data consistency.

- Tags: internals
- Published: 2026-09-08

### [Understanding the Purpose of `packages/core` in Apache Maka](/apache/maka/what-is-the-purpose-of-the-packages-core-in-maka)

Discover the purpose of packages/core in Apache Maka. This module defines immutable data structures and validation logic, ensuring a single source of truth for all inter-package communication.

- Tags: internals
- Published: 2026-09-08

### [How the Apache Maka Tool Runtime Handles Tool Execution and Sandboxing](/apache/maka/how-does-the-tool-runtime-handle-tool-execution-and-sandboxing)

Discover how Apache Maka's Tool Runtime executes tools securely. Learn about its deterministic pipeline, event emission, and robust sandboxing for isolated operations.

- Tags: internals
- Published: 2026-09-08

### [What Is AgentRun in Apache Maka? A Deep Dive into the Execution Engine](/apache/maka/what-is-the-role-of-agentrun-in-maka)

Explore AgentRun, Apache Maka's core execution engine. Understand its role in agent lifecycle management, tool orchestration, and deterministic recovery for robust AI agent operations.

- Tags: deep-dive
- Published: 2026-09-08

### [How SessionManager Orchestrates Agent Sessions in Apache Maka: A Deep Dive into the Runtime Façade](/apache/maka/how-does-the-sessionmanager-orchestrate-agent-sessions)

Discover how Apache Maka's SessionManager orchestrates agent sessions, managing their lifecycle from persistence to execution via its runtime facade.

- Tags: deep-dive
- Published: 2026-09-08

### [What Is the Runtime Host in Apache Maka? Responsibilities and Architecture](/apache/maka/what-is-the-responsibility-of-the-runtime-host-in-maka)

Discover the Runtime Host's critical role in Apache Maka. It manages session identity, agent lifecycle, tool execution, permissions, and event logging as the sole execution authority.

- Tags: architecture
- Published: 2026-09-08

### [Main Backend System Components in Apache Maka: Architecture and Package Guide](/apache/maka/what-are-the-main-backend-system-components-in-maka)

Explore Apache Maka's backend system components. Understand the Runtime Host and six specialized packages that power its core protocols, storage, scheduling, and more.

- Tags: architecture
- Published: 2026-09-08

### [What Is the Runtime Event Log in Maka? Architecture and Usage Guide](/apache/maka/what-is-the-purpose-of-the-runtimeevent-log-in-maka)

Discover the Maka Runtime Event Log its architecture and usage. This immutable log records agent execution facts for system state reproducibility replay and checkpointing.

- Tags: architecture
- Published: 2026-09-08

### [How Apache Maka Achieves Reproducible Agent Behavior: Architecture Deep Dive](/apache/maka/how-does-maka-achieve-reproducible-agent-behavior)

Discover how Apache Maka ensures reproducible agent behavior with its immutable Runtime Event Log, atomic admission, and side-effect-free projections. Learn more.

- Tags: architecture
- Published: 2026-09-08

### [Crash Recovery in Apache Maka: Event Sourcing and Atomic Storage Guarantees](/apache/maka/explain-crash-recovery-in-apache-maka)

Learn about crash recovery in Apache Maka. Discover how event sourcing and atomic storage ensure zero data loss by replaying events and discarding incomplete writes on restart.

- Tags: deep-dive
- Published: 2026-09-08

### [How Apache Maka Ensures Auditability of Agent Operations](/apache/maka/how-does-apache-maka-ensure-auditability-of-agent-operations)

Apache Maka ensures agent operation auditability with an immutable RuntimeEvent log, providing a reliable source of truth for every action. Discover how Maka guarantees transparency and accountability.

- Tags: internals
- Published: 2026-09-08

### [Apache Maka's Architecture: The Single-Execution-Authority Model](/apache/maka/what-is-the-core-principle-of-apache-maka-s-architecture)

Explore Apache Maka's core principle: a single-execution-authority model. Discover how its Runtime Host centralizes work execution for efficient, thin-client operations.

- Tags: architecture
- Published: 2026-09-08

### [How Mako's Credential Vault Protects Secrets Using OS-Level Account Boundaries](/apache/maka/how-mako-credential-vault-protects-secrets)

Discover how Mako's credential vault secures secrets with OS-level account boundaries. Learn how strict filesystem permissions ensure only the owner accesses sensitive credentials.

- Tags: security
- Published: 2026-09-06

### [How Mako Enforces Sandboxed Execution and File System Restrictions for Tools](/apache/maka/how-mako-enforces-sandboxed-execution)

Learn how Mako enforces sandboxed execution and file system restrictions for tools using Windows AppContainers and runtime policies. Discover Mako's security features.

- Tags: internals
- Published: 2026-09-06

### [Performance-Critical Functionalities in Apache Maka's Rust Native Modules](/apache/maka/performance-critical-functionalities-rust-native-modules-mako)

Discover performance critical functionalities in Apache Maka's Rust native modules including WebRTC, DHT relay discovery, and Gitoxide helpers. Optimize real-time distributed workloads.

- Tags: performance
- Published: 2026-09-06

### [How Mako Renders Conversation State in Its Terminal UI (TUI): A Deep Dive into the Transcript Pipeline](/apache/maka/how-mako-renders-conversation-state-tui)

Discover how Mako renders conversation state in its TUI through a three-stage pipeline: entry memoization, document aggregation, and terminal viewer output for efficient visualization.

- Tags: deep-dive
- Published: 2026-09-06

### [Mako CLI Modes of Operation: Complete Guide to 14 Command Patterns](/apache/maka/different-modes-operation-mako-cli)

Explore Mako CLI modes of operation: interactive TUI, single-shot execution, ACP protocol server, Runtime Host, credential management, profiles, and utilities. Master 14 command patterns.

- Tags: how-to-guide
- Published: 2026-09-06

### [How Mako Reconstructs Execution State After a Crash Using SQLite and the Event Log](/apache/maka/how-mako-reconstructs-execution-state-after-crash)

Learn how Mako guarantees deterministic crash recovery by rebuilding sessions from an immutable event log stored in SQLite. Ensure reliable execution state reconstruction after failures.

- Tags: internals
- Published: 2026-09-06

### [Mako SQLite Schema for Operational State Persistence: Complete Technical Reference](/apache/maka/sqlite-schema-mako-operational-state-persistence)

Explore the Mako SQLite schema for operational state persistence. This technical reference details the six coordinated schemas managing workflow, runtime, session metadata, core execution, usage, and artifact data.

- Tags: api-reference
- Published: 2026-09-06

### [How Mako's Computer-Use Module Interacts with Browsers Using Chrome DevTools Protocol (CDP)](/apache/maka/how-mako-computer-use-interacts-browsers-cdp)

Discover how Mako's computer-use module leverages Chrome DevTools Protocol (CDP) via a secured WebSocket to enable AI-driven browser automation within an Electron window.

- Tags: how-to-guide
- Published: 2026-09-06

### [Apache Mako `computer-use` Package: Browser Automation Capabilities Explained](/apache/maka/browser-automation-capabilities-computer-use-package)

Explore Apache Mako's computer-use package for powerful browser automation. Discover how language models interact with UI elements via accessibility, no coordinates needed.

- Tags: deep-dive
- Published: 2026-09-06

### [How Mako Ensures Security During Evaluation Runs with Its Defense‑in‑Depth Model](/apache/maka/how-mako-ensures-security-during-evaluation)

Mako ensures evaluation run security with its defense-in-depth model. Discover layered controls like process isolation, sandboxed tokens, and immutable audit logging.

- Tags: security
- Published: 2026-09-06

### [Mako Evaluation Framework: Understanding Experiments, Cells, and Attempts](/apache/maka/key-concepts-mako-evaluation-framework)

Master Mako's evaluation framework. Understand Experiments, Cells, and Attempts for reproducible benchmark runs. Learn the core abstractions of apache/maka.

- Tags: deep-dive
- Published: 2026-09-06

### [How Retention Policies Are Configured in Mako's Context Management](/apache/maka/how-retention-policies-configured-mako-context-management)

Discover how Mako configures retention policies using terminal scroll-back limits and runtime-policy size constraints. Learn to manage data effectively.

- Tags: how-to-guide
- Published: 2026-09-06

### [LLM Compaction in Apache Maka: How It Manages Context Windows Without Losing History](/apache/maka/what-is-llm-compaction-mako)

Discover LLM Compaction in Apache Maka, a projection technique that compresses chat history for limited context windows without losing critical information. Learn how Maka maintains auditability.

- Tags: deep-dive
- Published: 2026-09-06

### [How Mako Manages Context and Token Budgets for LLM Interactions: A Deep Dive into the Runtime Budget System](/apache/maka/how-mako-manages-context-token-budgets)

Discover how Mako manages LLM context and token budgets with its innovative Runtime Budget System. Learn about token estimation, pruning, and history compaction for efficient AI interactions.

- Tags: deep-dive
- Published: 2026-09-06

### [MCP Integration in Mako's Tool System: How External Tools Become First-Class Citizens](/apache/maka/purpose-of-mcp-integration-mako-tool-system)

Discover how MCP integration in Mako transforms external tools into first-class citizens. Load and execute remote tools seamlessly within Mako's runtime.

- Tags: deep-dive
- Published: 2026-09-06

### [How Mako Runtime Implements Bash, Read, and Write Built-In Tools](/apache/maka/how-built-in-tools-implemented-mako-runtime)

Discover how Mako runtime implements Bash, Read, and Write built-in tools within sandboxed environments. Learn about MakaTool objects and execution context enforcement.

- Tags: internals
- Published: 2026-09-06

### [Stream Graph Scheduling in Mako: How It Enables Parallel Execution Without a New Runtime](/apache/maka/what-is-stream-graph-scheduling-mako)

Discover Stream Graph scheduling in Mako. Achieve parallel execution without a new runtime by treating your execution graph as a durable schedule. Learn how Mako simplifies task parallelism.

- Tags: deep-dive
- Published: 2026-09-06

### [How the Agent Graph in Mako Enables Declarative Scheduling](/apache/maka/how-agent-graph-facilitates-declarative-scheduling)

Discover how the Mako Agent Graph transforms declarative goals into a persistent execution graph. It automates retries and ordering for reliable, exactly-once task execution.

- Tags: internals
- Published: 2026-09-06

### [Understanding the Two Scheduling Mechanisms in Mako for Multi-Agent Workflows](/apache/maka/two-scheduling-mechanisms-mako-multi-agent)

Explore Mako's two scheduling mechanisms: Explicit Workflow-Graph for DAG execution and Mailbox for dynamic orchestration in multi-agent workflows.

- Tags: deep-dive
- Published: 2026-09-06

### [How Mako's SessionManager Manages the AI Agent Session Lifecycle: A Complete Guide](/apache/maka/how-sessionmanager-manages-session-lifecycle)

Master Mako's SessionManager and its four phases for orchestrating AI agent session lifecycles. Learn creation, tracking, mutations, and termination.

- Tags: how-to-guide
- Published: 2026-09-06

### [Mako Immutable Event Log Reproducibility: A Technical Deep Dive](/apache/maka/benefits-of-immutable-event-log-for-reproducibility)

Explore Mako's immutable event log for reproducible machine learning. Achieve deterministic replay and cryptographic auditability across distributed sessions with this tamper-proof record.

- Tags: deep-dive
- Published: 2026-09-06

### [How Apache Mako Achieves Crash Recovery for AI Agent Sessions: A Three-Layer Persistence Architecture](/apache/maka/how-mako-achieves-crash-recovery)

Discover how Apache Mako ensures AI agent sessions survive crashes. Learn about its three-layer persistence architecture and deterministic replay for robust session recovery.

- Tags: internals
- Published: 2026-09-06

### [What Is the Runtime Event Log in Apache Maka?](/apache/maka/role-of-runtime-event-log-in-apache-mako)

Discover the Runtime Event Log in Apache Mako. This immutable ledger is your single source of truth for agent facts, ensuring deterministic recovery and driving model context.

- Tags: deep-dive
- Published: 2026-09-06

### [How Apache Maka Ensures Consistency Across Desktop, TUI, and CLI Interfaces](/apache/maka/how-apache-mako-ensures-consistency-across-interfaces)

Discover how Apache Maka guarantees consistent behavior across Desktop, TUI, and CLI interfaces by centralizing execution on a single Runtime Host and sharing protocol definitions and rendering libraries.

- Tags: architecture
- Published: 2026-09-06

### [Maka Sandbox Requirements: Rules for Requiring a Platform Sandbox](/apache/maka/rules-for-requiring-platform-sandbox-in-maka)

Discover Maka's platform sandbox requirements. Learn the three key conditions that trigger a sandbox when permission profiles are managed and policies are restricted.

- Tags: how-to-guide
- Published: 2026-09-05

### [How SandboxManager Selects the Platform Backend for Sandboxing in Apache Maka](/apache/maka/how-sandboxmanager-selects-platform-backend-for-sandboxing)

Learn how SandboxManager selects a platform backend for sandboxing in Apache Maka. Discover its three-step decision process for secure command execution.

- Tags: internals
- Published: 2026-09-05

### [PermissionProfileCompiler in Apache Maka: How It Compiles Permission Profiles for Secure Execution](/apache/maka/function-of-permissionprofilecompiler)

Discover how the PermissionProfileCompiler in Apache Maka compiles permission profiles. Learn how it transforms modes like explore ask or bypass into a fully-qualified PermissionProfile for secure tool execution.

- Tags: internals
- Published: 2026-09-05

### [How Permission Profiles Define Access Controls in Apache Maka](/apache/maka/how-permissionprofile-defines-access-controls-in-maka)

Learn how Apache Maka's PermissionProfile defines filesystem, network, and environment access controls. Understand how it creates runtime sandbox policies.

- Tags: deep-dive
- Published: 2026-09-05

### [What Does the ExecutionBoundary Define in Maka? Understanding the Security Model](/apache/maka/what-executionboundary-defines-in-maka)

Understand the Maka ExecutionBoundary, its security model, and how it controls filesystem and network permissions for sessions and tools. Learn about its typed object variants.

- Tags: deep-dive
- Published: 2026-09-05

### [What Is the Sandbox Boundary Language in Apache Maka? Purpose and Implementation Guide](/apache/maka/purpose-sandbox-boundary-language-maka)

Discover the sandbox boundary language in Apache Maka. Learn its purpose for defining session permissions and how it ensures runtime enforcement for secure expansions.

- Tags: deep-dive
- Published: 2026-09-05

### [How Maka Maps SessionEvents to RuntimeEvents: A Deep Dive into the Transformation Layer](/apache/maka/how-maka-maps-sessionevents-to-runtimeevents)

Discover how Maka transforms SessionEvents into RuntimeEvents via its deterministic mapping layer. Understand the core logic in the Maka repository and enhance your event processing.

- Tags: deep-dive
- Published: 2026-09-05

### [How ToolRuntime Manages Tool Execution in Apache Maka: A Deep Dive into the Five-Phase Architecture](/apache/maka/how-toolruntime-manages-tool-execution-in-maka)

Discover how ToolRuntime orchestrates tool execution in Apache Maka using its five-phase pipeline: preparation, admission, execution, result processing, and error handling. Learn about its cancellation and compensation features.

- Tags: deep-dive
- Published: 2026-09-05

### [What Is the ModelAdapter in Maka? Architecture and Responsibilities](/apache/maka/role-of-modeladapter-in-maka)

Discover the ModelAdapter in Maka. Learn how it bridges Maka's runtime with AI-SDK providers, normalizing interfaces, translating data, and managing configurations for efficient AI integration.

- Tags: architecture
- Published: 2026-09-05

### [How the AiSdkBackend Handles the Model/Tool Loop in Apache Maka](/apache/maka/how-aisdkbackend-handles-model-tool-loop)

Discover how the AiSdkBackend in Apache Maka manages the AI model tool loop. It uses AiSdkTurn instances to stream responses, execute tools, and retry requests for seamless completion.

- Tags: internals
- Published: 2026-09-05

### [How AgentRun Ensures Execution Durability in Apache Maka](/apache/maka/how-agentrun-ensures-durability-of-execution)

AgentRun ensures execution durability in Apache Maka by validating persistence stores, staging events with tiered durability, and enforcing a terminal barrier for canonical persistence.

- Tags: internals
- Published: 2026-09-05

### [Lifecycle of an AgentRun in Maka: From Construction to Finalization](/apache/maka/lifecycle-of-agentrun-in-maka)

Explore the ten stages of an AgentRun lifecycle in Maka, from construction to finalization. Understand how Maka ensures durable, traceable, and auditable agent turns.

- Tags: internals
- Published: 2026-09-05

### [How RuntimeKernel Manages AgentRun Instances in Apache Maka](/apache/maka/how-runtimekernel-manages-agentrun-instances)

Discover how Apache Maka's RuntimeKernel orchestrates AgentRun instances, managing their lifecycle from creation to persistence and resumption for durable execution.

- Tags: internals
- Published: 2026-09-05

### [What Is RuntimeKernel in Maka? The Internal Execution Engine Explained](/apache/maka/purpose-of-runtimekernel-in-maka)

Discover Maka's RuntimeKernel, the internal execution engine. It orchestrates turns, ensures durability, and offers crash recovery while maintaining API compatibility.

- Tags: internals
- Published: 2026-09-05

### [How SessionManager Delegates Execution in Apache Maka: Architecture and Flow](/apache/maka/how-sessionmanager-delegates-execution-in-maka)

Discover how Apache Maka's SessionManager delegates execution to RuntimeKernel, BackendRegistry, and AgentGraphExecutor. Learn about its architecture and flow.

- Tags: architecture
- Published: 2026-09-05

### [SessionManager in Maka: Core Responsibilities and Runtime Architecture](/apache/maka/responsibility-of-sessionmanager-in-maka)

Discover SessionManager in Apache Maka. Learn its core responsibilities in orchestrating persistence sandboxing and backend communication for session lifecycle management.

- Tags: architecture
- Published: 2026-09-05

### [What Are the Three Execution Layers in Apache Maka?](/apache/maka/three-execution-layers-apache-maka)

Explore the three execution layers of Apache Maka: Runtime Event Log, SessionManager, and Agent Graph Control Plane. Learn how they work together under the Runtime Host.

- Tags: deep-dive
- Published: 2026-09-05

### [Where to Find RuntimeEvent Code in Apache Maka: Complete Source Guide](/apache/maka/where-find-code-for-runtimeevent-apache-maka)

Discover the exact location of RuntimeEvent code in Apache Maka. This guide pinpoints the source files in packages/runtime/src/ and runtime-event-read-model.ts for easy access and understanding.

- Tags: source-guide
- Published: 2026-09-05

### [What Information Does the RuntimeEvent Type Store in Apache Maka](/apache/maka/information-stored-in-runtimeevent-type)

Discover what the RuntimeEvent type stores in Apache Maka. Learn about its immutable identifiers, timestamps, author metadata, and content payload for agent execution.

- Tags: deep-dive
- Published: 2026-09-05

### [How Apache Maka Ensures Session and Run State Consistency: Immutable Logs and Transactional Recovery](/apache/maka/how-maka-ensures-session-and-run-state-consistency)

Apache Maka ensures session and run state consistency using immutable logs and transactional recovery. Discover how Maka achieves reliable state management for your applications.

- Tags: internals
- Published: 2026-09-05

### [Who Consumes the RuntimeEvent Log in Maka? 8 Core Components Explained](/apache/maka/consumers-of-runtimeevent-log-in-maka)

Discover the 8 core components consuming Maka's RuntimeEvent log, including SessionManager and Graph Execution. Learn how they manage, repair, and query your immutable ledger.

- Tags: internals
- Published: 2026-09-05

### [How System State Is Derived from the RuntimeEvent Log in Apache Maka](/apache/maka/how-system-state-derived-from-runtimeevent-log-in-maka)

Learn how Apache Maka derives system state by replaying its immutable RuntimeEvent Log. Understand how SessionManager projects context from appended events for efficient state management.

- Tags: internals
- Published: 2026-09-05

### [What Is the Role of RuntimeEvent in Apache Maka's Architecture?](/apache/maka/role-of-runtimeevent-in-apache-maka-architecture)

Discover the role of RuntimeEvent in Apache Maka's architecture. Learn how this immutable log forms the single source of truth for agent execution facts and drives the execution model.

- Tags: internals
- Published: 2026-09-05

### [How Apache Maka Uses an Append‑Only Ledger for State Management](/apache/maka/how-apache-maka-uses-append-only-ledger-for-state-management)

Discover how Apache Maka uses an append-only ledger as its single source of truth for runtime events, ensuring immutable state management for agent operations.

- Tags: internals
- Published: 2026-09-05

### [How Maka Manages Agent Lifecycle and Continuation: A Deep Dive into the Runtime Host Architecture](/apache/maka/how-does-maka-manage-agent-lifecycle-and-continuation)

Explore how Maka manages agent lifecycle and continuation using its Runtime Host architecture and immutable SQLite event stream. Learn about ephemeral and service modes.

- Tags: deep-dive
- Published: 2026-09-04

### [RuntimeKernel in Apache Maka: The Execution Engine Behind Turn-Based AI Sessions](/apache/maka/what-is-the-function-of-the-runtimekernel-in-maka)

Discover the RuntimeKernel in Apache Maka, the execution engine powering turn-based AI sessions. It orchestrates agent runs, delegates tasks, and ensures deterministic recovery for robust AI development.

- Tags: internals
- Published: 2026-09-04

### [Model Connection States in Apache Maka: Host Lifecycle and UI Status Explained](/apache/maka/what-are-the-different-states-for-model-connections-in-maka)

Explore Apache Maka's model connection states. Understand host lifecycle and UI status transitions like starting, ready, unsupported, and enabled for robust application management.

- Tags: deep-dive
- Published: 2026-09-04

### [How the Agent Graph Coordinator Manages Child Sessions in Apache Maka](/apache/maka/how-does-the-agent-graph-coordinator-manage-child-sessions-in-maka)

Discover how the Apache Maka Agent Graph Coordinator manages child sessions through a root-to-child hierarchy, immutable graph IDs, and internal assertions for robust session orchestration.

- Tags: internals
- Published: 2026-09-04

### [What Is `packages/runtime-host` in Apache Maka? Architecture and Implementation Guide](/apache/maka/what-is-the-role-of-packages-runtime-host-in-maka-architecture)

Discover the Maka runtime host, a persistent service managing State Root and Projects. Learn how it securely connects clients to the execution engine via its WebSocket API.

- Tags: architecture
- Published: 2026-09-04

### [How Maka Handles Context Pruning Without Deleting History](/apache/maka/how-does-maka-handle-context-pruning-without-deleting-history)

Discover how Maka handles context pruning without deleting history. It uses a prune-then-archive strategy to manage LLM prompts while keeping execution history accessible. Learn more!

- Tags: internals
- Published: 2026-09-04

### [What Is the packages/core Directory in Apache Maka? Architecture and Purpose](/apache/maka/what-is-the-purpose-of-packages-core-directory-in-maka-repository)

Explore the packages/core directory in Apache Maka. Understand its role in defining canonical data models and providing a stable, versioned API for all other packages.

- Tags: architecture
- Published: 2026-09-04

### [Apache Maka Entry Points: 6 Ways to Drive the Runtime Host](/apache/maka/what-are-the-different-entry-points-for-interacting-with-apache-maka)

Explore Apache Maka's six entry points to interact with the Runtime Host for session orchestration, model management, and tool execution. Drive Maka effectively.

- Tags: deep-dive
- Published: 2026-09-04

### [How to Enable and Use Crash Recovery and Resume Features in Apache Maka](/apache/maka/how-can-developers-enable-and-use-crash-recovery-and-resume-features-in-maka)

Learn how to enable and use Apache Maka's crash recovery and resume features. Explore its immutable RuntimeEvent log and safe-boundary checkpoints for state reconstruction after termination.

- Tags: how-to-guide
- Published: 2026-09-04

### [What Happens to Legacy Data During Workspace Upgrades in Maka](/apache/maka/what-happens-to-legacy-data-during-workspace-upgrades-in-maka)

Learn how Apache Maka handles legacy data during workspace upgrades. Maka isolates old tables, migrates compatible data, and drops obsolete structures for a smooth transition.

- Tags: migration-guide
- Published: 2026-09-04

### [How Apache Maka Manages Credentials and API Keys Securely: A Deep Dive into the Pure-Node Architecture](/apache/maka/how-does-maka-manage-credentials-and-api-keys-securely)

Learn how Apache Maka securely manages credentials and API keys with its pure-Node architecture. Discover OS-level encryption and masked placeholders for enhanced security.

- Tags: deep-dive
- Published: 2026-09-04

### [How Results Are Managed and Selected in Apache Maka’s Evaluation Framework](/apache/maka/how-are-results-managed-and-selected-in-maka-evaluation-framework)

Discover how Apache Maka manages and selects results in its evaluation framework. Learn about backend selection, relay agents, and structured JSON output for efficient data handling.

- Tags: internals
- Published: 2026-09-04

### [Structure of an Experiment in the Maka Evaluation Framework](/apache/maka/what-is-the-structure-of-an-experiment-in-maka-evaluation-framework)

Understand the structure of an experiment in the Maka evaluation framework. Learn how Maka models experiments as typed JSON objects conforming to the ExperimentSpec schema.

- Tags: architecture
- Published: 2026-09-04

### [How Apache Maka Implements Multi-Agent Scheduling and the Agent Graph](/apache/maka/how-does-apache-maka-implement-multi-agent-scheduling-and-agent-graph)

Learn how Apache Maka uses a transactional Agent Graph with SQLite to manage its multi-agent scheduling pipeline, coordinating tasks via schedules, intent claims, and operator provisions.

- Tags: deep-dive
- Published: 2026-09-04

### [How Maka Handles Tool Sandboxing and Security: Architecture and Implementation](/apache/maka/how-does-maka-handle-tool-sandboxing-and-security)

Discover how Maka secures tool execution with its layered sandbox architecture. Learn about centralized SandboxManager and strict permission boundaries for restricted file system and network access.

- Tags: architecture
- Published: 2026-09-04

### [Apache Maka Built-in Tools: A Complete Guide to the Core Agent Toolbox](/apache/maka/what-are-the-built-in-tools-provided-by-apache-maka)

Explore Apache Maka's seven core built-in tools including Read, Write, Edit, Bash, Glob, and Grep for file operations and code management. Enhance agent capabilities now.

- Tags: how-to-guide
- Published: 2026-09-04

### [How Apache Maka Manages Tool Execution and Access: Runtime Pipeline Deep Dive](/apache/maka/how-does-maka-manage-tool-execution-and-access)

Discover how Apache Maka manages tool execution and access with its multi-stage runtime pipeline. Learn about admission checks, permission validation, and sandbox boundaries.

- Tags: deep-dive
- Published: 2026-09-04

### [Core Principles of Maka's Architecture: How Apache Maka Orchestrates Multi-Agent Systems](/apache/maka/what-are-the-core-principles-of-maka-architecture)

Explore the core principles of Apache Maka's architecture: modularity, separation of concerns, event sourcing, privacy, and more. Learn how Maka orchestrates multi-agent systems effectively.

- Tags: architecture
- Published: 2026-09-04

### [How Apache Maka Ensures Data Durability with the Runtime Event Log](/apache/maka/how-does-maka-ensure-data-durability-with-the-runtime-event-log)

Apache Maka ensures data durability with an append-only Runtime Event Log backed by SQLite. Replay every model interaction, tool call, and permission decision after crashes.

- Tags: internals
- Published: 2026-09-04

### [Apache Maka Session and Turn Lifecycle: A Complete Guide](/apache/maka/explain-the-session-and-turn-lifecycle-in-apache-maka)

Master the Apache Maka session and turn lifecycle. Understand how interactions are modeled, managed, and persisted with SQLite for reliable client-server communication.

- Tags: deep-dive
- Published: 2026-09-04

### [What Is the Runtime Host in Apache Maka? The Central Execution Engine Explained](/apache/maka/what-is-the-role-of-the-runtime-host-in-apache-maka)

Discover the Runtime Host in Apache Maka, the central execution engine managing event logs and delegating computations for all thin-client interfaces. Learn how Maka ensures immutability and efficient processing.

- Tags: deep-dive
- Published: 2026-09-04

### [How Apache Maka Handles the Agent Execution Lifecycle: Inside the AgentRun Class](/apache/maka/how-does-apache-maka-handle-agent-execution-lifecycle)

Discover how Apache Maka handles the agent execution lifecycle via the AgentRun class. Learn about its nine distinct stages from initialization to termination orchestrated by the Runtime Host.

- Tags: internals
- Published: 2026-09-04

### [Apache Maka Artifact Storage Layout and Metadata Contract: A Complete Guide](/apache/maka/apache-maka-artifact-storage-layout-metadata-contract)

Discover the Apache Maka artifact storage layout and metadata contract. Learn how Maka enforces access policies and keeps filesystem paths hidden for secure model artifact management.

- Tags: architecture
- Published: 2026-09-02

### [How Apache Maka's Runtime Ledger Repair System Handles Event Log Corruption](/apache/maka/apache-maka-runtime-ledger-repair-event-log-corruption)

Apache Maka's runtime ledger repair system fixes event log corruption by detecting issues, reconstructing missing data from stored messages, and validating against legacy states to restore ledger consistency.

- Tags: internals
- Published: 2026-09-02

### [How the WorkHub Coordination Session in Apache Maka Facilitates Agent Collaboration](/apache/maka/apache-maka-workhub-coordination-session-agent-collaboration)

Discover how Apache Maka's WorkHub coordination session enhances agent collaboration. Learn how it mediates proposals, delegation, and decisions without duplicating storage or blurring authority.

- Tags: how-to-guide
- Published: 2026-09-02

### [Apache Maka Experiment Cells, Attempts, and Result Kernels: Eval System Architecture](/apache/maka/apache-maka-eval-system-experiment-cells-attempts-result-kernels)

Discover Apache Maka's eval system architecture. Understand experiment cells, attempts, and result kernels for isolated, retryable experiment execution and deterministic outcome capture.

- Tags: architecture
- Published: 2026-09-02

### [How Apache Maka's MCP Provider Integration Enables Model-Agnostic Tool Access](/apache/maka/apache-maka-mcp-provider-integration-model-agnostic-tool-access)

Discover how Apache Maka's MCP provider integration offers model-agnostic tool access. Invokes external services via uniform proxy objects and a standardized interface.

- Tags: deep-dive
- Published: 2026-09-02

### [What Is the Managed Dependency Storage Authority in Apache Maka?](/apache/maka/apache-maka-managed-dependency-storage-authority)

Understand the managed dependency storage authority in Apache Maka. Learn how it securely owns, protects, and serves Node.js module caches for safe concurrent access.

- Tags: internals
- Published: 2026-09-02

### [How Apache Maka Implements End-to-End Computer Use Capability](/apache/maka/apache-maka-computer-use-capability-end-to-end)

Discover how Apache Maka grants LLMs desktop control. Learn about its validated pipeline translating requests to native accessibility actions via Swift.

- Tags: deep-dive
- Published: 2026-09-02

### [How Apache Maka's Credential Vault Protects API Keys and Secrets Locally](/apache/maka/apache-maka-credential-vault-api-key-secrets-protection)

Secure your API keys and secrets locally with Apache Maka's credential vault. Discover how its atomic writes and type-safe validation prevent data leakage and corruption.

- Tags: how-to-guide
- Published: 2026-09-02

### [Apache Maka Agent Graph Stream Scheduling System: How Parallel Operators Execute Without Runtime Duplication](/apache/maka/apache-maka-agent-graph-stream-scheduling-parallel-operators)

Discover Apache Maka's Agent Graph stream scheduling system. Learn how parallel operators execute efficiently without runtime duplication using immutable projections and reference-only records.

- Tags: deep-dive
- Published: 2026-09-02

### [How Apache Maka Ensures Durable Runtime Event Persistence Against Crashes](/apache/maka/apache-maka-runtime-event-persistence-durability-crashes)

Discover how Apache Maka ensures durable runtime event persistence against crashes using an append-only SQLite database, transactional writes, and deterministic recovery.

- Tags: internals
- Published: 2026-09-02

### [Execution Boundary Contract for Sandbox Isolation in Apache Maka](/apache/maka/apache-maka-execution-boundary-contract-sandbox-isolation)

Discover the Apache Maka execution boundary contract for sandbox isolation. Learn how it declares required resources and enforces OS-level security for safe tool execution.

- Tags: architecture
- Published: 2026-09-02

### [How Session Message Projection in Apache Maka Builds Conversation State from Runtime Events](/apache/maka/apache-maka-session-message-projection-conversation-state)

Learn how Apache Maka builds conversation state from runtime events. Discover its deterministic aggregation logic for structured transcript views.

- Tags: internals
- Published: 2026-09-02

### [How the Apache Maka Harbor/Pier Eval Harness Executes Multi-Arm Experiments](/apache/maka/apache-maka-eval-harness-harbor-pier-multi-arm-experiments)

Discover how Apache Maka's Harbor Pier framework executes multi-arm experiments. Learn about Docker containers, relay policies for early termination, and result aggregation.

- Tags: how-to-guide
- Published: 2026-09-02

### [Apache Maka Model Projection Transition System: Immutability and Safe Context Updates](/apache/maka/apache-maka-model-projection-transition-context-management)

Discover the Apache Maka model projection transition system. Learn how immutable records and append-only ledgers ensure safe, deterministic updates for model-visible data.

- Tags: deep-dive
- Published: 2026-09-02

### [How the Runtime Host in Apache Maka Manages Lifecycles Across Desktop, TUI, and CLI](/apache/maka/apache-maka-runtime-host-lifecycle-desktop-tui-cli)

Discover how Apache Maka's Runtime Host unifies lifecycles for Desktop, TUI, and CLI. Learn about shared bootstrapping and unified managers for consistent operation.

- Tags: internals
- Published: 2026-09-02

### [How the Tool Ledger Scanner in Apache Maka Detects Corruption and Rejections](/apache/maka/apache-maka-tool-ledger-scanner-corruption-detection)

Discover how the Apache Maka Tool Ledger scanner detects corruption via duplicate IDs, identity conflicts, and invalid lanes, ensuring data integrity before persistence.

- Tags: internals
- Published: 2026-09-02

### [Subagent Session Spawning Architecture and Lifecycle in Apache Maka](/apache/maka/apache-maka-subagent-session-spawning-architecture-lifecycle)

Explore Apache Maka's subagent session spawning architecture and lifecycle. Learn how child sessions link to parents via SQLite and run in foreground mode under a shared Runtime Host.

- Tags: architecture
- Published: 2026-09-02

### [How the Apache Maka Model Call Ledger Tracks Token Usage and Attributes Costs](/apache/maka/apache-maka-model-call-ledger-token-usage-costs)

Discover how the Apache Maka Model Call Ledger tracks LLM token usage and attributes costs by consuming AgentRun events and applying pricing rules for queryable analytics.

- Tags: deep-dive
- Published: 2026-09-02

### [How Runtime Continuation (Resume) in Apache Maka Reconstructs Interrupted Turns](/apache/maka/apache-maka-runtime-continuation-resume-interrupted-turns)

Discover how Apache Maka reconstructs interrupted turns using runtime continuation. Learn about its safe execution from an immutable event ledger, not crashed processes.

- Tags: internals
- Published: 2026-09-02

### [Apache Maka SessionStatus States and Blocked Session Handling Explained](/apache/maka/apache-maka-sessionstatus-blocked-session-handling)

Explore Apache Maka's SessionStatus states active running waiting_for_user blocked and aborted. Learn how blocked sessions with typed blockedReason enable recovery and UI updates.

- Tags: deep-dive
- Published: 2026-09-02

### [Session Branching, Turn Regeneration, and Retry Mechanisms in Apache Maka](/apache/maka/apache-maka-session-branching-turn-regeneration-retry)

Master session branching, turn regeneration, and retry mechanisms in Apache Maka. Recover from errors, re-run turns, and split conversations with immutable history.

- Tags: deep-dive
- Published: 2026-09-02

### [How Apache Maka's Sandbox Boundary Enforces Tool Execution Controls](/apache/maka/apache-maka-sandbox-boundary-tool-execution-controls)

Apache Maka enforces tool execution controls with a four-stage sandbox. Learn how it selects backends, validates permissions, requests user approval, and blocks unauthorized access.

- Tags: internals
- Published: 2026-09-02

### [AgentRun Lifecycle and Crash Recovery in Apache Maka: A Complete Technical Guide](/apache/maka/apache-maka-agentrun-lifecycle-crash-recovery)

Explore the AgentRun lifecycle in Apache Maka and understand its crash recovery mechanism. Learn how event persistence and deterministic replay ensure resilience.

- Tags: deep-dive
- Published: 2026-09-02

### [How Apache Maka's Runtime Event Log Ensures Durable Execution Recording](/apache/maka/apache-maka-runtime-event-log-durable-execution-recording)

Discover how Apache Maka's Runtime Event Log ensures durable execution recording with immutable events, append-only persistence, and atomic recovery for reliable workflow management.

- Tags: internals
- Published: 2026-09-02

### [What Is the `runtime-event-authority.ts` Contract in Maka and How It Separates Storage from Evaluation](/apache/maka/what-is-the-runtime-event-authority-ts-contract-in-maka-and-how-does-it-separate-storage-from-evaluation)

Discover the runtime-event-authority.ts contract in Apache Maka. Learn how it separates storage from evaluation to protect atomic versioning guarantees in your workspace.

- Tags: deep-dive
- Published: 2026-09-01

### [How Runtime-Managed Workspace Mutation Lifecycle Authority Works in Maka: Architecture Deep‑Dive](/apache/maka/how-does-the-runtime-managed-workspace-mutation-lifecycle-authority-work-in-maka)

Discover how Maka's runtime manages workspace mutations using a two-phase reservation system, SQLite, and process-wide locking for atomic operations. Learn the architecture.

- Tags: architecture-deep-dive
- Published: 2026-09-01

### [Model Context Protocol Integration Patterns for Provider-Neutral Tool Execution in Maka](/apache/maka/what-are-the-model-context-protocol-integration-patterns-in-packages-mcp-for-provider-neutral-tool-execution-in-maka)

Discover Maka's Model Context Protocol integration patterns in packages/mcp for provider-neutral tool execution. Learn about fingerprinting, discovery, validation, and more.

- Tags: internals
- Published: 2026-09-01

### [How the Maka Desktop Build System Streams Sessions, Displays Tool Timelines, and Supports Branching/Recovery](/apache/maka/how-does-makas-desktop-build-system-stream-sessions-display-tool-timelines-and-support-branching-recovery)

Discover how the Apache Maka Desktop build system streams sessions, displays tool timelines, and supports branching and recovery for efficient development.

- Tags: internals
- Published: 2026-09-01

### [How Apache Maka Manages API Keys and Secrets Locally: A Deep Dive into credential-store.ts and activation-secret-injector.ts](/apache/maka/how-does-credential-store-ts-and-activation-secret-injector-ts-manage-api-keys-and-secrets-locally-in-maka)

Learn how Apache Maka securely manages API keys and secrets locally using credential-store.ts and activation-secret-injector.ts for safe injection and cleanup.

- Tags: deep-dive
- Published: 2026-09-01

### [Apache Maka Peer Mesh Architecture: How Direct-Peer Connections Work and Native Build Requirements](/apache/maka/what-is-makas-peer-mesh-architecture-for-direct-peer-connections-and-what-are-the-native-addon-building-requirements)

Explore Apache Maka's peer mesh architecture for direct peer connections. Discover how it works and learn the native build requirements, including Rust and Node.js.

- Tags: architecture
- Published: 2026-09-01

### [How Maka's Transcript Projection Derives UI Views from the Event Log](/apache/maka/how-does-makas-transcript-projection-derive-ui-views-from-the-event-log)

Learn how Maka derives UI views from its event log using transcript projection. Discover its incremental pipeline for materializing views and reconciling identities for React stability.

- Tags: internals
- Published: 2026-09-01

### [SQLite Store Schemas for Maka's Persistent State: Complete Technical Guide](/apache/maka/what-are-the-sqlite-store-schemas-for-makas-persistent-state)

Explore Maka's SQLite store schemas for persistent state management. This guide details independent schema versions and automated migration within the Apache Maka repository.

- Tags: technical-guide
- Published: 2026-09-01

### [How Maka's Evaluation Uses Declarative Multi-Arm Experiments: Task × Repetition × Subject Expansion](/apache/maka/how-does-makas-evaluation-use-declarative-multi-arm-experiments-expanded-into-task-x-repetition-x-subject-cells)

Learn how Maka's evaluation framework uses declarative multi-arm experiments to expand task repetition and subject cells for reproducible, parallel execution. Explore the expandExperiment function in Apache Maka.

- Tags: deep-dive
- Published: 2026-09-01

### [How Apache Maka Uses Isolated Git Worktrees in Its Graph Implementation for Safe Source Project Execution](/apache/maka/how-does-makas-graph-implementation-utilize-isolated-git-worktrees-for-source-projects)

Discover how Apache Maka uses isolated Git worktrees in its Graph implementation for safe source project execution. Learn about deterministic allocation and lifecycle management.

- Tags: deep-dive
- Published: 2026-09-01

### [How Maka Enforces Sandbox Boundaries for File‑Write and Shell‑Run Tools](/apache/maka/what-is-the-sandbox-boundary-for-tools-in-maka-and-how-do-file-write-and-shell-run-tools-pass-approval-checks)

Understand Maka's sandbox boundary for file-write and shell-run tools. Learn how tools gain approval for execution scope expansion.

- Tags: internals
- Published: 2026-09-01

### [MakaCU Lifecycle and RPC Protocol for Computer-Use Sandboxing: A Complete Technical Guide](/apache/maka/what-is-the-makacu-lifecycle-and-rpc-protocol-for-computer-use-sandboxing)

Explore the MakaCU lifecycle and RPC protocol for computer-use sandboxing. Learn how MakaCuService manages sandboxed processes with a strict JSON-RPC 2.0 protocol.

- Tags: deep-dive
- Published: 2026-09-01

### [How Secrets Are Stored in `credential-vault.json` and the Security Boundary Between Renderer and Main in Apache Maka](/apache/maka/how-are-secrets-stored-in-credential-vault-json-and-what-is-the-security-boundary-in-maka-between-renderer-and-electron-main)

Learn how Apache Maka stores secrets in credential-vault.json and the security boundary between renderer and main processes. Renderer requests operations, never accessing raw secrets.

- Tags: internals
- Published: 2026-09-01

### [Maka Subject vs External Subject: Understanding the Evaluation Framework in Apache Maka](/apache/maka/what-is-the-distinction-between-an-amaka-subject-and-an-external-subject-in-makas-evaluation-framework)

Learn the difference between Maka subject and external subject in Apache Maka. Understand how each executes workloads and their security implications.

- Tags: deep-dive
- Published: 2026-09-01

### [How Apache Maka Manages Immutable Experiment Cell Attempts and Selects the Earliest Valid Result](/apache/maka/how-does-packages-eval-in-maka-manage-experiment-cells-immutable-attempts-and-select-the-earliest-valid-result)

Discover how Apache Maka's evaluation subsystem manages immutable experiment cells using sequence-numbered files and selects the earliest valid result for definitive outcomes.

- Tags: internals
- Published: 2026-09-01

### [How Context Pruning and LLM Compaction Alter Provider Input Projections in Apache Maka](/apache/maka/how-does-context-pruning-and-llm-compaction-alter-provider-input-projections-in-maka-without-changing-history)

Discover how context pruning and LLM compaction in Apache Maka transform provider input projections without altering your completed steps history.

- Tags: deep-dive
- Published: 2026-09-01

### [How the Runtime Event Log in Apache Maka Serves as the Canonical Source for Model Messages, Tool Calls, and Results](/apache/maka/how-does-the-runtime-event-log-in-maka-serve-as-the-canonical-source-for-model-messages-tool-calls-and-tool-results)

Discover how Apache Maka's Runtime Event Log acts as the canonical source for model messages, tool calls, and results. Learn how it ensures data integrity and state derivation.

- Tags: deep-dive
- Published: 2026-09-01

### [Execution Lifecycle Difference Between AgentRun, RuntimeKernel, and SessionManager in Apache Maka](/apache/maka/what-is-the-execution-lifecycle-difference-between-agentrun-runtimekernel-and-sessionmanager-in-apache-maka)

Understand the Apache Maka execution lifecycle. Learn how AgentRun, RuntimeKernel, and SessionManager manage agent runs, resource sandboxing, and cross-run state for efficient session coordination.

- Tags: internals
- Published: 2026-09-01

### [How Maka’s Runtime Host Manages Session and Turn Identity Across Desktop, TUI, and CLI Clients](/apache/maka/how-does-makas-runtime-host-manage-session-and-turn-identity-across-desktop-tui-and-cli-clients)

Discover how Maka's Runtime Host ensures consistent session and turn identity across desktop, TUI, and CLI clients using a three-layer validation system for stateless connections.

- Tags: internals
- Published: 2026-09-01

### [How Maka Audits Model Capabilities and Recovers Client Capabilities](/apache/maka/how-does-maka-audit-model-capabilities-and-recover-client-capabilities)

Learn how Maka audits model capabilities with an immutable log and recovers client capabilities using a coordinator. Restore user permissions seamlessly.

- Tags: deep-dive
- Published: 2026-08-31

### [Where to Find Maka's Agent Catalog and Built-In Agent Definitions](/apache/maka/where-can-i-find-definitions-for-maka-agent-catalog-and-built-in-agents)

Locate Maka's agent catalog and built-in agent definitions within the runtime package at packages/runtime/src/agent-catalog.ts. Discover exported definitions and helper functions easily.

- Tags: how-to-guide
- Published: 2026-08-31

### [How Apache Maka Manages the PTY Stack and Shell Execution: A Deep Dive into the Runtime Architecture](/apache/maka/how-does-maka-manage-pty-stack-and-shell-execution)

Explore Apache Maka's runtime architecture. Learn how its PTY stack manages shell execution with pluggable I/O processing via PtyStack, PtyProcessDriver, and PtyScreenCollector.

- Tags: deep-dive
- Published: 2026-08-31

### [Maka Workspace Versioning and Dependency Storage: A Deep Dive into the Apache Runtime Architecture](/apache/maka/what-is-maka-approach-to-workspace-versioning-and-dependency-storage)

Discover Maka's robust workspace versioning and dependency storage. Learn how its crash-resilient SQLite-backed system ensures atomic transactions and deterministic recovery for the Apache Runtime Architecture.

- Tags: deep-dive
- Published: 2026-08-31

### [How Maka Tracks Token Usage and Project Costs: A Complete Technical Guide](/apache/maka/how-does-maka-track-token-usage-and-project-costs)

Maka tracks token usage and project costs by emitting session events, looking up pricing, computing call costs, and aggregating into reports. Learn how in this technical guide.

- Tags: deep-dive
- Published: 2026-08-31

### [How Maka Handles Computer Use Backend Selection and the Display‑Snapshot Protocol](/apache/maka/how-does-maka-handle-computer-use-backend-selection-and-display-snapshot-protocol)

Maka selects Computer Use backends with a pluggable system and processes display snapshots through a strict protocol. It protects host privacy by filtering executor output before it reaches the model.

- Tags: internals
- Published: 2026-08-31

### [Apache Maka Runtime Policy Configuration and Mutation System Explained](/apache/maka/what-is-maka-runtime-policy-configuration-and-mutation-system)

Learn about Apache Maka's runtime policy system. Explore its centralized JSON document for agent permissions, resource budgets, and feature toggles, updated via CAS workflow.

- Tags: deep-dive
- Published: 2026-08-31

### [How Maka Executes Subagents with Worktree-Backed Child Sessions](/apache/maka/how-does-maka-execute-subagents-with-worktree-backed-child-sessions)

Learn how Maka executes subagents using worktree-backed child sessions for robust filesystem isolation. Discover the process of provisioning Git worktrees and binding them to child sessions.

- Tags: deep-dive
- Published: 2026-08-31

### [How Maka Handles Session Branching, Revision, and Regeneration: A Deep Dive into the Conversation Model](/apache/maka/how-does-maka-handle-session-branching-revision-and-regeneration)

Explore how Maka handles session branching, revision, and regeneration within its conversation model. Learn about its flexible approach to evolving user-assistant interactions.

- Tags: deep-dive
- Published: 2026-08-31

### [Apache Maka Built-In Tools: Complete List and Usage Guide](/apache/maka/what-are-the-built-in-tools-available-in-maka)

Explore Apache Maka's 12 built-in tools like Bash, Grep, and WebSearch. Execute commands directly in the runtime without external dependencies. Master Maka's powerful utilities.

- Tags: how-to-guide
- Published: 2026-08-31

### [How Model Adapters Are Integrated into Maka via AiSdkBackend: A Complete Technical Guide](/apache/maka/how-are-model-adapters-integrated-into-maka-via-aisdkbackend)

Learn how Maka integrates model adapters via AiSdkBackend. Discover the three-layer architecture orchestrating model creation, provider selection, and specification normalization for AI-SDK language models.

- Tags: deep-dive
- Published: 2026-08-31

### [Apache Maka History Compaction and Context Budget Policy Explained](/apache/maka/describe-maka-history-compaction-and-context-budget-policy)

Learn about Apache Maka's history compaction and context budget policy. Understand how Maka efficiently manages conversation history with checkpoint recovery and token budgets for optimal performance.

- Tags: deep-dive
- Published: 2026-08-31

### [SQLite Storage Schema for Maka Sessions, Runs, and Events: Complete Technical Reference](/apache/maka/what-is-the-sqlite-storage-schema-for-maka-sessions-runs-and-events)

Explore the Maka SQLite storage schema for sessions, runs, and events. Understand the two versioned schema files for session metadata and the event ledger.

- Tags: api-reference
- Published: 2026-08-31

### [How Agent Graph Handles Git Worktree Scheduling for Child Sessions in Apache Maka](/apache/maka/how-does-agent-graph-handle-scheduling-for-child-sessions-using-git-worktrees)

Learn how Agent Graph schedules child sessions using Git worktrees and monotonic schedule revisions in Apache Maka. Understand Git worktree scheduling for child sessions.

- Tags: internals
- Published: 2026-08-31

### [What Is the Runtime Event Log in Maka? Architecture, Persistence, and Reproducibility Explained](/apache/maka/what-is-the-role-of-the-runtime-event-log-in-maka)

Discover Maka's Runtime Event Log the single source of truth for agent actions enabling replay, checkpointing, and exact reproducibility. Learn its architecture and persistence.

- Tags: deep-dive
- Published: 2026-08-31

### [How Maka's SessionManager Manages Session Lifecycles and Turn Execution](/apache/maka/how-does-maka-sessionmanager-manage-session-lifecycles-and-turn-execution)

Discover how Maka's SessionManager orchestrates session lifecycles and turn execution, coordinating persistent storage, AI backends, and sandboxed environments for seamless runtime operations.

- Tags: internals
- Published: 2026-08-31

### [Where to Find Runtime Host Core Files in Apache Maka: Complete Developer Guide](/apache/maka/where-can-i-find-runtime-host-core-files-apache-maka-repository)

Find Apache Maka Runtime Host core files easily. Discover their locations in the repository for streamlined development and quick access to essential code.

- Tags: developer-guide
- Published: 2026-08-30

### [Apache Maka Project License and Incubation Status: A Complete Guide](/apache/maka/what-is-apache-maka-project-license-incubation-status)

Understand the Apache License 2.0 and incubation status of the Apache Maka project. Learn about its current podling phase within the ASF.

- Tags: getting-started
- Published: 2026-08-30

### [How Apache Maka Handles Long-Running Tool Execution: From Seconds to Hours](/apache/maka/how-does-apache-maka-handle-tool-execution-that-might-take-seconds-hours)

Discover how Apache Maka's Task Ledger architecture handles long-running tool execution, enabling hours of subprocess operation with streamed progress updates to the LLM.

- Tags: deep-dive
- Published: 2026-08-30

### [What the 'Completed' Decision Means in Apache Maka's RecoveryResolver](/apache/maka/what-does-completed-decision-mean-in-apache-maka-recoveryresolver)

Understand what the 'completed' decision means in Apache Maka's RecoveryResolver. Learn how tool invocations are permanently recorded for recovery.

- Tags: deep-dive
- Published: 2026-08-30

### [How Apache Maka's RecoveryResolver Classifies Tool State After Runtime Crashes](/apache/maka/how-does-recoveryresolver-classify-tool-state-in-apache-maka)

Apache Maka's RecoveryResolver classifies tool state into five definitive states—completed, not-dispatched, unknown, parked, or corrupt—using RuntimeEvent records for robust crash recovery.

- Tags: internals
- Published: 2026-08-30

### [T2 commitToolOutcome in Apache Maka: Significance and Implementation for Durable Workflows](/apache/maka/what-is-significance-of-t2-committooloutcome-in-apache-maka)

Discover the significance of T2 commitToolOutcome in Apache Maka. Persist tool results for durable workflows, enable seamless resumes, and create immutable audit records. Learn more.

- Tags: deep-dive
- Published: 2026-08-30

### [The Significance of T1 commitToolPrepared in Apache Maka: Tooling Integration Workflow](/apache/maka/what-is-significance-of-t1-committoolprepared-in-apache-maka)

Discover the significance of T1 commitToolPrepared in Apache Maka. Automate external binary preparation for reproducible, cross-platform builds and eliminate manual setup.

- Tags: deep-dive
- Published: 2026-08-30

### [Understanding Phase 1 in Apache Maka's Resume Architecture: The Safe-Boundary Contract](/apache/maka/what-is-purpose-of-phase-1-in-apache-maka-resume-architecture)

Discover Apache Maka's Phase 1 Safe-Boundary Contract. Learn how it ensures session safety with a fail-closed continuation path, resuming only when explicit conditions are met.

- Tags: architecture
- Published: 2026-08-30

### [How Apache Maka Ensures Safety During Replay with Phase 0](/apache/maka/how-does-apache-maka-ensure-safety-during-replay-with-phase-0)

Learn how Apache Maka ensures safety during replay with Phase 0 validation. Discover how it checks version consistency, enforces progression, and guards storage recovery for reliable operations.

- Tags: internals
- Published: 2026-08-30

### [How Apache Maka's Resume Architecture Creates New Executions from Paused Runs](/apache/maka/what-is-resume-architecture-in-apache-maka-and-how-does-it-create-new-executions)

Discover Apache Maka's resume architecture. Learn how it safely continues paused agent executions by creating new execution identities with the RuntimeContinuationPlanner.

- Tags: architecture
- Published: 2026-08-30

### [How Apache Maka Handles the Five Fixed Recovery Phases During Startup](/apache/maka/how-does-apache-maka-handle-five-fixed-recovery-phases-during-startup)

Discover how Apache Maka manages five fixed recovery phases during startup: state, resources, executions, domains, and schedulers, ensuring a stable system before higher-level logic resumes.

- Tags: internals
- Published: 2026-08-30

### [Domain Module in Apache Maka: Definition, Interface, and Lifecycle Management](/apache/maka/what-is-domain-module-in-apache-maka-and-what-does-it-define)

Understand the Apache Maka Domain Module, a RuntimeHostDomainModule interface. Discover its role in defining identifiers, operation handlers, and lifecycle hooks for state recovery and shutdown.

- Tags: deep-dive
- Published: 2026-08-30

### [How Apache Maka Manages sessionId, turnId, runId, and invocationId: A Deep Dive into the Execution Model](/apache/maka/how-are-sessionid-turnid-runid-invocationid-managed-in-apache-maka)

Explore how Apache Maka manages sessionId, turnId, runId, and invocationId for deterministic execution and provenance. Understand Maka's identifier hierarchy for agent conversations and tool invocations.

- Tags: deep-dive
- Published: 2026-08-30

### [The Four Distinct Identities That Drive Apache Maka's Execution Model](/apache/maka/what-are-four-distinct-identities-that-drive-apache-maka-execution)

Discover the four distinct identities driving Apache Maka's execution: Runtime Host, Session, Turn, and AgentRun. Understand process authority, conversation state, atomic operations, and agent lifecycle management.

- Tags: internals
- Published: 2026-08-30

### [What Happens If Run Composition or Persistence Fails Before Provider Call in Apache Maka](/apache/maka/what-happens-if-run-composition-persistence-fails-before-provider-call-in-apache-maka)

Discover what happens when Run Composition or persistence fails in Apache Maka. Learn how Maka aborts turns to ensure data consistency and billing integrity.

- Tags: internals
- Published: 2026-08-30

### [How Apache Maka Creates an Immutable Run Composition Snapshot](/apache/maka/how-does-apache-maka-run-composer-create-immutable-run-composition-snapshot)

Learn how Apache Maka's Run Composer creates immutable snapshots. Discover how Object.freeze ensures deterministic replay across restarts for your system prompt and source revisions.

- Tags: internals
- Published: 2026-08-30

### [How the Agent Graph Schedules Dependent Work Using Child Sessions in Apache Maka](/apache/maka/how-does-agent-graph-schedule-dependent-work-using-child-sessions-in-apache-maka)

Learn how Apache Maka schedules dependent work using child sessions and deterministic intent claims for guaranteed exactly-once execution across deep dependency trees.

- Tags: deep-dive
- Published: 2026-08-30

### [Understanding SessionManager and AgentRun in Apache Maka's Execution Lifecycle](/apache/maka/what-is-function-of-sessionmanager-agentrun-in-apache-maka-execution-lifecycle)

Learn about SessionManager and AgentRun in Apache Maka. SessionManager manages session lifecycle, while AgentRun is the persistent agent instance for event capture and recovery.

- Tags: internals
- Published: 2026-08-30

### [How Apache Maka Uses the Runtime Event Log as the Canonical Source of Truth](/apache/maka/how-is-runtime-event-log-used-as-canonical-source-in-apache-maka)

Discover how Apache Maka's Runtime Event Log serves as the canonical source of truth for agent execution state, ensuring consistent data across models, UI, and recovery systems.

- Tags: architecture
- Published: 2026-08-30

### [Understanding the Four Clear Layers of the Apache Maka Runtime System](/apache/maka/what-are-four-clear-layers-apache-maka-runtime-system)

Explore the four clear layers of the Apache Maka runtime system: Runtime Event Log, SessionManager, Agent Graph, and Storage. Understand event sourcing, execution, coordination, and persistence.

- Tags: deep-dive
- Published: 2026-08-30

### [How Apache Maka Prevents Multiple Writers and Conflicting Session State](/apache/maka/how-does-apache-maka-prevent-multiple-writers-conflicting-session-state)

Apache Maka prevents multiple writers and conflicting session state using a single-writer-per-lease architecture, brand symbols, WeakSet registration, and centralized storage writer composition. Learn how Maka ensures data inte...

- Tags: internals
- Published: 2026-08-30

### [Apache Maka Runtime Host: Architecture, Responsibilities, and Implementation](/apache/maka/what-is-role-of-runtime-host-in-apache-maka-architecture)

Discover the Apache Maka Runtime Host's architecture and responsibilities. Learn how it ensures durability, consistency, and recovery for AI workloads in Maka.

- Tags: architecture
- Published: 2026-08-30

### [How Apache Maka Implements a Local-First Agent Workspace: Architecture Deep Dive](/apache/maka/how-does-apache-maka-implement-local-first-agent-workspace)

Discover how Apache Maka implements a local-first agent workspace using NPM-style resolution, immutable SQLite ledgers, and a sandboxed runtime host for durable, secure session state. Dive into the architecture.

- Tags: architecture
- Published: 2026-08-30

### [How to Configure Model Settings and Sandbox Settings in Maka's Desktop Workspace](/apache/maka/apache-maka-desktop-workspace-settings)

Learn how to configure model and sandbox settings in Maka Desktop Workspace using the Settings modal and the useSettingsModal hook. Easily open specific sections for your needs.

- Tags: how-to-guide
- Published: 2026-08-29

### [Apache Maka TUI/CLI Interface: Complete Developer Guide](/apache/maka/apache-maka-tui-cli-interface)

Explore the Apache Maka TUI/CLI interface, a single binary for interactive terminal UI or direct command execution. Get started with Maka today.

- Tags: developer-guide
- Published: 2026-08-29

### [How Maka Integrates with Messaging Platforms Like Slack and Discord: A Bot Bridge Architecture](/apache/maka/apache-maka-bot-integrations-messaging)

Learn how Maka integrates with Slack and Discord using its Bot Bridge architecture. Discover the unified pattern that connects platform-specific bots to a common event system.

- Tags: architecture
- Published: 2026-08-29

### [Maka Eval Framework: Understanding Experiment, Cell, and Repetition](/apache/maka/apache-maka-eval-framework-concepts)

Understand Maka's Eval framework concepts: Experiment, Cell, and Repetition. Learn how Maka enables isolated, repeatable tests with automatic retries and network filtering for robust testing.

- Tags: deep-dive
- Published: 2026-08-29

### [How to Set Up Reproducible Benchmark Experiments with Maka's Eval Framework](/apache/maka/apache-maka-eval-framework-benchmarking)

Learn to set up reproducible benchmark experiments with Maka's Eval framework. Define specs, run CLI commands, and collect deterministic results for reliable testing.

- Tags: tutorial
- Published: 2026-08-29

### [What Is the Purpose of Git Worktrees in Maka's Graph Mode?](/apache/maka/apache-maka-graph-mode-git-worktrees)

Discover how Git worktrees in Maka's graph mode offer isolated checkouts for parallel agent execution, streamlining your workflow without conflicts.

- Tags: how-to-guide
- Published: 2026-08-29

### [How Apache Maka Summarizes Long Conversations: A Complete Technical Guide](/apache/maka/apache-maka-conversation-summarization)

Learn how Apache Maka summarizes long conversations using session-based messages and deterministic markdown summaries for efficient downstream access. Explore this technical guide.

- Tags: deep-dive
- Published: 2026-08-29

### [How Maka Handles Context Compaction and History Pruning: A Two-Step Projection System](/apache/maka/apache-maka-context-compaction-history)

Learn how Maka reduces LLM context with a two-step projection system. Discover its deterministic approach to context compaction and history pruning for replayability and auditability.

- Tags: deep-dive
- Published: 2026-08-29

### [How to Use the Read and Write Tools in Apache Maka: A Complete Guide to Safe File Operations](/apache/maka/apache-maka-read-write-tools-guide)

Learn to use Apache Maka's Read and Write tools for safe, sandboxed file operations. This guide covers Zod schema validation and I/O delegation for secure execution.

- Tags: how-to-guide
- Published: 2026-08-29

### [How Apache Maka's Bash Tool Works: A Deep Dive into Shell Execution](/apache/maka/apache-maka-bash-tool-usage)

Explore how Apache Maka's Bash tool executes shell commands foreground or background. Learn about PTY allocation, sandbox enforcement, and customizable hooks for efficient shell management.

- Tags: deep-dive
- Published: 2026-08-29

### [Apache Maka Built-In Tools: Complete Catalog for LLM Agents](/apache/maka/apache-maka-built-in-tools-list)

Explore Apache Maka's 10 built-in tools for LLM agents. Enhance your agents with file system operations, shell execution, search, and background tasks.

- Tags: api-reference
- Published: 2026-08-29

### [How to Use the runtime.sqlite File in Apache Maka: A Complete Guide](/apache/maka/apache-maka-runtime-sqlite-usage)

Learn how to use the runtime.sqlite file in Apache Maka. Access session events, tool-ledger entries, and workspace state programmatically for seamless operations.

- Tags: how-to-guide
- Published: 2026-08-29

### [How Apache Maka Manages Sessions and Turns: A Three-Layer Architecture Guide](/apache/maka/apache-maka-session-turn-management)

Explore how Apache Maka manages sessions and turns using its three layer architecture for efficient handling of long conversational transcripts.

- Tags: architecture
- Published: 2026-08-29

### [What "Resume Is Not Retry" Means in Apache Maka's Architecture](/apache/maka/apache-maka-resume-vs-retry)

Understand how Apache Maka's 'Resume is not retry' principle prevents unnecessary delays. Learn how Maka differentiates between continuing a job and initiating a new attempt to optimize processing.

- Tags: architecture
- Published: 2026-08-29

### [Apache Maka Crash Recovery: How the Runtime Resume Protocol Survives Process Failures](/apache/maka/apache-maka-crash-recovery-mechanism)

Apache Maka crash recovery ensures turns survive process failures. Learn how its runtime resume protocol uses SQLite and a four-phase recovery to guarantee safe resumption.

- Tags: internals
- Published: 2026-08-29

### [What Information Is Stored in the Apache Maka Runtime Event Log?](/apache/maka/apache-maka-runtime-event-log-contents)

Explore the Apache Maka Runtime Event Log to understand the immutable sequence of RuntimeEvents it captures. Learn about messages, tool calls, permissions, token usage, and terminal outcomes for complete state replay.

- Tags: deep-dive
- Published: 2026-08-29

### [How Maka's Tool Runtime Executes Tools Safely: Inside the Sandbox Architecture](/apache/maka/apache-maka-tool-runtime-sandbox)

Discover how Maka's Tool Runtime executes tools safely within its sandbox architecture. Learn about filesystem restrictions, network blocking, and explicit user approval for secure tool execution.

- Tags: internals
- Published: 2026-08-29

### [How the SessionManager Works in Apache Maka: Complete Runtime Architecture](/apache/maka/apache-maka-sessionmanager-functionality)

Discover how the SessionManager orchestrates Apache Maka's runtime managing session lifecycles, provisioning operators, coordinating claims, and enforcing permissions for agent execution.

- Tags: architecture
- Published: 2026-08-29

### [What Is the Apache Maka Runtime Host? Process Architecture and State Management](/apache/maka/apache-maka-runtime-host-explained)

Discover the Apache Maka Runtime Host, the core process managing state, data leases, and client execution. Learn its architecture and state management for robust applications.

- Tags: architecture
- Published: 2026-08-29

### [How Apache Maka Implements Local-First Agent Workspaces: Architecture, Identity, and Privacy Controls](/apache/maka/apache-maka-local-first-agent-workspaces)

Discover how Apache Maka secures local-first agent workspaces. Learn about its architecture, UUID identity, and privacy controls for safe AI agent operation.

- Tags: architecture
- Published: 2026-08-29

### [System Requirements for Apache Maka: Complete Installation Prerequisites](/apache/maka/apache-maka-system-requirements)

Discover the essential system requirements for Apache Maka. Ensure Node.js 22.19+, npm 11, Git, and ripgrep are installed, with macOS arm64 as the main platform.

- Tags: getting-started
- Published: 2026-08-29

### [How to Install Apache Maka: A Step-by-Step Guide to the Modular AI Platform](/apache/maka/how-to-install-apache-maka)

Install Apache Maka with our step-by-step guide. Clone the repo, install dependencies, create a workspace, add skills, and launch the AI platform host and UI.

- Tags: getting-started
- Published: 2026-08-29

### [How the Runtime-Kernel Manages Admission Control and Client Capabilities in Apache Maka](/apache/maka/apache-maka-runtime-kernel-admission-control-client-capabilities)

Apache Maka's runtime kernel orchestrates session admission via execution claims and acts as a capability broker, controlling client access to host services and external resources.

- Tags: internals
- Published: 2026-08-28

### [The Role of continuation-replay.ts in Apache Maka's Crash Recovery Mechanism](/apache/maka/apache-maka-continuation-replay-crash-recovery)

Explore continuation-replay.ts, Apache Maka's crash recovery orchestrator. Learn how it validates events, plans replays, and ensures deterministic state resumption after crashes.

- Tags: internals
- Published: 2026-08-28

### [How Maka's runtime-resume.ts Module Orchestrates Crash Recovery](/apache/maka/apache-maka-runtime-resume-crash-recovery-orchestration)

Discover how Maka's runtime-resume.ts module orchestrates crash recovery by reconstructing execution state, validating continuation lineage, and ensuring safe resumption or flagging for manual intervention.

- Tags: internals
- Published: 2026-08-28

### [Environment Variables to Enable Crash Recovery in Apache Maka](/apache/maka/apache-maka-crash-recovery-environment-variables)

Discover Maka environment variables like MAKA_RUNTIME_SAFE_BOUNDARY_RESUME and MAKA_RUNTIME_RESUME_* for robust crash recovery and deterministic testing. Optimize your Apache Maka applications.

- Tags: how-to-guide
- Published: 2026-08-28

### [How Maka Integrates with OpenAI-Compatible Models Using `ai-sdk-backend.ts`](/apache/maka/apache-maka-openai-sdk-backend-integration)

Learn how Maka integrates with OpenAI-compatible models via ai-sdk-backend.ts. Discover seamless configuration for streaming retries and tool calls.

- Tags: how-to-guide
- Published: 2026-08-28

### [How Apache Maka Manages AI Model Connections: The Send-Ready State Validation](/apache/maka/apache-maka-ai-model-connection-management)

Discover how Apache Maka validates AI model connections using a synchronous 8-step process. Learn about the send-ready state and effective model determination.

- Tags: deep-dive
- Published: 2026-08-28

### [What Is the Approval Flow for Tools That Cross Maka's Sandbox Boundary?](/apache/maka/apache-maka-sandbox-boundary-tool-approval-flow)

Learn Maka's approval flow for tools crossing sandbox boundaries. Understand how Maka prompts for explicit consent to expand permissions or fails the turn.

- Tags: how-to-guide
- Published: 2026-08-28

### [How Maka's Sandbox-Boundary-Tool Enforcement Secures Critical Operations](/apache/maka/apache-maka-sandbox-boundary-tool-enforcement)

Discover how Maka's sandbox-boundary-tool enforces security for critical operations. Learn how it isolates tool execution and manages permission requests for secure filesystem and network access.

- Tags: security-guide
- Published: 2026-08-28

### [Understanding Maka's Built-in Read and Write Tools: A Technical Deep Dive](/apache/maka/apache-maka-builtin-tools-read-write-capabilities)

Explore Maka's built-in Read and Write tools for secure, sandboxed file access. Learn how Maka handles data fetching and persistence with schema validation and telemetry logging.

- Tags: deep-dive
- Published: 2026-08-28

### [How Maka Handles Context Pruning and Compaction in the Runtime Event Log](/apache/maka/apache-maka-context-pruning-compaction-runtime-event-log)

Discover how Maka handles context pruning and compaction in its Runtime Event Log. Learn how events are selectively removed and historical turns summarized for efficient token use while maintaining log integrity.

- Tags: internals
- Published: 2026-08-28

### [What Types of Facts Are Recorded in the Apache Maka Runtime Event Log?](/apache/maka/apache-maka-runtime-event-log-fact-types)

Explore the six fact types in the Apache Maka Runtime Event Log: Model messages, Tool calls, Tool results, Permission facts, Usage facts, and Terminal facts. Understand your agent interactions.

- Tags: deep-dive
- Published: 2026-08-28

### [Understanding SessionManager and AgentRun in Apache Maka: Runtime Execution Architecture](/apache/maka/apache-maka-sessionmanager-agentrun-purpose)

Explore Apache Maka's SessionManager and AgentRun for robust runtime execution. Understand their roles in session management and durable per-turn execution with persistence and recovery.

- Tags: architecture
- Published: 2026-08-28

### [What Surfaces Communicate with Maka's Runtime Host? A Complete Guide to Apache Maka Client Interfaces](/apache/maka/apache-maka-runtime-host-surfaces-communication)

Explore the four surfaces that communicate with Maka's Runtime Host: Desktop UI, TUI, CLI, and Eval API. Learn about their distinct transport mechanisms and how they interact.

- Tags: how-to-guide
- Published: 2026-08-28

### [What Is the Sandbox Boundary in Apache Maka and How Does It Enforce Security](/apache/maka/apache-maka-sandbox-boundary-security-enforcement)

Understand the Apache Maka sandbox boundary. Learn how this declarative permission profile secures user sessions by isolating filesystem and network access through validation and kernel interception.

- Tags: security-guide
- Published: 2026-08-28

### [Understanding the Event Sourcing Pattern in Maka's Runtime Event Log](/apache/maka/apache-maka-event-sourcing-runtime-event-log)

Discover the event sourcing pattern in Maka's Runtime Event Log. Learn how immutable JSON events ensure durable execution and deterministic replay for robust application state management.

- Tags: deep-dive
- Published: 2026-08-28

### [How Apache Maka's Runtime Host Manages Execution Authority: A Deep Dive into the Single Authority Model](/apache/maka/apache-maka-runtime-host-execution-authority)

Discover how Apache Maka's Runtime Host manages execution authority using a single authority model. Learn about RootAuthority, RootTurnCoordinator, and lifecycle tracking.

- Tags: deep-dive
- Published: 2026-08-28

### [How Apache Maka Handles Child Agent Coordination and Root Turn Orchestration](/apache/maka/how-maka-handle-child-agent-coordination-and-root-turn-orchestration)

Apache Maka manages child agent coordination via pluggable callbacks and orchestrates root turns using TurnScope for isolated, bounded execution with strict concurrency control.

- Tags: internals
- Published: 2026-08-27

### [Eval Subjects vs External Subjects in Maka: Benchmark Architecture Guide](/apache/maka/what-difference-between-eval-subjects-and-external-subjects-in-maka-benchmark-architecture)

Understand Eval Subjects vs External Subjects in Maka benchmark architecture. Learn how Eval Subjects run within Maka for managed workloads, while External Subjects test competitor systems.

- Tags: architecture
- Published: 2026-08-27

### [How Maka Manages OAuth Subscriptions and Determines Execution Authority](/apache/maka/how-maka-manage-oauth-subscriptions-and-determine-execution-authority)

Discover how Apache Maka manages OAuth subscriptions and execution authority using its runtime subsystem and Agent Graph Coordinator for efficient session control and token retrieval.

- Tags: how-to-guide
- Published: 2026-08-27

### [Apache Maka Skill Catalog Architecture and Skill Invocation Flow Explained](/apache/maka/what-architecture-skill-catalog-in-maka-and-how-skill-invocation-flow-work)

Explore Apache Maka's dual-layer skill catalog architecture and understand its seven-step skill invocation flow, from token parsing to runtime dispatch. Learn how Maka manages and executes skills.

- Tags: architecture
- Published: 2026-08-27

### [How Agent Graph Git Worktree Isolation Enables Sub‑Agent Execution in Apache Maka](/apache/maka/how-agent-graph-git-worktree-isolation-facilitate-sub-agent-execution-in-maka)

Discover how Maka's agent graph Git worktree isolation enables sub-agent execution, preventing filesystem changes from leaking between sessions for secure and efficient operations.

- Tags: internals
- Published: 2026-08-27

### [Security Boundaries, Runtime Policies, and Access Authority Management in Apache Maka](/apache/maka/what-security-boundaries-in-maka-and-how-runtime-policies-activated-and-access-authority-managed)

Understand Apache Maka's security boundaries, runtime policies, and access authority management. Discover its layered security model for robust access control.

- Tags: security-guide
- Published: 2026-08-27

### [How Apache Maka Tracks Model Usage, Maintains a Usage Ledger, and Calculates Pricing](/apache/maka/how-maka-track-model-usage-maintain-usage-ledger-and-calculate-pricing)

Apache Maka tracks LLM usage with a JSONL ledger aggregates data applies pricing rules for per-turn costs and provides a telemetry API for billing and session recovery.

- Tags: how-to-guide
- Published: 2026-08-27

### [How MCP (Model Context Protocol) is Integrated with Maka for Secret Management](/apache/maka/how-mcp-model-context-protocol-integrated-with-maka-for-secret-management)

Learn how Maka integrates MCP for secure secret management. Discover how Maka harvests secrets, maintains inventory, and scrubs messages to prevent credential leaks.

- Tags: how-to-guide
- Published: 2026-08-27

### [How Session Branching, Archiving, Search, and Recovery Work in Apache Maka](/apache/maka/how-session-branching-archiving-search-and-recovery-work-in-apache-maka)

Discover how Apache Maka handles session branching, archiving, search, and recovery. Learn about immutable snapshots, soft-delete archiving, ledger-indexed metadata, and two-phase recovery for robust data management.

- Tags: deep-dive
- Published: 2026-08-27

### [How the Permission Profile System Enables Sandboxed Tool Execution in Apache Maka](/apache/maka/how-permission-profile-system-enable-sandboxed-tool-execution-in-maka)

Discover how Apache Maka’s permission profile system secures tool execution. It defines file paths, network access, and sandbox types, compiling them into OS-specific configurations for isolated environments.

- Tags: internals
- Published: 2026-08-27

### [SQLite Storage Schema for Runtime State Persistence in Apache Maka](/apache/maka/what-sqlite-storage-schema-used-for-runtime-state-persistence-in-maka)

Explore the SQLite storage schema Apache Maka uses for runtime state persistence. Discover how it manages events, journal entries, and workspace versions with WAL mode and incremental migrations.

- Tags: architecture
- Published: 2026-08-27

### [How Does Computer Use Mode Work in Maka? Backend Selection and Frame Budget Management Explained](/apache/maka/how-computer-use-mode-work-in-maka-including-backend-selection-and-frame-budget-management)

Discover how Maka's Computer Use Mode leverages backend selection and frame budgets to empower LLMs to control your desktop securely and efficiently. Learn about its architecture and runaway prevention.

- Tags: deep-dive
- Published: 2026-08-27

### [Apache Maka Built-in Tools: Read, Write, Edit, Bash, Glob, and Grep Explained](/apache/maka/what-built-in-tools-in-apache-maka-like-read-write-edit-bash-glob-and-grep)

Explore Apache Maka's built-in tools Read, Write, Edit, Bash, Glob, and Grep. Learn how these stateless Java classes enable safe concurrent file operations and shell execution.

- Tags: deep-dive
- Published: 2026-08-27

### [How to Run Multi-Arm Benchmark Experiments with Eval Cells and Attempts in Apache Maka](/apache/maka/how-run-multi-arm-benchmark-experiments-with-eval-cells-and-attempts-in-maka)

Learn to run multi-arm benchmark experiments in Apache Maka. Execute multiple subjects simultaneously using Eval Cells and Attempts for reproducible results.

- Tags: how-to-guide
- Published: 2026-08-27

### [How the Apache Maka Credential Vault Manages Local Secret Storage and Security](/apache/maka/what-credential-vault-in-maka-and-how-it-handle-local-secret-storage-and-security)

Discover the Apache Maka credential vault and its secure local secret storage. Learn about its two-tier architecture, strict permissions, and atomic operations for robust security.

- Tags: how-to-guide
- Published: 2026-08-27

### [How to Configure and Manage Multiple Model Connections in Apache Maka](/apache/maka/how-configure-and-manage-multiple-model-connections-in-apache-maka)

Learn to configure and manage multiple model connections in Apache Maka using the JSON catalog and management interface. Integrate AI services efficiently.

- Tags: how-to-guide
- Published: 2026-08-27

### [Agent Graph Architecture for Multi-Agent Task Scheduling in Apache Maka](/apache/maka/what-agent-graph-architecture-for-multi-agent-task-scheduling-in-maka)

Explore Maka's Agent Graph architecture for efficient multi-agent task scheduling. Orchestrate dynamic work across child agents without a second runtime.

- Tags: architecture
- Published: 2026-08-27

### [What Is the Sandbox Boundary in Apache Maka and How Is Tool Access Approved?](/apache/maka/what-is-sandbox-boundary-in-apache-maka-and-how-tool-access-approved)

Understand the Apache Maka sandbox boundary for secure tool execution. Learn how manifest validation approves tool access against an explicit capability allowlist.

- Tags: deep-dive
- Published: 2026-08-27

### [How Apache Maka Manages Session Lifecycle and Admission Control](/apache/maka/how-does-apache-maka-runtime-host-manage-session-lifecycle-and-admission-control)

Apache Maka ensures session security with admission control and manages session lifecycle from startup to close. Learn how Maka reserves, admits, and isolates each session.

- Tags: deep-dive
- Published: 2026-08-27

### [How Apache Maka Handles Streaming Output and Token Usage Tracking with Model Providers](/apache/maka/maka-streaming-output-token-usage)

Apache Maka efficiently streams LLM outputs and tracks token usage across providers with delta functions and unified storage. Discover how Maka optimizes your model interactions.

- Tags: internals
- Published: 2026-08-26

### [What Is the Model Factory in @maka/runtime? Purpose and Implementation](/apache/maka/maka-runtime-model-factory-purpose)

Discover the @maka/runtime model factory purpose. Learn how it creates live objects from static definitions, injecting dependencies for Apache Maka components and enabling custom registrations.

- Tags: deep-dive
- Published: 2026-08-26

### [How Apache Maka Connects to Different Model Providers and Manages Concurrent Connections](/apache/maka/maka-model-provider-connections)

Learn how Apache Maka connects to diverse LLM providers using its pluggable adapter architecture for efficient, concurrent connection management and centralized error handling.

- Tags: how-to-guide
- Published: 2026-08-26

### [Apache Maka runtime-host Package: Architecture and Communication Protocol Explained](/apache/maka/maka-runtime-host-package-protocol)

Explore the Apache Maka runtime-host package, the execution engine orchestrating agent lifecycles and host-client communication via a JSON protocol.

- Tags: architecture
- Published: 2026-08-26

### [How to Enable the Resume System in Maka (MAKA_RUNTIME_SAFE_BOUNDARY_RESUME)](/apache/maka/maka-enable-resume-system)

Enable Maka's Safe Boundary Resume by setting MAKA_RUNTIME_SAFE_BOUNDARY_RESUME=1. Unlock the Desktop UI button, CLI /resume, and automatic crash recovery for a smoother development experience.

- Tags: how-to-guide
- Published: 2026-08-26

### [How Maka's Resume System Creates a New Execution Instead of Reviving an Old Process](/apache/maka/maka-resume-new-execution-vs-revival)

Discover how Maka's resume system initiates new executions by replaying context from an immutable ledger, avoiding old process resurrection. Learn the technical details.

- Tags: internals
- Published: 2026-08-26

### [Critical Invariant for a Terminal Run in Apache Maka: Event Log Immutability](/apache/maka/maka-terminal-run-invariant)

Discover the critical invariant for a terminal Apache Maka Run event log immutability. Learn how this ensures deterministic crash recovery and race-free downstream consumption.

- Tags: internals
- Published: 2026-08-26

### [The Four Phases of Maka's Resume System and Their Safety Guarantees](/apache/maka/maka-resume-system-phases-safety)

Explore Maka's resume system four phases Crash Contract Safe-Boundary Contract Extraction-Ledger Design and Workspace-Bound Continuation. Learn their safety guarantees against replay data corruption and inconsistent state.

- Tags: deep-dive
- Published: 2026-08-26

### [How Maka's Crash Recovery and Resume System Achieves Process-Crash Convergence](/apache/maka/maka-crash-recovery-resume-system)

Learn how Maka achieves process-crash convergence by replaying immutable events detecting safe boundaries and deterministically repairing tool calls for reliable execution.

- Tags: internals
- Published: 2026-08-26

### [ToolRuntime in @maka/runtime: Core Responsibilities and Architecture Explained](/apache/maka/maka-toolruntime-responsibilities)

Explore the core responsibilities and architecture of ToolRuntime in @maka/runtime. Understand how it orchestrates tool lifecycles, enforces safety, and ensures reliable execution.

- Tags: architecture
- Published: 2026-08-26

### [Understanding commitToolPrepared (T1) and commitToolOutcome (T2) in Apache Maka's Tool Execution](/apache/maka/maka-t1-t2-commit-tool-execution)

Learn how Apache Maka uses commitToolPrepared T1 and commitToolOutcome T2 for robust tool execution. Discover how these phases ensure crash recovery and exactly-once semantics for your operations.

- Tags: internals
- Published: 2026-08-26

### [How Maka Handles Tool Execution Using the T1/T2 Protocol: A Complete Guide](/apache/maka/maka-tool-execution-t1-t2-protocol)

Learn how Maka handles tool execution with the T1/T2 protocol. Discover how it ensures durable execution and crash recovery with its two-phase checkpoint system.

- Tags: how-to-guide
- Published: 2026-08-26

### [Understanding the Lifecycle Concepts of sessionId, turnId, and runId in Apache Maka](/apache/maka/maka-session-turn-run-identities)

Explore Apache Maka's sessionId, turnId, and runId lifecycle concepts. Understand how these identifiers manage conversations, model executions, and request-response pairs for effective data flow.

- Tags: deep-dive
- Published: 2026-08-26

### [How Maka Ensures the Ordered Sequence of Events in the RuntimeEventStore](/apache/maka/maka-runtimeeventstore-event-sequence-ordering)

Learn how Maka ensures ordered events in RuntimeEventStore using SQLite, single-writer coordination, and transactional durability for deterministic replay.

- Tags: internals
- Published: 2026-08-26

### [Understanding SessionStore vs AgentRunStore vs RuntimeEventStore in Apache Maka](/apache/maka/maka-storage-stores-comparison)

Learn the differences between Apache Maka's SessionStore AgentRunStore and RuntimeEventStore. Understand their roles in session state model execution and runtime telemetry for reliable recovery and debugging.

- Tags: deep-dive
- Published: 2026-08-26

### [How Maka's Core Contracts Are Implemented Using SQLite in `packages/storage`](/apache/maka/maka-storage-sqlite-implementation)

Discover how Maka's core contracts leverage SQLite within packages storage. Learn about versioned schemas, typed store classes, and Node.js native driver implementation for robust data management.

- Tags: internals
- Published: 2026-08-26

### [Complete Guide to Contracts Defined in the @maka/core Package](/apache/maka/maka-core-package-contracts)

Discover the TypeScript contracts in @maka/core like Event, Message, and Command. Unify communication across Maka's runtime, UI, CLI, and host boundaries.

- Tags: api-reference
- Published: 2026-08-26

### [What Is the apps/desktop Directory in the Maka Repository? Purpose and Architecture Explained](/apache/maka/maka-repo-desktop-directory-purpose)

Explore the apps/desktop directory in Apache Maka. Understand its purpose as the Electron desktop client and its secure three-layer architecture separating Node, bridge, and React UI.

- Tags: internals
- Published: 2026-08-26

### [What Types of Data Are Recorded as Durable Facts in Maka's Runtime Event Log?](/apache/maka/maka-event-log-durable-facts)

Discover the six durable facts Apache Maka records in its Runtime Event Log: model messages, tool calls, tool results, permissions, usage records, and terminal facts for deterministic replay and crash recovery.

- Tags: deep-dive
- Published: 2026-08-26

### [How System State Is Projected from the Runtime Event Log in Apache Maka](/apache/maka/maka-state-projection-from-event-log)

Learn how Apache Maka projects system state from its Runtime Event Log. Discover how this immutable ledger drives model history, UI views, and recovery data.

- Tags: internals
- Published: 2026-08-26

### [What Is the Runtime Event Log in Apache Maka and Why Is It the Semantic Source of Truth?](/apache/maka/maka-runtime-event-log-source-of-truth)

Discover the Apache Maka Runtime Event Log. This immutable ledger is the semantic source of truth for agent execution, ensuring consistent state and crash recovery for all system components.

- Tags: deep-dive
- Published: 2026-08-26

### [How Maka's Local-First Agent Workspace Architecture Differs from Remote Agent Services](/apache/maka/maka-local-first-architecture-vs-remote)

Discover how Maka's local-first agent workspace architecture empowers local state storage and execution authority, contrasting with remote agent services that offer extensions.

- Tags: architecture
- Published: 2026-08-26

### [Architecture of the Tool Runtime in Apache Maka: A Deep Dive into the Execution Stack](/apache/maka/apache-maka-tool-runtime-architecture)

Explore the Tool Runtime architecture in Apache Maka. Understand how it validates policies, enforces boundaries, streams output, and ensures deterministic recovery for tool invocations.

- Tags: architecture
- Published: 2026-08-25

### [How Apache Maka's Graph Implementation Uses Isolated Git Worktrees for Agent Execution](/apache/maka/apache-maka-graph-implementation-isolated-git-worktrees)

Apache Maka uses isolated Git worktrees for agent execution. Discover how this creates lightweight sandboxes, preventing contamination and enabling deterministic replay for your graph-based workflows.

- Tags: internals
- Published: 2026-08-25

### [Architecture of the Credential Vault in Apache Maka: Bounded JSON Storage for Workspace Secrets](/apache/maka/apache-maka-credential-vault-architecture)

Explore the Apache Maka credential vault architecture a bounded JSON document for secure API key and password storage with optimistic concurrency and versioning.

- Tags: architecture
- Published: 2026-08-25

### [How the Apache Maka Desktop Session Projection System Works: A Technical Deep Dive](/apache/maka/apache-maka-desktop-session-projection-system-how-it-works)

Explore the technical details of Apache Maka's desktop session projection system. Learn how it combines logs and streaming data for efficient UI updates without full replay.

- Tags: deep-dive
- Published: 2026-08-25

### [How Apache Maka Handles Multi-Arm Experiments: Eval System Architecture](/apache/maka/apache-maka-eval-system-multi-arm-experiments)

Discover how Apache Maka handles multi-arm experiments by transforming them into discrete ExperimentCell objects orchestrated by the harbor executor. Learn the core of its eval system architecture.

- Tags: architecture
- Published: 2026-08-25

### [What Is Context Compaction in Apache Maka and How Does It Work?](/apache/maka/apache-maka-context-compaction-explanation)

Learn how context compaction in Apache Maka compresses session history. Discover its token budget, checkpoint creation, and efficient interaction summarization for improved performance.

- Tags: deep-dive
- Published: 2026-08-25

### [How the Apache Maka Sandbox Boundary Controls File‑Write Operations for Tools](/apache/maka/apache-maka-sandbox-boundary-file-writing-tools)

Learn how Apache Maka's sandbox boundary controls tool file writes using explicit declarations, validation, and runtime path matching for secure filesystem access.

- Tags: internals
- Published: 2026-08-25

### [How Apache Maka's Runtime Event Log Enables Crash Recovery](/apache/maka/apache-maka-runtime-event-log-crash-recovery)

Discover how Apache Maka's Runtime Event Log uses immutable event sourcing for deterministic crash recovery and session restoration. Learn about safe-boundary continuation planning.

- Tags: internals
- Published: 2026-08-25

### [Runtime Event Log in Apache Maka: Immutable Ledger and Projection Architecture](/apache/maka/apache-maka-runtime-event-log-architecture)

Discover Apache Maka's Runtime Event Log architecture. Learn how immutable events create a single source of truth with projection layers for context budgeting and history compaction.

- Tags: architecture
- Published: 2026-08-25

### [How Apache Maka’s Runtime Host Manages the Session Lifecycle](/apache/maka/apache-maka-runtime-host-session-lifecycle-management)

Discover how Apache Maka's Runtime Host manages the session lifecycle across five key phases: creation, activation, live streaming, draining, and termination. Learn about its coordinators and graceful shutdown.

- Tags: internals
- Published: 2026-08-25

### [T1 and T2 Side Effect Boundaries in Apache Maka: A Complete Guide](/apache/maka/what-are-t1-and-t2-side-effect-boundaries-in-maka)

Understand T1 and T2 side effect boundaries in Apache Maka. Learn how Maka ensures exactly-once semantics for tool execution and immutable results.

- Tags: deep-dive
- Published: 2026-08-24

### [Resume vs Retry in Apache Maka: Understanding the Recovery Process Difference](/apache/maka/difference-between-resume-and-retry-in-maka-recovery)

Learn the difference between resume and retry in Apache Maka's recovery. Resume uses checkpoints for seamless continuation, while retry starts fresh. Understand Maka's process.

- Tags: deep-dive
- Published: 2026-08-24

### [How Apache Maka Handles Crash Recovery and Resuming Operations: A Technical Deep Dive](/apache/maka/how-does-maka-handle-crash-recovery-and-resuming)

Apache Maka ensures operational continuity after crashes using a three-tier architecture for transactions, continuations, and recovery bundles. Learn how Maka handles crash recovery and resumes operations.

- Tags: deep-dive
- Published: 2026-08-24

### [What Are the Four Distinct Identities Managed by Maka?](/apache/maka/what-are-four-distinct-identities-managed-by-maka)

Discover the four distinct identities Session ID Turn ID Run ID and Message ID managed by Maka. Learn how Maka ensures deterministic provenance for AI workflows.

- Tags: deep-dive
- Published: 2026-08-24

### [What Information Does a RuntimeEvent Preserve in Apache Maka](/apache/maka/what-information-does-runtimeevent-preserve)

Discover what information a RuntimeEvent preserves in Apache Maka. Learn how it captures metadata, flags, payload, and provenance for complete agent execution records.

- Tags: internals
- Published: 2026-08-24

### [How Maka's Runtime Event Log Defines System State: Event Sourcing Implementation](/apache/maka/how-maka-runtime-event-log-defines-system-state)

Discover how Maka's Runtime Event Log defines system state through event sourcing. Learn how append-only events and computeState() reconstruct system conditions.

- Tags: deep-dive
- Published: 2026-08-24

### [Finding the Maka CLI Implementation in the Apache Maka Repository](/apache/maka/where-to-find-maka-cli-implementation)

Locate the Maka CLI implementation within the apache/maka repository. Find the entry point and core logic in the packages/cli workspace. Discover the exact file paths for quick access.

- Tags: how-to-guide
- Published: 2026-08-24

### [Apache Maka `packages/eval` Directory Responsibilities: Experiment Evaluation Framework](/apache/maka/responsibilities-of-packages-eval-directory)

Explore the Apache Maka packages eval directory, its core evaluation framework, experiment semantics, validation, trial orchestration, and result normalization responsibilities.

- Tags: internals
- Published: 2026-08-24

### [Apache Maka Runtime Host Structure: A Deep Dive into the Kernel Architecture](/apache/maka/how-is-runtime-host-structured-in-maka-code)

Explore the Apache Maka Runtime Host structure and kernel architecture. Discover its layered execution environment, handlers, listeners, and residency management for complete workspace lifecycle operations.

- Tags: deep-dive
- Published: 2026-08-24

### [What Does the packages/runtime Directory Handle in Apache Maka](/apache/maka/what-does-packages-runtime-directory-handle)

Discover what the packages/runtime directory handles in Apache Maka. Learn how it orchestrates agent turns through tool runtime management, model adapter resolution, sandbox enforcement, and persistence.

- Tags: internals
- Published: 2026-08-24

### [Where is Maka's Storage Implementation Located? Inside Apache Maka's Persistence Layer](/apache/maka/where-is-maka-storage-implementation-located)

Discover Maka's storage implementation in the packages storage package. Explore its SQLite-backed persistence layer for root authority management and filesystem durability.

- Tags: internals
- Published: 2026-08-24

### [What Is the packages/core Directory in Apache Maka? Foundational Types Explained](/apache/maka/purpose-of-packages-core-directory-maka)

Explore the packages/core directory in Apache Maka. Understand foundational types for session semantics, capability modeling, and event contracts, powering the entire platform.

- Tags: internals
- Published: 2026-08-24

### [How to Run Reproducible Benchmark Experiments with Maka Eval: A Complete Guide](/apache/maka/how-to-run-benchmark-experiments-with-maka-eval)

Learn to run reproducible benchmark experiments with Maka Eval. This guide covers deterministic benchmarking using JSON specs, a CLI, and immutable logs for reliable results.

- Tags: how-to-guide
- Published: 2026-08-24

### [How to Use Maka’s TUI/CLI for Project Interaction](/apache/maka/how-to-use-maka-tui-cli-for-project-interaction)

Learn to interact with your projects using Maka's TUI/CLI. This guide shows you how to leverage Maka for seamless command-line and interactive terminal UI operations.

- Tags: how-to-guide
- Published: 2026-08-24

### [Apache Maka Entry Points: CLI, Runtime, and UI Integration Guide](/apache/maka/what-are-different-entry-points-for-maka)

Explore Apache Maka entry points: CLI, Runtime, Eval, UI, and Storage. Integrate Maka locally, programmatically, or remotely for flexible development and custom interfaces.

- Tags: how-to-guide
- Published: 2026-08-24

### [How the Runtime Event Log Serves as the Canonical Source of Truth in Apache Maka](/apache/maka/how-does-runtime-event-log-function-as-source-of-truth)

Discover how Maka's Runtime Event Log acts as the central source of truth. Understand agent interactions and system state through this immutable ledger. Learn more today.

- Tags: internals
- Published: 2026-08-24

### [How Apache Maka Ensures Consistent Behavior Across Desktop, CLI, and Eval Entry Points](/apache/maka/how-does-maka-ensure-consistent-behavior-across-entry-points)

Learn how Apache Maka ensures consistent behavior across desktop CLI and eval entry points. Discover its Runtime Host architecture for unified session and tool management.

- Tags: architecture
- Published: 2026-08-24

### [What Is the Runtime Host in Maka? Architecture and Responsibilities Explained](/apache/maka/what-is-the-role-of-the-runtime-host-in-maka)

Discover the Maka Runtime Host a vital long-lived process responsible for durable state and executing all Runtime work. Learn its architecture and key responsibilities.

- Tags: architecture
- Published: 2026-08-24

### [How Maka's Local-First Architecture Works: Runtime Host and SQLite Ledger](/apache/maka/how-does-maka-local-first-architecture-work)

Discover Maka's local-first architecture. Learn how the Runtime Host and SQLite ledger manage execution state, user data, and session history with full data sovereignty.

- Tags: architecture
- Published: 2026-08-24

### [What Is Apache Maka? A Local-First, Agent-Driven Workspace Explained](/apache/maka/what-is-apache-maka)

Discover Apache Maka, a local-first, agent-driven workspace. Run AI-augmented tools on your machine with a unified Runtime Host coordinating UI, terminal, and bots.

- Tags: getting-started
- Published: 2026-08-24

### [Key Features of Maka's Evaluation Framework: LLM-Driven Goal Assessment for Autonomous Coding](/apache/maka/what-are-the-key-features-of-maka-s-evaluation-framework)

Discover Maka's LLM-driven evaluation framework for autonomous coding. It assesses goal status after each turn to optimize development.

- Tags: deep-dive
- Published: 2026-08-22

### [How to Extend Maka's Capabilities Using the Skills System](/apache/maka/how-can-i-extend-maka-s-capabilities-using-the-skills-system)

Learn how to extend Maka's capabilities by creating a SKILL.md file. Regenerate the catalog and let Maka automatically load new skills at runtime for enhanced functionality.

- Tags: how-to-guide
- Published: 2026-08-22

### [Which Messaging Platforms Does Maka's Bot System Support? A Complete Guide to the 8 Providers](/apache/maka/which-messaging-platforms-does-maka-s-bot-system-support)

Explore the 8 messaging platforms Maka's bot system supports including Telegram, Slack, Discord, and more. Integrate seamlessly with your favorite providers.

- Tags: how-to-guide
- Published: 2026-08-22

### [Apache Maka Computer Use Capabilities: A Complete Guide to the maka_computer Tool](/apache/maka/what-are-the-computer-use-capabilities-provided-by-maka)

Explore Apache Maka's `maka_computer` tool for semantic desktop automation. Learn how LLMs can observe UI, click, type, scroll, and more with strict safety.

- Tags: how-to-guide
- Published: 2026-08-22

### [How Maka Recovers Session State on Startup After an Interruption](/apache/maka/how-does-maka-recover-session-state-on-startup-after-an-interruption)

Learn how Maka recovers session state after interruptions. Maka queries SQLite for projections and bundles, rebuilds the operation graph, and re-hydrates UI layers for a seamless restore.

- Tags: how-to-guide
- Published: 2026-08-22

### [How to Enable Safe Resume for Interrupted Turns in Apache Maka](/apache/maka/how-can-i-enable-safe-resume-for-interrupted-turns-in-maka)

Enable safe resume for interrupted turns in Apache Maka by setting MAKA_RUNTIME_SAFE_BOUNDARY_RESUME=1. Seamlessly continue execution from the last safe boundary after interruptions.

- Tags: how-to-guide
- Published: 2026-08-22

### [How Credentials Are Stored and Protected in Apache Maka](/apache/maka/how-are-credentials-stored-and-protected-in-maka)

Discover how Apache Maka secures user credentials in a dedicated JSON vault. Learn about its size limits, atomic operations, and API access for robust protection against exposure.

- Tags: internals
- Published: 2026-08-22

### [Where Is Workspace Data Stored by Default in Maka?](/apache/maka/where-is-workspace-data-stored-by-default-in-maka)

Discover where Maka stores workspace data by default on macOS Windows and Linux Learn about the Maka client data directory structure for efficient data management

- Tags: how-to-guide
- Published: 2026-08-22

### [What Data Is Stored in `runtime.sqlite` in Apache Maka](/apache/maka/what-data-is-stored-in-runtime-sqlite)

Discover what data resides in Apache Maka's runtime.sqlite database. Learn about its six core entities including Sessions, User Messages, and Automations.

- Tags: deep-dive
- Published: 2026-08-22

### [How the Agent Graph System Schedules Dependent Work in Apache Maka](/apache/maka/how-does-the-agent-graph-system-schedule-dependent-work)

Discover how the Apache Maka Agent Graph system schedules dependent work by binding inputs and deferring execution until upstream results are committed. Learn about its dependency validation.

- Tags: internals
- Published: 2026-08-22

### [What Features Do Maka's Tools Offer: A Complete Guide to Apache Maka's Built-in Tool Suite](/apache/maka/what-features-do-maka-s-tools-offer)

Discover Apache Maka's powerful tool features. Explore filesystem operations, shell execution, web search, automation, and multi-agent orchestration, all securely managed.

- Tags: how-to-guide
- Published: 2026-08-22

### [Available Local Tools in Maka's Tool Runtime: Complete Reference](/apache/maka/what-are-the-available-local-tools-in-maka-s-tool-runtime)

Discover Maka's eight core local tools including Bash Read Write Edit FormatJson Glob Grep and Apply Patch Explore this complete reference for Maka's tool runtime.

- Tags: api-reference
- Published: 2026-08-22

### [Apache Maka Runtime Host: Understanding the Public Client/Protocol Boundary](/apache/maka/what-is-the-public-client-protocol-boundary-managed-by-packages-runtime-host)

Understand the Apache Maka runtime host's public client/protocol boundary. Learn how its stable JSON API over WebSocket separates client communication into Protocol and Transport layers.

- Tags: internals
- Published: 2026-08-22

### [How Maka Handles Storage and SQLite Control Planes in `packages/storage`](/apache/maka/how-does-maka-handle-storage-and-sqlite-control-planes-in-packages-storage)

Explore how Maka manages storage and SQLite control planes in packages/storage. Learn about its storage-root authority, capabilities, leases, and transactional SQLite databases for secure data management.

- Tags: internals
- Published: 2026-08-22

### [Core Contracts Defined in the packages/core Directory: Apache Maka's Type Foundation](/apache/maka/what-are-the-core-contracts-defined-in-the-packages-core-directory)

Explore Apache Maka's core contracts in packages/core. Discover immutable TypeScript structures for workspace versioning, events, and recovery, ensuring type-safe interoperability across Maka's layers.

- Tags: internals
- Published: 2026-08-22

### [What Is the Responsibility of the @maka/eval Package in Apache Maka?](/apache/maka/what-is-the-responsibility-of-the-maka-eval-package)

Discover the core responsibility of the @maka/eval package in Apache Maka. Learn how it acts as the semantic engine for experiment schemas, execution, and validation.

- Tags: deep-dive
- Published: 2026-08-22

### [Understanding Apache Maka Architecture Layers: A Deep Dive into the Runtime Stack](/apache/maka/what-are-the-different-layers-in-apache-maka-s-architecture)

Explore Apache Maka's architecture. Understand its four runtime layers: Event Log, SessionManager & AgentRun, Agent Graph, and Storage, for immutable history, scheduling, and persistence.

- Tags: architecture
- Published: 2026-08-22

### [How Apache Maka Implements Context Pruning and LLM Compaction](/apache/maka/how-does-maka-implement-context-pruning-and-llm-compaction)

Discover how Apache Maka employs a layered context-budget system for active tool-result pruning, payload archiving, semantic rewriting, and history compaction. Optimize LLM token counts while retaining meaning.

- Tags: internals
- Published: 2026-08-22

### [What Is the Runtime Event Log in Apache Maka? A Complete Technical Guide](/apache/maka/what-is-the-runtime-event-log-and-what-information-does-it-store)

Discover the Apache Maka Runtime Event Log a persistent record of runtime events with timestamps and payloads enabling deterministic replay crash recovery and auditability.

- Tags: deep-dive
- Published: 2026-08-22

### [How Session and Turn Identities Are Managed in Maka: A Technical Deep Dive](/apache/maka/how-are-session-and-turn-identities-managed-in-maka)

Discover how Maka manages session and turn identities using stable IDs LRU caches and stateful hooks for efficient conversation context tracking. Learn more.

- Tags: deep-dive
- Published: 2026-08-22

### [What Is the Runtime Host in Apache Maka? Execution Authority and Architecture](/apache/maka/what-is-the-role-of-the-runtime-host-in-apache-maka-s-execution-model)

Discover the Runtime Host in Apache Maka. It acts as the central execution authority, managing agent lifecycles and maintaining the event log as the sole truth.

- Tags: architecture
- Published: 2026-08-22

### [Apache Maka Primary Supported Platform: macOS Apple Silicon (arm64) Explained](/apache/maka/what-is-the-primary-supported-platform-for-apache-maka)

Discover Apache Maka's primary supported platform: macOS Apple Silicon arm64. Learn why it's the only production-grade stable build available for this powerful architecture.

- Tags: getting-started
- Published: 2026-08-22

### [Apache Maka Data Storage and Control: How the Local-First AI Assistant Differs from Cloud-Hosted Solutions](/apache/maka/how-does-apache-maka-differ-from-cloud-hosted-ai-coding-assistants-regarding-data-storage-and-control)

Discover how Apache Maka's local-first approach secures your data, unlike cloud AI assistants. Control your prompts and configurations entirely on your machine.

- Tags: deep-dive
- Published: 2026-08-22