sparkecoder 0.1.98 → 0.1.100

package/README.md

@@ -5,75 +5,72 @@ A powerful coding agent CLI with HTTP API. Built with the [Vercel AI SDK](https:
 ## Features
 
 - 🤖 **Multi-Agent Sessions** - Run multiple agents simultaneously with isolated contexts
+- 🧭 **Personal Orchestrator** - Built-in supervisor agent that spawns workers, posts to Slack, fires on cron schedules, accepts webhooks, and edits its own config. See **[docs/ORCHESTRATOR.md](docs/ORCHESTRATOR.md)**.
+- 🔌 **MCP support** - Add Model Context Protocol servers via the Settings UI or by editing the config file. Hot-reloads on next agent turn.
+- 💬 **Slack integration** - Signed events, per-user/per-channel allowlist, canned denied-reply, in-thread responses. Setup wizard with copy-paste manifest in the Settings UI.
+- 🪝 **Inbound webhooks** - Token-protected URLs (`/api/inbox/<token>`) so external services can ping the orchestrator. Templated formatting.
+- ⏰ **Cron schedules** - Recurring prompts that wake the orchestrator with catch-up window.
+- 🧠 **Long-term memory** - Every turn mirrored to local JSONL files; orchestrator can `grep` across sessions via the `search-conversations` skill.
 - 🔄 **Streaming Responses** - Real-time SSE streaming following Vercel AI SDK data stream protocol
 - 🔧 **Powerful Tools** - Bash execution, file operations, planning, and skill loading
 - ✅ **Tool Approvals** - Configurable approval requirements for dangerous operations
 - 📚 **Skills System** - Load specialized knowledge documents into context
-- 💾 **SQLite Persistence** - Full session and message history storage
-- 🌐 **HTTP API** - RESTful API with auto-generated OpenAPI specification via hono-openapi
+- 💾 **Persistence** - Full session and message history storage (remote MongoDB by default)
+- 🌐 **HTTP API** - RESTful API with auto-generated OpenAPI specification
 - 🎯 **Context Management** - Automatic summarization for long conversations
 
 ## Installation
 
-### From GitHub Packages
-
 ```bash
-# Configure npm to use GitHub Packages for @gostudyfetchgo scope
-npm config set @gostudyfetchgo:registry https://npm.pkg.github.com
-
-# Install the package (no auth required - it's public!)
-npm install @gostudyfetchgo/sparkecoder
-
-# Or with pnpm
-pnpm add @gostudyfetchgo/sparkecoder
+# Global install (recommended)
+npm install -g sparkecoder
+# or
+pnpm add -g sparkecoder
 ```
 
 ### From Source
 
 ```bash
-# Clone the repository
 git clone https://github.com/gostudyfetchgo/sparkecoder.git
 cd sparkecoder
-
-# Install dependencies
 pnpm install
-
-# Set up environment variables
-export AI_GATEWAY_API_KEY=your_api_key_here
-
-# Start the server
 pnpm dev
 ```
 
-### Global CLI Installation
+## Quick Start (Personal Orchestrator)
 
 ```bash
-npm install -g @gostudyfetchgo/sparkecoder
-sparkecoder start
+sparkecoder server
 ```
 
-## Quick Start
+That's it — **no API key to configure**. On first boot sparkecoder auto-registers with the remote inference server. The first boot also:
 
-### Initialize Configuration
+- Starts the API at `http://127.0.0.1:3141` and the web UI at `http://localhost:6969`
+- Auto-creates the orchestrator session (always visible in the left sidebar)
+- Starts the per-orchestrator inbox, the daemon that drains it, the cron scheduler, and the MCP client pool
 
-```bash
-sparkecoder init
-```
+Open `http://localhost:6969` and you'll see:
+- **Orchestrator** in the sidebar — your long-lived supervisor chat
+- **Agents** — kanban of worker agents the orchestrator spawns
+- **Settings** — 6 tabs (General · Integrations · MCP · Schedules · Webhooks · Models · API Keys)
+
+**For end-to-end setup (Slack, cloudflared, MCP, schedules, webhooks, personality, long-term memory):** see **[docs/ORCHESTRATOR.md](docs/ORCHESTRATOR.md)**.
 
-This creates a `sparkecoder.config.json` file with default settings.
+### One-off task mode (no orchestrator)
 
-### Start the Server
+If you just want a one-shot autonomous task:
 
 ```bash
-sparkecoder start
+sparkecoder task --prompt "Refactor src/foo.ts to use async/await" \
+  --schema '{"type":"object","properties":{"summary":{"type":"string"}},"required":["summary"]}' \
+  --wait
 ```
 
-The server runs at `http://localhost:3141` by default.
+See [docs/TASK-MODE.md](docs/TASK-MODE.md).
 
-### Make Your First Request
+### Direct API call
 
 ```bash
-# Create a session and run a prompt
 curl -X POST http://localhost:3141/agents/quick \
   -H "Content-Type: application/json" \
   -d '{"prompt": "List the files in the current directory"}'
@@ -239,13 +236,16 @@ Built-in skills:
 ## CLI Commands
 
 ```bash
-sparkecoder start     # Start the HTTP server
-sparkecoder chat      # Interactive chat with the agent
-sparkecoder init      # Create config file
-sparkecoder sessions  # List all sessions
-sparkecoder status    # Check if server is running
-sparkecoder config    # Show current configuration
-sparkecoder info      # Show version and environment
+sparkecoder server              # Start the API + Web UI + orchestrator daemon + scheduler
+sparkecoder chat                # Interactive REPL chat with an agent
+sparkecoder task --prompt ... --schema ...   # Run a one-off autonomous task
+sparkecoder init                # Create a sparkecoder.config.json in cwd
+sparkecoder slack-setup         # Interactively configure Slack creds
+sparkecoder cloudflared-setup --hostname X --team Y   # Print public-tunnel + CF Access recipe
+sparkecoder sessions            # List all sessions on the running server
+sparkecoder status              # Check if the server is running
+sparkecoder config              # Show resolved configuration
+sparkecoder info                # Show version and environment
 ```
 
 ### Interactive Chat

package/dist/agent/index.d.ts

@@ -1,6 +1,6 @@
 import 'ai';
-import '../schema-CohdIL13.js';
-export { A as Agent, a as AgentOptions, b as AgentRunOptions, c as AgentStreamResult, C as ContextManager, M as MessageAttachment, d as buildSystemPrompt, e as buildTaskPromptAddendum } from '../index-BvIissiB.js';
-import '../search-CCffrVJE.js';
+import '../schema-ecQSnCMz.js';
+export { A as Agent, a as AgentOptions, b as AgentRunOptions, c as AgentStreamResult, C as ContextManager, M as MessageAttachment, d as buildSystemPrompt, e as buildTaskPromptAddendum } from '../index-D5l-DMGC.js';
+import '../search-DOzC4ojH.js';
 import 'drizzle-orm/sqlite-core';
 import 'zod';