{"_id":"@carter-mcalister/pi-rlm","name":"@carter-mcalister/pi-rlm","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.1":{"name":"@carter-mcalister/pi-rlm","version":"0.1.1","description":"RLM-first named workflow extension for Pi Coding Agent","author":{"name":"Carter McAlister"},"type":"module","exports":{".":"./src/index.ts","./types":"./src/types.ts"},"repository":{"type":"git","url":"git+https://github.com/CarterMcAlister/pi-packages.git","directory":"packages/pi-rlm"},"bugs":{"url":"https://github.com/CarterMcAlister/pi-packages/issues"},"homepage":"https://github.com/CarterMcAlister/pi-packages/tree/main/packages/pi-rlm#readme","publishConfig":{"access":"public"},"keywords":["pi-package","pi","pi-extension","rlm","workflow","ax-agent"],"scripts":{"format":"bunx @biomejs/biome check --write .","lint":"bunx @biomejs/biome check .","typecheck":"bunx tsc -p tsconfig.json --noEmit","test":"bun test","check":"bun run lint && bun run typecheck && bun run test"},"pi":{"extensions":["./src/index.ts"],"skills":["./skills"]},"dependencies":{"@ax-llm/ax":"^19.0.45","@mariozechner/jiti":"^2.6.5"},"peerDependencies":{"@mariozechner/pi-ai":"*","@mariozechner/pi-coding-agent":"*","@mariozechner/pi-tui":"*","@sinclair/typebox":"*"},"devDependencies":{"@biomejs/biome":"2.3.5","@mariozechner/pi-ai":"*","@mariozechner/pi-coding-agent":"*","@mariozechner/pi-tui":"*","@sinclair/typebox":"0.34.0","bun-types":"latest","typescript":"^5.9.3"},"license":"MIT","_id":"@carter-mcalister/pi-rlm@0.1.1","gitHead":"56c8968929841d7548233d939e5a544eba239e6e","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-4LbkjX2TIErfJzM0UC1hVJ9270hFxF265nQtywzTPMmfxgW1O+kkARz+eap/jNOOQTjs0sX1yNB8QghAYlfhKQ==","shasum":"a0c7b0ac378645158d127bc7887384e56e0a0a4d","tarball":"https://registry.npmjs.org/@carter-mcalister/pi-rlm/-/pi-rlm-0.1.1.tgz","fileCount":23,"unpackedSize":98421,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@carter-mcalister%2fpi-rlm@0.1.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEw52xvLBJR2okL8WxAFTUCQbLKumGyvfL6XKaB/5LAtAiA0tOqBGxofdeTTtGBowsiLJiDWT88BlOc/SgqVAjgeXg=="}]},"_npmUser":{"name":"carter-mcalister","email":"carterm126@gmail.com"},"directories":{},"maintainers":[{"name":"carter-mcalister","email":"carterm126@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-rlm_0.1.1_1776610079659_0.9549866877557704"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-19T14:47:59.570Z","0.1.1":"2026-04-19T14:47:59.854Z","modified":"2026-04-19T14:48:00.277Z"},"maintainers":[{"name":"carter-mcalister","email":"carterm126@gmail.com"}],"description":"RLM-first named workflow extension for Pi Coding Agent","homepage":"https://github.com/CarterMcAlister/pi-packages/tree/main/packages/pi-rlm#readme","keywords":["pi-package","pi","pi-extension","rlm","workflow","ax-agent"],"repository":{"type":"git","url":"git+https://github.com/CarterMcAlister/pi-packages.git","directory":"packages/pi-rlm"},"author":{"name":"Carter McAlister"},"bugs":{"url":"https://github.com/CarterMcAlister/pi-packages/issues"},"license":"MIT","readme":"# `@carter-mcalister/pi-rlm`\n\nRLM-first extension for [Pi Coding Agent](https://github.com/badlogic/pi-mono).\n\nThis package now exposes two distinct surfaces:\n\n- `rlm` / `/rlm` — a true recursive language model surface with planner, worker, and synthesizer nodes\n- `rlm_task` / `/rlm-task` — named reusable RLM workflows backed by Ax agents\n\n## What it is for\n\nUse `rlm` for open-ended tasks that may benefit from recursive decomposition:\n\n- repo architecture analysis\n- risk reviews\n- broad planning tasks\n- multi-part investigations\n- synthesis across several subproblems\n\nUse `rlm_task` for repeatable rubric-driven workflows:\n\n- incident reviews\n- RFC / design review checks\n- long-document analysis\n- manager-ready summaries with evidence\n\n## Install\n\n```bash\npi install npm:@carter-mcalister/pi-rlm\n```\n\nFor local development in this monorepo:\n\n```bash\npi install /absolute/path/to/pi-packages/packages/pi-rlm\n```\n\n## Recursive Tool\n\nThe `rlm` tool and `/rlm` command support:\n\n- `op: \"start\"` — start a recursive run\n- `op: \"status\"` — inspect a run or recent runs\n- `op: \"wait\"` — wait for a run to finish\n- `op: \"cancel\"` — cancel a running job\n\nExample:\n\n```text\nrlm({\n  task: \"Analyze the reliability risks in this repo\",\n  mode: \"auto\",\n  maxDepth: 2,\n  maxNodes: 12,\n  maxBranching: 3\n})\n```\n\nAsync example:\n\n```text\nrlm({ task: \"Review this architecture\", async: true })\nrlm({ op: \"status\" })\nrlm({ op: \"wait\", id: \"<run-id>\" })\n```\n\nCommand example:\n\n```text\n/rlm \"Analyze the reliability risks in this repo\" --maxDepth 2\n/rlm \"Summarize this repo\" --async\n/rlm-list\n```\n\n## Seeing What RLM Is Doing\n\nUse `/rlm-list` to browse running and completed runs.\n\n- It opens a native Pi selection list.\n- Selecting a running run shows current status and recent activity.\n- Selecting a completed run shows the final result and artifacts.\n\nBoth sync run output and completed run summaries include a `Recent Activity` section so you can see the planner and child-node progress without opening the artifact files.\n\nArtifacts are written under:\n\n```text\n/tmp/pi-rlm-runs/<runId>/\n```\n\n## Named Workflow Surface\n\n### Slash commands\n\n```text\n/rlm-task list\n/rlm-task show incident-review\n/rlm-task run incident-review --file docs/incidents/checkout.md --audience \"engineering managers\"\n/rlm-task doctor\n```\n\n### Tool calls\n\n```text\nrlm_task({ task: \"incident-review\", inputs: { file: \"docs/incidents/checkout.md\", audience: \"engineering managers\" } })\n```\n\n## Built-in workflows\n\n- `incident-review`\n- `rfc-quality-check`\n\n## Project-local workflows\n\nAdd local workflow definitions under:\n\n```text\n.pi/rlm/tasks/*.ts\n```\n\n## Design approach\n\nThis package is RLM-first:\n\n- public surfaces talk about RLM workflows and recursive runs\n- bundled workflows center `agent(...)` and RLM runtime behavior\n- Ax is the implementation layer, not the package identity\n\nThe bundled workflows follow current Ax guidance:\n\n- use `agent(...)` rather than manual `new AxAgent(...)`\n- default to `contextPolicy: { preset: 'checkpointed', budget: 'balanced' }`\n- use `AxJSRuntime()` deliberately for long-context, stateful analysis\n- keep `mode: 'simple'` unless recursive delegated sub-agents are actually needed\n\n## Development\n\n```bash\nmise install\nbun install\nbun run --filter @carter-mcalister/pi-rlm check\n```\n","readmeFilename":"README.md","_rev":"1-9c8700b9c46a5ebdac1b2253f56d9176"}