{"id":"maka","repo":"geoqiao/paseo-stuff","url":"https://github.com/geoqiao/paseo-stuff/tree/main/plugins/maka","name":"maka","description":"MaKa through its ACP provider for Paseo 0.8.","categories":["provider"],"platforms":[],"caveats":["Experimental: requires Paseo 0.8, Node >=22.19, and configured maka-agent 0.2.0-dev.31.20260913.","Match MaKa Desktop and CLI versions before running; a newer CLI can migrate their shared database.","Current MaKa ACP exposes no tool cards/results, MCP forwarding, interactive approvals, or usage updates.","Connected follow-ups work; session restoration after plugin reload or daemon restart is unavailable.","Uses MaKa's configured default model and permissions; Paseo custom system prompts/tool policy are not applied.","Verified on macOS; real MaKa on Windows/Linux and native mobile UI remain unverified."],"images":[],"health":{"manifestValid":true,"hasReadme":true,"hasLicense":true,"hasTests":true,"hasTypecheckScript":true,"updatedRecently":true},"scannedAt":"2026-09-14T20:17:02.121Z","addedAt":"2026-09-14T20:43:04+03:00","path":"plugins/maka","version":"0.1.0-beta.1","security":{"status":"passed","blockingFindings":0,"advisoryFindings":0,"scannedAt":"2026-09-14T20:14:37.708Z","commit":"4f3f0d4f8e60dedc3f8c402e4e0b6000351e7fa7"},"license":"MIT","paseoVersionRequirement":">=0.8.0 <0.9.0","manifest":{"id":"maka","requirements":{"paseo":">=0.8.0 <0.9.0"},"build":[["npm","ci","--ignore-scripts","--legacy-peer-deps","--no-audit","--no-fund"],["npm","run","check"]]},"repoMeta":{"stars":0,"defaultBranch":"main","pushedAt":"2026-09-14T17:20:47Z"},"owner":{"login":"geoqiao","avatarUrl":"https://avatars.githubusercontent.com/u/105639506?v=4"},"installNotesHtml":"<p>Requirements: Paseo 0.8 with plugins enabled, Node.js 22.19 or newer, and a configured MaKa CLI\non the machine running the Paseo daemon. The tested MaKa build is pinned here because its ACP\ninterface is still evolving.</p>\n<p><strong>If you use MaKa Desktop, update it to the same release before starting the CLI.</strong> Both\napplications share MaKa's workspace database. A newer CLI can migrate that database into a\nformat an older desktop cannot open. For this tested CLI, use\n<a href=\"https://github.com/apache/maka/releases/tag/v0.2.0-dev.31.20260913\">MaKa Desktop 0.2.0-dev.31.20260913</a>.</p>\n<pre><code class=\"language-bash\">npm install --global maka-agent@0.2.0-dev.31.20260913\nmaka\n</code></pre>\n<p>Use MaKa's own UI to configure a working provider connection, credentials, and a default model,\nthen exit it. A working MaKa default is required before Paseo can discover the model catalog.\nThe plugin neither imports credentials nor changes your MaKa profile.</p>\n<p>Install the published plugin from GitHub:</p>\n<pre><code class=\"language-bash\">paseo plugin add geoqiao/paseo-stuff:plugins/maka --ref maka-v0.1.0-beta.1 --host 127.0.0.1:6767\n</code></pre>\n<p>For a local development checkout, run from this plugin directory instead:</p>\n<pre><code class=\"language-bash\">npm ci --ignore-scripts --legacy-peer-deps --no-audit --no-fund\nnpm run check\npaseo plugin install \"$PWD\" --host 127.0.0.1:6767\n</code></pre>\n<p>Replace the host with your daemon's address if different. For later source changes, run the\nchecks again, then <code>paseo plugin reload maka --host 127.0.0.1:6767</code>. Reloading ends existing\nMaKa sessions; create a new agent afterwards…</p>","readmeText":"# MaKa provider for Paseo\n\nAn experimental server-only plugin that adds **MaKa** to Paseo 0.8's provider picker through\nthe official `maka --acp` interface. It supports streamed conversations, real file and shell\nwork, follow-up prompts, cancellation, and MaKa's configuration selectors.\n\n## Install\n\nRequirements: Paseo 0.8 with plugins enabled, Node.js 22.19 or newer, and a configured MaKa CLI\non the machine running the Paseo daemon. The tested MaKa build is pinned here because its ACP\ninterface is still evolving.\n\n**If you use MaKa Desktop, update it to the same release before starting the CLI.** Both\napplications share MaKa's workspace database. A newer CLI can migrate that database into a\nformat an older desktop cannot open. For this tested CLI, use\n[MaKa Desktop 0.2.0-dev.31.20260913](https://github.com/apache/maka/releases/tag/v0.2.0-dev.31.20260913).\n\n```bash\nnpm install --global maka-agent@0.2.0-dev.31.20260913\nmaka\n```\n\nUse MaKa's own UI to configure a working provider connection, credentials, and a default model,\nthen exit it. A working MaKa default is required before Paseo can discover the model catalog.\nThe plugin neither imports credentials nor changes your MaKa profile.\n\nInstall the published plugin from GitHub:\n\n```bash\npaseo plugin add geoqiao/paseo-stuff:plugins/maka --ref maka-v0.1.0-beta.1 --host 127.0.0.1:6767\n```\n\nFor a local development checkout, run from this plugin directory instead:\n\n```bash\nnpm ci --ignore-scripts --legacy-peer-deps --no-audit --no-fund\nnpm run check\npaseo plugin install \"$PWD\" --host 127.0.0.1:6767\n```\n\nReplace the host with your daemon's address if different. For later source changes, run the\nchecks again, then `paseo plugin reload maka --host 127.0.0.1:6767`. Reloading ends existing\nMaKa sessions; create a new agent afterwards.\n\nSelect **MaKa → MaKa configured default** when creating an agent. The model label is a local\nselector for the model already chosen in MaKa; it does not switch the upstream model. Thinking\nlevels depend on that model. MaKa also exposes collaboration, permission, and orchestration\nconfiguration through ACP; Paseo presents the selectors supported by its public ACP shim.\n\nThe provider launches the executable with the working directory and environment supplied by\nPaseo. If `maka` is unavailable on the daemon's `PATH`, set `MAKA_PASEO_COMMAND` in the daemon's\nenvironment to the absolute executable path. This variable accepts an executable path only;\nthe plugin supplies `--acp` itself.\n\n## Current limits\n\nThe tested official MaKa ACP implementation has these boundaries:\n\n- **Tool visibility:** MaKa can execute file and shell tools, but ACP publishes only assistant\n  text and thinking. Paseo receives no tool cards, tool results, or usage updates.\n- **MCP:** MaKa rejects MCP servers. The plugin omits Paseo's MCP configuration and emits an\n  explicit session notice, without exposing its values. Paseo's agent-management MCP is also\n  unavailable inside MaKa conversations.\n- **Permissions and questions:** the interactive bridge is unavailable. The plugin preserves\n  MaKa's permission mode and never automatically approves tools. Tasks requiring an unsupported\n  interaction fail; resolve configuration through MaKa's own UI.\n- **History:** follow-ups work while the session is connected. Resume/load, imported history,\n  and restoration after plugin reload or daemon restart are unavailable. Requests carrying\n  persistence are rejected. Shutdown closes the owned ACP session and allows MaKa to cancel\n  its associated Runtime Host work before process termination.\n- **Prompt configuration:** MaKa does not apply Paseo's `_paseo` metadata, including custom\n  system prompts, provider options, or tool policy. Configure effective behavior in MaKa.\n- **Other input:** image prompts, provider commands, and prompt steering are unsupported.\n\nThe plugin rejects unsupported requests and documents the remaining upstream gaps. It uses\npublic SDKs and does not reconstruct missing features from private Runtime Host state.\n\nThese are limits of the tested MaKa ACP adapter, not the ACP protocol itself. Closing the ACP\nconnection does not delete MaKa's durable history; the adapter lacks a way to reopen it.\nSee the [upstream maintenance procedure](docs/upstream-maintenance.md) for how new MaKa releases\nare reviewed and supported capabilities are added.\n\n## Troubleshooting and verification\n\nCheck `maka --version`, ensure the same OS user can run MaKa with a working default, then inspect:\n\n```bash\npaseo plugin ls --host 127.0.0.1:6767\npaseo provider models maka --host 127.0.0.1:6767\npaseo plugin logs maka --host 127.0.0.1:6767\n```\n\nA configured free provider is not necessarily available for inference. Validate an ordinary\nprompt in MaKa if Paseo can discover selectors but turns time out.\n\nIf Desktop reports `OperationalStateMigrationBlockedError` or a schema newer than its supported\nversion, update Desktop to match the CLI. Changing schema version numbers or restoring only\npart of the database is not a compatible downgrade.\n\n`npm run check` runs TypeScript, lint, and tests against the public Paseo ACP shim and synthetic\nACP peers. Real CLI, installed-host, and UI evidence is in\n[`docs/verification.md`](docs/verification.md), including the versions and platform limits.\n"}