@mu-agent/mu 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Spandan Chavan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,81 @@
+# @mu-agent/mu
+
+The terminal and TypeScript SDK distribution of Mu, a general-purpose extensible AI
+agent platform. Coding is the default profile, not a constraint of the underlying kernel.
+
+```sh
+# npm (requires Bun)
+npm install -g @mu-agent/mu
+
+# Bun
+bun install -g @mu-agent/mu
+mu
+```
+
+Update a global npm or Bun installation:
+
+```sh
+mu self update
+```
+
+Install the package locally to embed Mu:
+
+```sh
+npm install @mu-agent/mu
+# or: bun add @mu-agent/mu
+```
+
+```ts
+import { Agent, createAgent } from "@mu-agent/mu";
+
+// A domain-neutral agent with a general prompt and no tools.
+const assistant = new Agent();
+console.log((await assistant.run("Explain how an AI agent loop works")).text);
+
+// Mu's built-in coding profile: file, search, shell, task, and checkpoint tools.
+const codingAgent = await createAgent({
+  profile: "coding",
+  profileOptions: { root: process.cwd() },
+});
+console.log((await codingAgent.run("Summarize this directory")).text);
+await codingAgent.shutdown();
+```
+
+The matching OS/CPU package supplies a pinned ripgrep binary for fast search; installs
+without it fall back to `rg` on `PATH` or mu's built-in search.
+
+Run `/login` to sign in with an account or API key and `/logout` to remove a credential
+saved that way. Environment variables are not changed by `/logout`. `/model` only lists
+providers authenticated through `/login`; `openai-codex/*` rows use the ChatGPT plan and
+`openai/*` rows use a saved API key. Both OpenAI routes default to GPT-5.6 Sol. See the
+project repository for configuration, SDK, and development documentation.
+
+Interactive runs are saved by working-directory scope under `~/.mu/sessions`; use
+`/resume` to choose one or `mu --resume <session-id>` to continue it directly. Mu prints
+the direct resume command when an interactive session closes. Use `/new` to clear the
+terminal and start a fresh chat without deleting the previous saved session. Use
+`/permissions` to choose `default`, `accept-edits`, `plan-readonly`, or full-access
+behavior, including while the agent is running.
+
+Mu loads coding instructions from `~/.mu/AGENTS.md` and from the active project, stopping
+at its Git root. `AGENTS.override.md` takes precedence over `AGENTS.md`; Claude-compatible
+fallback files, `.mu/rules/`, `.claude/rules/`, conditional `paths` frontmatter, and safe
+`@file` imports are supported. Run `/instructions` to see the exact loaded files and
+warnings, `/instructions reload` (or `/reload`) to rescan, or start with
+`--no-instructions` to disable loading for one invocation.
+
+Instruction settings can be placed in user or project `.mu/config.json`; project values
+override user values:
+
+```json
+{
+  "instructions": {
+    "enabled": true,
+    "maxBytes": 32768,
+    "fallbackFilenames": [".mu/AGENTS.md", "CLAUDE.md"],
+    "projectRootMarkers": [".git"],
+    "imports": true,
+    "claudeRules": true
+  }
+}
+```

package/THIRD_PARTY_LICENSES.txt

@@ -0,0 +1,32 @@
+highlight.js 11.11.1
+https://github.com/highlightjs/highlight.js
+
+BSD 3-Clause License
+
+Copyright (c) 2006, Ivan Sagalaev.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the copyright holder nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.