pi-muse-spark extension

# pi-muse-spark

Pi extension for [Meta Model API](https://dev.meta.ai) — adds **Muse Spark 1.2, 1.2-contributor & 1.1** to [pi coding agent](https://github.com/badlogic/pi-mono) via API key.

> **Fork note & credit:** This is a maintained fork of [`seemethere/pi-meta-ai`](https://github.com/seemethere/pi-meta-ai) which provides the original implementation for most of the work. Original credit goes to [seemethere/pi-meta-ai](https://github.com/seemethere/pi-meta-ai) and its contributors. This fork fixes the false `not authenticated` warning on `pi v0.84+` (where `authStorage` was removed) and keeps Muse Spark 1.2 models up to date. Upstream is currently unmaintained.

Meta Model API is OpenAI-compatible with Responses API at `https://api.meta.ai/v1`. This extension registers provider `meta-ai` using `openai-responses` for full agentic support: tool calling, parallel tools, streaming, reasoning effort, structured output, image input, prompt caching, 1M context.

## Prerequisites

- Node.js >=18
- Pi coding agent >=0.84:

```bash
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi --version # should be >=0.84
```

## Install

**As pi package (recommended):**

```bash
pi install git:github.com/EclipseAditya/pi-muse-spark

# pin to a version:
pi install git:github.com/EclipseAditya/pi-muse-spark@v0.2.0
```

**From source (dev):**

```bash
git clone https://github.com/EclipseAditya/pi-muse-spark
cd pi-muse-spark
pi -e ./extensions/meta-model-api
```

**Migrate from `pi-meta-ai`:**

```bash
pi remove git:github.com/seemethere/pi-meta-ai
pi remove git:github.com/RooseveltAdvisors/pi-meta-ai
pi install git:github.com/EclipseAditya/pi-muse-spark
```

## Quick start

1. **Get API key:** https://dev.meta.ai → API keys → Create. Key format `LLM|...`

2. **Authenticate (pick one):**

   **Option A — Inside pi (recommended):**
   ```
   /login → API key → Meta Model API → paste LLM|... key
   ```

   **Option B — Env var (before launching pi):**
   ```bash
   export MODEL_API_KEY="LLM|..."
   # Also supports META_API_KEY as fallback
   
   pi
   # or from source:
   MODEL_API_KEY="LLM|..." pi -e ./extensions/meta-model-api
   ```

   > Env vars must be set **before** launching pi. If you set them after pi is running, run `/reload` or restart pi from the shell where var is exported.

3. **Select model:**
   ```
   /model → meta-ai/muse-spark-1.2-contributor