@cdmbase/yantra-htmlplan-editor

Yantra's HTML plan editor — serves agent-written HTML artifacts (plans, reports, comparisons, diagrams) in a local browser with element/text annotation and a feedback loop. Forked from lavish-axi and owned/customized here so the yantra-ai-htmlplan connector doesn't depend on a third-party package.

Why this fork exists

The yantra-ai-htmlplan cdecli connector spawns this editor as a child process and talks to its HTTP API (POST /api/sessions, GET /api/poll, GET /artifact/:key/index.html, POST /api/:key/prompts, POST /api/end). Vendoring it as our own package lets us pin the version, fix issues, and customize behavior (branding, base-path/proxy support, etc.) without waiting on upstream.

CLI

yantra-htmlplan-editor server --port 4387   # run the editor server (loopback)
yantra-htmlplan-editor <file.html>          # open/resume a session for an artifact
yantra-htmlplan-editor poll <file.html>     # long-poll for user feedback
yantra-htmlplan-editor end  <file.html>     # end a session

Config (env)

Internal config still uses the LAVISH_AXI_* env names (the connector sets them); these are the editor↔connector contract and may be rebranded later:

| Env | Meaning | | --- | --- | | LAVISH_AXI_PORT | server port (default 4387) | | LAVISH_AXI_HOST | bind address (default 127.0.0.1) | | LAVISH_AXI_LINK_HOST | hostname in generated links | | LAVISH_AXI_STATE_DIR | per-tenant session-store dir | | LAVISH_AXI_IDLE_TIMEOUT_MS | idle self-shutdown (0 disables) | | LAVISH_AXI_NO_OPEN | 1 to never auto-open a browser |

Build

npm install
npm run build      # esbuild → dist/cli.mjs + chrome/daisyui assets

Customization roadmap

• Rebrand internal identifiers (/health app id, LAVISH_AXI_* env) to yantra-htmlplan once the connector is updated in lockstep.
• Optional base-path support so the editor chrome can be embedded behind a sub-path reverse proxy (needed for full in-browser annotation via yantra-app).