feat: stacks, auth store, and strict-provider ReAct (v0.9.0)

Ship model stacks/CLI + Studio apply, auth.json, models catalog, and
prime-agent ports. Bump GoLangGraph to v0.2.2 so DeepSeek multi-turn
tool calls stay valid; DeepSeek default URL is https://api.deepseek.com.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: piotrlaczkowski

.gitignore

@@ -13,3 +13,4 @@ web/tsconfig.tsbuildinfo
 .env.local
 # Reference checkout used during development; not part of the slmcode release.
 little-coder/
+prime-agent/

Makefile

@@ -1,6 +1,6 @@
 MODULE := github.com/UnicoLab/slmcode
 BIN    := slmcode
-VERSION ?= 0.8.3
+VERSION ?= 0.9.0
 PREFIX ?= $(HOME)/.local
 GIT_COMMIT := $(shell git rev-parse --short HEAD 2>/dev/null || echo unknown)
 BUILD_TIME := $(shell date -u +%Y-%m-%dT%H:%M:%SZ)
@@ -54,16 +54,20 @@ help: ## Show this help
 
 # ── Stack: list available stacks ──
 stack-list:
-	@echo "Available SLMCode stacks:"
-	@echo ""
-	@for f in $(STACKS_DIR)/*.yaml; do \
-		name=$$(basename "$$f" .yaml); \
-		prov=$$(grep -E '^provider:' "$$f" | head -1 | sed 's/provider: *//'); \
-		model=$$(grep -E '^model:' "$$f" | head -1 | sed 's/model: *//'); \
-		printf "  %-20s → %-12s %s\n" "$$name" "$$prov" "$$model"; \
-	done
-	@echo ""
-	@echo "Usage: make stack-apply stack=<name>"
+	@if command -v slmcode >/dev/null 2>&1 || [ -x ./bin/slmcode ]; then \
+		(./bin/slmcode stack list 2>/dev/null || slmcode stack list); \
+	else \
+		echo "Available SLMCode stacks:"; \
+		echo ""; \
+		for f in $(STACKS_DIR)/*.yaml; do \
+			name=$$(basename "$$f" .yaml); \
+			prov=$$(grep -E '^provider:' "$$f" | head -1 | sed 's/provider: *//'); \
+			model=$$(grep -E '^model:' "$$f" | head -1 | sed 's/model: *//'); \
+			printf "  %-20s → %-12s %s\n" "$$name" "$$prov" "$$model"; \
+		done; \
+		echo ""; \
+		echo "Usage: slmcode stack apply <name>   (or: make stack-apply stack=<name>)"; \
+	fi
 
 # ── Stack: show a stack config ──
 stack-show:
@@ -75,39 +79,25 @@ stack-show:
 	@echo "═══ Stack: $(stack) ═══"
 	@cat "$(STACKS_DIR)/$(stack).yaml"
 
-# ── Stack: apply a stack config ──
+# ── Stack: apply via slmcode (merge — keeps listen/skills/mcp/api_key) ──
+# Optional: agents=1 clear=1 force=1
 stack-apply:
-	@if [ ! -f "$(STACKS_DIR)/$(stack).yaml" ]; then \
-		echo "Stack '$(stack)' not found. Available:"; \
-		ls $(STACKS_DIR)/*.yaml 2>/dev/null | xargs -n1 basename | sed 's/.yaml//'; \
+	@if [ -z "$(stack)" ]; then echo "Usage: make stack-apply stack=<name> [agents=1] [clear=1]"; exit 1; fi
+	@FLAGS=""; \
+	if [ "$(agents)" = "1" ]; then FLAGS="$$FLAGS --agents"; fi; \
+	if [ "$(clear)" = "1" ]; then FLAGS="$$FLAGS --clear-agent-llm"; fi; \
+	if [ "$(force)" = "1" ]; then FLAGS="$$FLAGS --force-agents"; fi; \
+	if [ -x ./bin/slmcode ]; then \
+		./bin/slmcode stack apply $(stack) $$FLAGS; \
+	elif command -v slmcode >/dev/null 2>&1; then \
+		slmcode stack apply $(stack) $$FLAGS; \
+	else \
+		echo "slmcode binary not found — run: make build && ./bin/slmcode stack apply $(stack)"; \
 		exit 1; \
 	fi
-	@CONFIG_PATH="$${SLMCODE_CONFIG:-$$(pwd)/.slmcode/config.yaml}"; \
-	if [ -f "$$CONFIG_PATH" ]; then \
-		echo "⚠  Config already exists at $$CONFIG_PATH"; \
-		echo "   Run 'make stack-apply-force stack=$(stack)' to overwrite"; \
-		echo "   Or 'make stack-new name=my-backup' to save current config first"; \
-		exit 1; \
-	fi
-	@mkdir -p .slmcode
-	@cp "$(STACKS_DIR)/$(stack).yaml" .slmcode/config.yaml
-	@echo "✔ Stack '$(stack)' applied → .slmcode/config.yaml"
-	@echo "  Provider: $$(grep '^provider:' .slmcode/config.yaml | sed 's/provider: *//')"
-	@echo "  Model:    $$(grep '^model:' .slmcode/config.yaml | sed 's/model: *//')"
-	@echo ""
-	@echo "  Run your task: slmcode run -v \"your task\""
 
-# ── Stack: force-apply a stack config ──
-stack-apply-force:
-	@if [ ! -f "$(STACKS_DIR)/$(stack).yaml" ]; then \
-		echo "Stack '$(stack)' not found. Available:"; \
-		ls $(STACKS_DIR)/*.yaml 2>/dev/null | xargs -n1 basename | sed 's/.yaml//'; \
-		exit 1; \
-	fi
-	@mkdir -p .slmcode
-	@cp "$(STACKS_DIR)/$(stack).yaml" .slmcode/config.yaml
-	@echo "✔ Stack '$(stack)' force-applied → .slmcode/config.yaml"
-	@grep -E '^(provider|model|backend):' .slmcode/config.yaml | sed 's/^/  /'
+# ── Stack: apply (same as stack-apply; kept for backwards compat) ──
+stack-apply-force: stack-apply
 
 # ── Stack: edit a stack ──
 stack-edit:
@@ -171,6 +161,7 @@ test: ## Run unit tests
 e2e: ## Run e2e tests (set RUN_E2E=1 for live oMLX tests)
 	go test ./test/e2e/ -count=1 -timeout 30m
 	@if command -v node >/dev/null 2>&1; then node cmd/slmcode/ui/markdown_node_test.js; fi
+	@./scripts/e2e_prime_smoke.sh
 	@if [ "$$RUN_E2E" = "1" ]; then \
 		go test ./test/e2e/ -count=1 -timeout 45m -run 'TestLiveOMLX|TestIsolatedMultiAgent'; \
 	fi

README.md

@@ -127,6 +127,9 @@ Deep dive: **[docs/PROVIDERS.md](docs/PROVIDERS.md)**
 - ⚡ Token-stream early-exit + SLM JSON repair
 - 🖥️ Premium TUI + offline Studio GUI (`http://127.0.0.1:7420`)
 - 🔐 Shell permission modes: `allow` | `ask` | `deny`
+- 📦 **Stacks** — `slmcode stack apply omlx-local|deepseek|…` (global + optional per-agent pins)
+- 🔑 **Auth store** — `.slmcode/auth.json` + Studio/TUI `/auth` (keep keys out of config)
+- 🔎 **Model catalog** — `find_models` + Studio costs / enabled models
 
 ---
 
@@ -156,6 +159,8 @@ slmcode studio               # http://127.0.0.1:7420
 Useful knobs:
 
 ```bash
+slmcode stack list
+slmcode stack apply omlx-local          # or: deepseek, openai, ollama-local, …
 slmcode run --think-passes 2 --parallel 3 --retries 2 "…"
 slmcode run --agent explorer "Where is auth handled?"
 slmcode run --skill atomic-coding "Refactor helpers"
@@ -169,14 +174,15 @@ slmcode config set dry_run false
 | Command | Purpose |
 |---------|---------|
 | `init` / `doctor` / `config` | Workspace + provider health |
+| `stack` / `agent` | Apply model stacks; inspect agent pins |
 | `run -v` | Full pipeline + live stream |
 | `tui` / bare `slmcode` | Premium interactive TUI |
 | `chat` | Classic REPL |
 | `board` / `watch` | Colored kanban |
 | `studio` | GUI + SSE API |
 | `update` | Refresh install (binary or source) |
 
-TUI: `/compact`, `/sessions`, `/stats`, `/permission`, `/agents`, `/stop`, `/resume`.
+TUI: `/compact`, `/models`, `/mcp`, `/auth`, `/schema`, `/sessions`, `/stats`, `/permission`, `/agents`, `/stop`, `/resume`.
 
 ---
 

cmd/slmcode/cmd_agent.go

@@ -0,0 +1,176 @@
+package main
+
+import (
+	"fmt"
+	"path/filepath"
+	"strings"
+
+	"github.com/spf13/cobra"
+
+	"github.com/UnicoLab/slmcode/pkg/agents"
+	"github.com/UnicoLab/slmcode/pkg/cli"
+	"github.com/UnicoLab/slmcode/pkg/config"
+)
+
+func agentCmd() *cobra.Command {
+	cmd := &cobra.Command{
+		Use:   "agent",
+		Short: "List / show / edit specialist agents (effective LLM after stack inheritance)",
+		Long: cli.Dim(`Per-agent provider/model/endpoint overrides live in .slmcode/agents/.
+Empty fields inherit the active stack / global config.
+
+Bulk role pins:  slmcode stack apply <name> --agents
+Clear pins:      slmcode stack apply <name> --clear-agent-llm`),
+		RunE: func(cmd *cobra.Command, args []string) error {
+			return agentList(cmd, args)
+		},
+	}
+	cmd.AddCommand(
+		&cobra.Command{Use: "list", Aliases: []string{"ls"}, Short: "List agents with effective LLM", RunE: agentList},
+		&cobra.Command{
+			Use:   "show [id]",
+			Short: "Show one agent (includes effective_model)",
+			Args:  cobra.ExactArgs(1),
+			RunE: func(cmd *cobra.Command, args []string) error {
+				ws, err := openWorkspace()
+				if err != nil {
+					return err
+				}
+				custom, _ := cli.LoadProjectCustoms(ws.Config.AgentsDir())
+				a := agents.AgentDetail(args[0], custom)
+				if a == nil {
+					return fmt.Errorf("agent %q not found", args[0])
+				}
+				enriched := agents.EnrichPublicSpecs(
+					[]map[string]interface{}{a},
+					config.NormalizeProvider(ws.Config.Provider),
+					ws.Config.Model,
+					ws.Config.ActiveStack,
+				)
+				cli.Header("agent:" + args[0])
+				fmt.Print(cli.FormatAgentShow(enriched[0]))
+				return nil
+			},
+		},
+		&cobra.Command{
+			Use:   "edit [id] [key=value…]",
+			Short: "Patch agent fields (model= provider= endpoint= …)",
+			Args:  cobra.MinimumNArgs(1),
+			RunE: func(cmd *cobra.Command, args []string) error {
+				ws, err := openWorkspace()
+				if err != nil {
+					return err
+				}
+				id := strings.ToLower(strings.TrimSpace(args[0]))
+				fields := map[string]string{}
+				for _, a := range args[1:] {
+					k, v, ok := strings.Cut(a, "=")
+					if !ok {
+						continue
+					}
+					fields[strings.ToLower(strings.TrimSpace(k))] = strings.TrimSpace(v)
+				}
+				if len(fields) == 0 {
+					return fmt.Errorf("usage: slmcode agent edit <id> model=… provider=… endpoint=…")
+				}
+				path := filepath.Join(ws.Config.AgentsDir(), id+".yaml")
+				var base agents.CustomSpec
+				if got, rerr := agents.ReadCustomFile(path); rerr == nil {
+					base = got
+				} else {
+					base.ID = id
+					if agents.BuiltinIDs()[id] {
+						base.Override = true
+						base.Builtin = true
+					}
+				}
+				applyAgentFields(&base, fields)
+				if _, err := agents.WriteCustom(ws.Config.AgentsDir(), base); err != nil {
+					return err
+				}
+				cli.Header("updated " + id)
+				custom, _ := cli.LoadProjectCustoms(ws.Config.AgentsDir())
+				a := agents.AgentDetail(id, custom)
+				enriched := agents.EnrichPublicSpecs(
+					[]map[string]interface{}{a},
+					config.NormalizeProvider(ws.Config.Provider),
+					ws.Config.Model,
+					ws.Config.ActiveStack,
+				)
+				fmt.Print(cli.FormatAgentShow(enriched[0]))
+				fmt.Println(cli.Dim("  Restart studio/tui or rebuild to pick up LLM changes."))
+				return nil
+			},
+		},
+		&cobra.Command{
+			Use:   "clear-llm [id]",
+			Short: "Clear model/provider/endpoint so the agent inherits the stack",
+			Args:  cobra.ExactArgs(1),
+			RunE: func(cmd *cobra.Command, args []string) error {
+				ws, err := openWorkspace()
+				if err != nil {
+					return err
+				}
+				id := strings.ToLower(strings.TrimSpace(args[0]))
+				path := filepath.Join(ws.Config.AgentsDir(), id+".yaml")
+				got, err := agents.ReadCustomFile(path)
+				if err != nil {
+					return fmt.Errorf("no override file for %q — already inheriting", id)
+				}
+				got.Model = ""
+				got.Provider = ""
+				got.Endpoint = ""
+				if _, err := agents.WriteCustom(ws.Config.AgentsDir(), got); err != nil {
+					return err
+				}
+				fmt.Println(cli.Success(id + " now inherits stack/global LLM"))
+				return nil
+			},
+		},
+	)
+	return cmd
+}
+
+func agentList(cmd *cobra.Command, args []string) error {
+	ws, err := openWorkspace()
+	if err != nil {
+		return err
+	}
+	custom, _ := cli.LoadProjectCustoms(ws.Config.AgentsDir())
+	cli.Header("Agents")
+	if ws.Config.ActiveStack != "" {
+		cli.KeyVal("active_stack", ws.Config.ActiveStack)
+	}
+	cli.KeyVal("global", config.NormalizeProvider(ws.Config.Provider)+"/"+ws.Config.Model)
+	fmt.Println()
+	fmt.Print(cli.FormatAgentListWithGlobals(custom, config.NormalizeProvider(ws.Config.Provider), ws.Config.Model))
+	return nil
+}
+
+func applyAgentFields(c *agents.CustomSpec, fields map[string]string) {
+	for k, v := range fields {
+		switch k {
+		case "title":
+			c.Title = v
+		case "description":
+			c.Description = v
+		case "model":
+			c.Model = v
+		case "provider":
+			c.Provider = v
+		case "endpoint":
+			c.Endpoint = v
+		case "system_prompt", "prompt":
+			c.SystemPrompt = v
+		case "skills":
+			var skills []string
+			for _, s := range strings.Split(v, ",") {
+				s = strings.TrimSpace(s)
+				if s != "" {
+					skills = append(skills, s)
+				}
+			}
+			c.Skills = skills
+		}
+	}
+}