my-pi 0.0.6 → 0.0.8

package/README.md

@@ -112,8 +112,9 @@ await runPrintMode(runtime, {
 ## MCP Servers
 
 MCP servers are configured via `mcp.json` files and managed as a pi
-extension. Servers are spawned on startup and their tools registered
-via `pi.registerTool()`.
+extension. Stdio servers are spawned on startup, HTTP servers are
+connected remotely, and their tools are registered via
+`pi.registerTool()`.
 
 ### Global config
 
@@ -148,6 +149,25 @@ via `pi.registerTool()`.
 }
 ```
 
+HTTP MCP servers are supported too:
+
+```json
+{
+	"mcpServers": {
+		"pm-platform": {
+			"type": "http",
+			"url": "https://project.cloudlobsters.com/api/mcp",
+			"headers": {
+				"Authorization": "Bearer ..."
+			}
+		}
+	}
+}
+```
+
+Use `"type": "http"` or `"type": "streamable-http"` for remote MCP
+servers. If `url` is present, my-pi treats the entry as HTTP.
+
 Project servers merge with global servers. If both define the same
 server name, the project config wins.
 
@@ -170,11 +190,22 @@ In interactive mode:
 - `/skills sync <key|name>` — sync an imported skill to its upstream
 - `/skills refresh` — rescan skill directories
 - `/skills defaults <all-enabled|all-disabled>` — set default policy
+- `/preset` — open the prompt preset manager (base presets + layers)
+- `/preset <name>` — activate a base preset or toggle a layer
+- `/preset base <name>` — activate a base preset directly
+- `/preset enable <layer>` / `/preset disable <layer>` — toggle a
+  prompt layer directly
+- `/preset edit <name>` — edit or create a project-local preset in
+  `.pi/presets.json`
+- `/preset delete <name>` — delete a project-local preset
+- `/preset reset <name>` — remove a project-local override and fall
+  back to user/built-in if available
+- `/preset clear` — clear the active base preset and all layers
 
 ### How it works
 
 1. Pi extension loads `mcp.json` configs (global + project)
-2. Spawns each MCP server as a child process (stdio transport)
+2. Connects to each MCP server using stdio or HTTP transport
 3. Performs the MCP `initialize` handshake
 4. Calls `tools/list` to discover available tools
 5. Registers each tool via `pi.registerTool()` as
@@ -224,6 +255,49 @@ them. Detection patterns from
 Use `/redact-stats` to see how many secrets were caught. Disable with
 `--no-filter`.
 
+## Prompt Presets
+
+Prompt presets append runtime instructions to the system prompt
+through a built-in extension. They are split into:
+
+- **base presets** — one active at a time
+- **prompt layers** — additive checkboxes you can combine
+
+Built-in base presets:
+
+- `terse` — short, direct, no fluff
+- `standard` — clear and concise with key context
+- `detailed` — more explanation when nuance matters
+
+Built-in layers:
+
+- `no-purple-prose`
+- `bullets`
+- `clarify-first`
+- `include-risks`
+
+Preset sources are merged in this order:
+
+1. built-in defaults
+2. `~/.pi/agent/presets.json`
+3. `.pi/presets.json`
+
+Project presets override global/default presets with the same name.
+Strings are treated as base presets by default. Object entries may set
+`kind: "base"` or `kind: "layer"`.
+
+CLI layering is supported too:
+
+- `--preset terse,no-purple-prose,bullets`
+- `--system-prompt "You are terse and technical."`
+- `--append-system-prompt "Prefer one short paragraph."`
+
+Interactive `/preset` selections are also restored on later sessions
+for the same project via `~/.pi/agent/prompt-preset-state.json`.
+
+This repo also includes an example `.pi/presets.json` with sample base
+presets and layers.
+
 ## Session Handoff
 
 Use `/handoff <task>` to export conversation context as a markdown
@@ -249,6 +323,7 @@ src/
     chain.ts          Agent chain pipelines
     filter-output.ts  Secret redaction in tool output
     handoff.ts        Session context export
+    prompt-presets.ts Runtime prompt preset selection and editing
     recall.ts         Past session recall guidance
   mcp/
     client.ts         Minimal MCP stdio client (JSON-RPC 2.0)
@@ -261,6 +336,7 @@ src/
   agents/
     *.md              Agent definitions (frontmatter + system prompt)
     agent-chain.yaml  Chain pipeline definitions
+  presets.json        Optional project prompt presets
 mcp.json              Project MCP server config
 ```