@nevescloud/pip 3.1.0 → 3.2.0

package/README.md

@@ -26,7 +26,7 @@ Provider-named bundles re-export the three primitives most hosts compose, from a
 
 ```js
 // Anthropic — Claude on /v1/messages
-import { createPip, createRuntime, anthropic } from 'https://cdn.jsdelivr.net/npm/@nevescloud/pip@latest/bundle/anthropic';
+import { createPip, createRuntime, anthropic } from 'https://cdn.jsdelivr.net/npm/@nevescloud/pip@latest/bundle/anthropic.esm.js';
 
 const rt = createRuntime({ provider: anthropic({ model: 'claude-opus-4-7', apiKey: '…' }) });
 const pip = createPip({ onSubmit: rt.onSubmit, onSlash: rt.onSlash, slashSource: rt.slashSource });
@@ -34,15 +34,15 @@ const pip = createPip({ onSubmit: rt.onSubmit, onSlash: rt.onSlash, slashSource:
 
 ```js
 // OpenAI-compatible — OpenAI, GitHub Models, Together, Groq, OpenRouter, LM Studio, llama.cpp
-import { createPip, createRuntime, openai } from 'https://cdn.jsdelivr.net/npm/@nevescloud/pip@latest/bundle/openai';
+import { createPip, createRuntime, openai } from 'https://cdn.jsdelivr.net/npm/@nevescloud/pip@latest/bundle/openai.esm.js';
 ```
 
 ```js
 // Local — in-browser inference via transformers.js + WebGPU (different shape: no runtime, renderer is host-driven)
-import { createPip, createTransformersRenderer } from 'https://cdn.jsdelivr.net/npm/@nevescloud/pip@latest/bundle/local';
+import { createPip, createTransformersRenderer } from 'https://cdn.jsdelivr.net/npm/@nevescloud/pip@latest/bundle/local.esm.js';
 ```
 
-`pip/bundle` (no provider segment) is an alias for `pip/bundle/anthropic` — the default when you haven't picked a brain. Bundles are sugar over the layered files; hosts with a different brain shape (UI only, custom provider, in-browser model) import the granular files directly. See [CONSUMERS.md](../../CONSUMERS.md) for the full entry-point list.
+On jsdelivr the `.esm.js` suffix is required — jsdelivr serves files by raw path, not via `package.json` exports. npm-installed consumers can use the shorter `@nevescloud/pip/bundle/anthropic` (Node ESM resolver honors the exports map). `pip/bundle.esm.js` (or `pip/bundle` via npm) is an alias for `bundle/anthropic` — the default when you haven't picked a brain. Bundles are sugar over the layered files; hosts with a different brain shape (UI only, custom provider, in-browser model) import the granular files directly. See [CONSUMERS.md](../../CONSUMERS.md) for the full entry-point list.
 
 ## Options
 
@@ -86,7 +86,12 @@ pip.registerSlash({
 pip.unregisterSlash("model");
 ```
 
-Handler returns `{ reply?, clearedUI?, passThrough? } | null`. `null` falls through to `onSlash` (if provided) and then to the LLM. Built-ins ship `/help` (auto-lists registered + built-ins) and `/clear` (wipes pip's local history + DOM).
+Handler returns `{ reply?, clearedUI?, openCompletions?, passThrough? } | null`. `null` falls through to `onSlash` (if provided) and then to the LLM. Built-ins ship `/help` (auto-lists registered + built-ins) and `/clear` (wipes pip's local history + DOM).
+
+- `reply` — render as an assistant turn in chat history.
+- `clearedUI` — the handler already painted its own UI (via `startTurn`, `askInChat`, etc.); pip-core skips creating a turn.
+- `openCompletions` — re-open the autocomplete dropdown in arg-mode for this command. Use when the bare command (no arg) is meant to surface a sub-menu like a model picker — keeps the navigation inside the dropdown the user came from instead of logging a listing to history. Pip-core puts `"/<cmd> "` in the input, focuses it, and runs the registered `complete('')` to populate the dropdown.
+- `passThrough` — treat as if the handler didn't match; falls through to `onSlash` then the LLM.
 
 ## Tool-using turns
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nevescloud/pip",
-  "version": "3.1.0",
+  "version": "3.2.0",
   "description": "Floating assistant bubble + panel + chat runtime. ESM, no build.",
   "type": "module",
   "main": "pip-core.esm.js",

package/pip-core.esm.js

@@ -1072,7 +1072,7 @@ export function createPip(opts = {}) {
     // null/0 disables. Manual opens are never auto-closed.
     panelAutoCloseMs = null,
     onSubmit = null,            // optional host handler; receives (text, turnApi) — if present, bypasses `ask`
-    onSlash = null,             // optional (text) -> { reply?, clearedUI? } | null — fallback after registered commands miss
+    onSlash = null,             // optional (text) -> { reply?, clearedUI?, openCompletions?, passThrough? } | null — fallback after registered commands miss
     slashSource = null,         // optional () -> [{ name, description?, complete? }] — overrides built-in source from registerSlash()
     placeholder = "Ask Pip…",
     maxLength = 4000,
@@ -1960,6 +1960,21 @@ export function createPip(opts = {}) {
       if (!r && onSlash) r = onSlash(text);
       if (r && !r.passThrough) {
         if (r.clearedUI) { scrollToBottom(); return; }
+        if (r.openCompletions) {
+          // Sub-menu navigation: re-open arg-mode autocomplete for this
+          // command without committing a turn. Lets hosts surface
+          // sub-options (model list, scope picker, etc.) inside the same
+          // dropdown the user used to reach the command, instead of
+          // logging the listing to chat history.
+          const slashName = text.match(/^\/(\S+)/)?.[1];
+          if (slashName) {
+            input.value = `/${slashName} `;
+            input.setSelectionRange(input.value.length, input.value.length);
+            input.focus();
+            updateSlashSuggest();
+          }
+          return;
+        }
         const t = startTurn({ echo: text });
         if (r.reply) setReplyText(t, r.reply, true);
         return;