stagent 0.10.0 → 0.11.1

package/README.md

@@ -4,7 +4,7 @@
 
 [![AI Business Operating System](https://img.shields.io/badge/AI_Business-Operating_System-6366F1)](https://stagent.io) [![npm](https://img.shields.io/npm/v/stagent)](https://www.npmjs.com/package/stagent) [![Next.js 16](https://img.shields.io/badge/Next.js-16-black)](https://nextjs.org/) [![React 19](https://img.shields.io/badge/React-19-61DAFB)](https://react.dev/) [![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178C6)](https://www.typescriptlang.org/) [![Claude Agent SDK](https://img.shields.io/badge/Claude-Agent_SDK-D97706)](https://docs.anthropic.com/) [![OpenAI Codex App Server](https://img.shields.io/badge/OpenAI-Codex_App_Server-10A37F)](https://developers.openai.com/codex/app-server) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
 
-**[stagent.io](https://stagent.io)** · **[GitHub](https://github.com/navam-io/stagent)**
+**[stagent.io](https://stagent.io)** · **[GitHub](https://github.com/manavsehgal/stagent)**
 
 ## Quick Start
 
@@ -16,13 +16,13 @@ Open [localhost:3000](http://localhost:3000). That's it — zero config, local S
 
 **Profiles & Policies** · **Blueprints & Schedules** · **Built-in Playbook** · **Open Source**
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/home-list.png" alt="Stagent home workspace" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/home-list.png" alt="Stagent home workspace" width="1200" />
 
 | Home Workspace | Reusable Profiles | Workflow Blueprints | Governed Execution |
 |:-:|:-:|:-:|:-:|
 | Workspace briefing with active work, pending review, project signals, and live activity | Specialist definitions with prompts, tool policy, and runtime tuning you can reuse | Pre-configured templates with dynamic forms, YAML editing, and lineage tracking | Human-in-the-loop approvals, tool permissions, and ambient supervision |
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/home-below-fold.png" alt="Stagent home workspace below fold — projects, activity feed, and signals" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/home-below-fold.png" alt="Stagent home workspace below fold — projects, activity feed, and signals" width="1200" />
 
 ---
 
@@ -73,6 +73,9 @@ Run the same business process on different AI providers without changing a line
 | 📦 | **[Workflow Context Batching](#workflow-context-batching)** | Workflow-scoped proposal buffering with batch approve/reject for learned context |
 | 🧪 | **[E2E Test Automation](#e2e-test-automation)** | API-level end-to-end test suite covering both runtimes, 4 profiles, and 4 workflow patterns |
 | ⌨️ | **[Command Palette](#command-palette)** | Global `⌘K` search for fast navigation across tasks, projects, workflows, and settings |
+| 🧱 | **[Skill Composition](#skill-composition)** | Activate up to 3 skills at once with conflict detection and runtime-aware capability gates |
+| 🔎 | **[Filters & Saved Searches](#filters--saved-searches)** | `#key:value` filter grammar, pinned and saved searches surfaced in `⌘K` palette |
+| 🛡️ | **[Upgrade Detection](#upgrade-detection)** | Hourly upstream check with in-app notifications and guided merge sessions |
 | 📖 | **[Playbook](#playbook)** | Built-in documentation with usage-stage awareness, adoption heatmap, and guided learning journeys |
 | 📚 | **[Living Book](#living-book)** | AI-native book reader with 9 chapters, agent-powered regeneration, staleness detection, and reading paths |
 | 🌐 | **[Environment](#environment)** | Control plane for Claude Code and Codex CLI environments with scanning, caching, sync, and templates |
@@ -83,9 +86,9 @@ Run the same business process on different AI providers without changing a line
 ## Architecture
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/architecture-dark.svg">
-  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/architecture-light.svg">
-  <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/architecture-light.svg" alt="Stagent architecture diagram" width="900" />
+  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/architecture-dark.svg">
+  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/architecture-light.svg">
+  <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/architecture-light.svg" alt="Stagent architecture diagram" width="900" />
 </picture>
 
 **Key design decisions:**
@@ -112,18 +115,18 @@ Workspace-level briefing with active work, pending review, failed items, project
 #### Task Execution
 Status-driven execution board with five columns: Planned → Queued → Running → Completed → Failed. Filter across projects, create tasks inline, and open task detail to inspect status, description, and runtime state without leaving the board.
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/dashboard-list.png" alt="Stagent kanban board" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/dashboard-list.png" alt="Stagent kanban board" width="1200" />
 
 | Table View |
 |:-:|
-| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/dashboard-table.png" alt="Dashboard table view" width="580" /> |
+| <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/dashboard-table.png" alt="Dashboard table view" width="580" /> |
 
 #### Projects
 Create and organize projects as containers for related tasks. Each project can specify a working directory — agent tasks resolve `cwd` from the project's path, enabling agents to operate on external codebases. Server-rendered project cards with task counts, status badges, and a detail view at `/projects/[id]`.
 
 | Project Cards | Project Detail |
 |:-:|:-:|
-| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/projects-list.png" alt="Project cards overview" width="580" /> | <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/projects-detail.png" alt="Project detail view" width="580" /> |
+| <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/projects-list.png" alt="Project cards overview" width="580" /> | <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/projects-detail.png" alt="Project detail view" width="580" /> |
 
 ### Agent
 
@@ -143,7 +146,7 @@ OpenAI Codex App Server is integrated as Stagent's second governed runtime. Code
 #### Agent Profiles
 Profile-backed execution with specialist definitions for different job types. Each profile packages instructions, allowed tools, max turns, and output format so teams can reuse behavior intentionally instead of relying on ad hoc prompts. Profile cards display role-based icon circles with keyword-inferred colors (blue for work, purple for personal), alongside domain tags, runtime badges, and tool counts. Workflow steps and schedules can reference profiles directly, and runtimes can be selected independently when provider support differs.
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/profiles-list.png" alt="Stagent agent profiles with role-based icon circles" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/profiles-list.png" alt="Stagent agent profiles with role-based icon circles" width="1200" />
 
 #### Workflows
 Multi-step task orchestration with six patterns:
@@ -187,11 +190,11 @@ Curated agent profiles across work and personal domains, built as portable Claud
 #### Workflow Blueprints
 Pre-configured workflow templates across work and personal domains. Browse blueprints in a gallery with pattern-colored icon circles, domain tags, and difficulty badges. Preview steps and required variables, fill in a dynamic form, and create draft workflows with resolved prompts and profile assignments. Create custom blueprints via YAML or import from GitHub URLs. Lineage tracking connects workflows back to their source blueprint.
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/workflows-list.png" alt="Stagent workflows with keyword-inferred icon circles" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/workflows-list.png" alt="Stagent workflows with keyword-inferred icon circles" width="1200" />
 
 | Workflow Detail |
 |:-:|
-| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/workflows-detail.png" alt="Workflow detail with steps and status" width="580" /> |
+| <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/workflows-detail.png" alt="Workflow detail with steps and status" width="580" /> |
 
 ### Documents
 
@@ -200,7 +203,7 @@ Full document browser at `/documents` with table and grid views. Upload files wi
 
 | Table View | Grid View |
 |:-:|:-:|
-| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/documents-list.png" alt="Documents table view" width="580" /> | <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/documents-grid.png" alt="Documents grid view" width="580" /> |
+| <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/documents-list.png" alt="Documents table view" width="580" /> | <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/documents-grid.png" alt="Documents grid view" width="580" /> |
 
 #### Document Preprocessing
 Automatic text extraction on upload for five file types: text, PDF (pdf-parse), images (image-size), Office documents (mammoth/jszip), and spreadsheets (xlsx). Extracted text, processed paths, and processing errors are tracked per document.
@@ -213,11 +216,11 @@ Airtable-like structured data system at `/tables` with 14 features. Create table
 
 | Table List | Spreadsheet Editor |
 |:-:|:-:|
-| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/tables-list.png" alt="Tables list view" width="580" /> | <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/tables-detail.png" alt="Table spreadsheet editor" width="580" /> |
+| <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/tables-list.png" alt="Tables list view" width="580" /> | <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/tables-detail.png" alt="Table spreadsheet editor" width="580" /> |
 
 | Charts | Template Gallery |
 |:-:|:-:|
-| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/tables-detail-charts.png" alt="Table charts tab" width="580" /> | <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/tables-templates.png" alt="Table template gallery" width="580" /> |
+| <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/tables-detail-charts.png" alt="Table charts tab" width="580" /> | <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/tables-templates.png" alt="Table template gallery" width="580" /> |
 
 - **Charts** — Bar, line, pie, and scatter charts with configurable X/Y axes and aggregation
 - **Workflow triggers** — Automated actions fired when row data matches conditions
@@ -231,7 +234,7 @@ Airtable-like structured data system at `/tables` with 14 features. Create table
 #### Playbook
 Built-in documentation system at `/playbook` with usage-stage awareness that adapts content to your experience level (new, early, active, power user). Browse feature reference docs and guided learning journeys organized by persona (Personal, Work, Power User, Developer). Adoption heatmap tracks which features you've explored, while journey cards show progress through multi-step learning paths. Markdown rendering with automatic internal link resolution, table of contents, related docs, and screengrab embedding.
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/playbook-list.png" alt="Stagent playbook documentation" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/playbook-list.png" alt="Stagent playbook documentation" width="1200" />
 
 #### Living Book
 AI-native book reader at `/book` with 9 chapters across 3 parts (Foundation, Intelligence, Autonomy). Each chapter is generated from Stagent's own source code and feature docs by the document-writer agent — making this a book that writes itself.
@@ -260,7 +263,7 @@ Stagent doubles as a **control plane for AI coding environments** — scanning,
 - **Environment Health Scoring** — composite health score based on configuration completeness and freshness
 - **Agent Profile from Environment** — auto-generate agent profiles from detected environment capabilities
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/environment-list.png" alt="Stagent environment dashboard" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/environment-list.png" alt="Stagent environment dashboard" width="1200" />
 
 #### Browser Tools
 Enable browser automation in chat and task execution through two MCP integrations: **Chrome DevTools MCP** (29 tools for connecting to a running Chrome instance via CDP) and **Playwright MCP** (50+ tools for headless browser automation). Configure both from Settings with independent toggles and permission tiering — read-only operations auto-approve while mutations are gated through the inbox approval flow.
@@ -276,10 +279,13 @@ Pending permission requests now surface through a shell-level approval presenter
 #### Tool Permission Presets
 Pre-configured permission bundles that reduce friction for common tool approval patterns. Three layered presets — read-only (file reads, glob, grep), git-safe (adds git operations), and full-auto (adds write, edit, bash) — compose with existing "Always Allow" patterns. Presets are layered: enabling git-safe automatically includes read-only patterns; removing git-safe only strips its unique additions. Risk badges indicate the trust level of each preset. Manage presets from the Settings page alongside individual tool permissions.
 
+#### Upgrade Detection
+Hourly poller checks the upstream `origin/main` for new commits and surfaces them via an in-app `UpgradeBadge` + notification queue. If three consecutive checks fail, a single deduplicated "Upgrade check failing" notification is inserted (and cleared on the next successful tick). The `upgrade-assistant` profile drives guided merge sessions end-to-end — including free-form questions and 3-choice option cards when a merge conflict or drifted `main` requires operator input. Dev repos are fully gated via `STAGENT_DEV_MODE` and a `.git/stagent-dev-mode` sentinel so contributor pushes are never blocked.
+
 #### Schedules
 Time-based scheduling for agent tasks with human-friendly intervals (`5m`, `2h`, `1d`) and raw 5-field cron expressions. One-shot and recurring modes with pause/resume lifecycle, expiry limits, and max firings. Each firing creates a child task through the shared execution pipeline, and schedules can now target a runtime explicitly. Scheduler runs as a poll-based engine started via Next.js instrumentation hook.
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/schedules-list.png" alt="Stagent schedules" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/schedules-list.png" alt="Stagent schedules" width="1200" />
 
 #### Micro-Visualizations
 Pure SVG chart primitives (Sparkline, MiniBar, DonutRing) with zero charting dependencies. Integrated into: homepage stats cards (7-day trends), activity feed (24h bar chart), project cards (completion donuts), monitor overview (success rate), and project detail (stacked status + 14-day sparkline). Full accessibility with `role="img"` and `aria-label`.
@@ -287,32 +293,38 @@ Pure SVG chart primitives (Sparkline, MiniBar, DonutRing) with zero charting dep
 #### Cost & Usage
 Provider-normalized metering tracks token and spend activity across tasks, resumes, workflow child tasks, schedules, task assist, and profile tests. The dedicated `Cost & Usage` surface adds summary cards, trend views, provider/model breakdowns, and budget-aware audit visibility on top of the usage ledger.
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/cost-usage-list.png" alt="Stagent cost and usage dashboard" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/cost-usage-list.png" alt="Stagent cost and usage dashboard" width="1200" />
 
 ### UI & DevEx
 
 #### Inbox & Human-in-the-Loop
 When an agent needs approval or input, a notification appears in your inbox. Review tool permission requests with "Allow Once" / "Always Allow" / "Deny" buttons, answer agent questions, and see task completion summaries. Supports bulk dismiss and 10s polling.
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/inbox-list.png" alt="Stagent inbox approval flow" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/inbox-list.png" alt="Stagent inbox approval flow" width="1200" />
 
 | Expanded Notification |
 |:-:|
-| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/inbox-expanded.png" alt="Inbox notification expanded" width="580" /> |
+| <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/inbox-expanded.png" alt="Inbox notification expanded" width="580" /> |
 
 #### Chat
 Conversational control plane for all workspace primitives — projects, tasks, workflows, documents, and profiles are all reachable from the chat surface. The chat interface is organized as a **tool catalog** with five categories (Explore, Create, Debug, Automate, Smart Picks) that help discover workspace capabilities. Progressive 5-tier context injection (~53K token budget) builds workspace awareness from lightweight summaries up to full document content. **@ mentions** let you reference documents and entities directly in prompts with fuzzy search autocomplete, injecting their content as context. **Slash commands** (`/`) provide quick access to tools and actions. Multi-provider model selection with cost tiers ($, $$, $$$) spans Claude Haiku through Opus and GPT-5.x models. Browser automation via Chrome DevTools and Playwright MCP enables screenshot capture and web interaction from chat. Quick Access navigation pills in responses provide entity deep-linking. Stagent CRUD tools let you create, update, and delete workspace entities through natural language.
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/chat-conversation.png" alt="Stagent chat conversation with @ document context" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/chat-conversation.png" alt="Stagent chat conversation with @ document context" width="1200" />
 
 | Tool Catalog | Model Selector | Create Tab |
 |:-:|:-:|:-:|
-| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/chat-list.png" alt="Chat tool catalog with category tabs" width="380" /> | <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/chat-model-selector.png" alt="Chat model selector with cost tiers" width="380" /> | <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/chat-create-tab.png" alt="Chat Create category prompts" width="380" /> |
+| <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/chat-list.png" alt="Chat tool catalog with category tabs" width="380" /> | <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/chat-model-selector.png" alt="Chat model selector with cost tiers" width="380" /> | <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/chat-create-tab.png" alt="Chat Create category prompts" width="380" /> |
+
+#### Skill Composition
+Activate up to three skills in a single conversation with conflict detection and runtime-aware capability gates. The Skills tab in the chat popover surfaces `+ Add` buttons on inactive skills, active badges with deactivate actions, and an "N of M active" indicator. When two skills issue polarity-divergent directives on shared keywords, a conflict dialog previews the excerpts and lets you confirm with `force:true` or back out. Composition honors the runtime capability matrix — Claude Code and Codex App Server support up to 3 active skills, while Ollama stays at 1. Conversations persist active skills through an additive `active_skill_ids` column that preserves legacy single-skill reads.
+
+#### Filters & Saved Searches
+Structured `#key:value` filter grammar across chat, documents, and the `⌘K` palette. The shared `FilterInput` parser accepts bare clauses, quoted values (`#tag:"needs review"`), and free text — clauses AND with surface-specific Select filters and sync to URL params for shareable, refresh-persistent views. Save any filter expression with a rename footer; saved searches appear as a dedicated group in the mention popover and in the command palette, so views built in one surface are reachable from anywhere. Pinned saved searches sit at the top of both lists for zero-click recall.
 
 #### Monitoring
 Real-time agent log streaming via Server-Sent Events. Filter by task or event type, click entries to jump to task details, and auto-pause polling when the tab is hidden (Page Visibility API).
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/monitor-list.png" alt="Stagent monitoring dashboard" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/monitor-list.png" alt="Stagent monitoring dashboard" width="1200" />
 
 #### Content Handling
 File upload with drag-and-drop in task creation. Type-aware content preview for text, markdown (via react-markdown), code, and JSON. Copy-to-clipboard and download-as-file for task outputs.
@@ -320,11 +332,11 @@ File upload with drag-and-drop in task creation. Type-aware content preview for
 #### Settings
 Configuration hub with provider-aware sections: Claude authentication (API key or OAuth), OpenAI Codex runtime API-key management, chat defaults (model selection), **browser tools** (Chrome DevTools and Playwright MCP toggles), runtime configuration (SDK timeout and max turns), tool permissions (saved "Always Allow" patterns with revoke), permission presets, budget guardrails, **database snapshots** (automatic backups with configurable retention and one-click restore), and data management.
 
-<img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/settings-list.png" alt="Stagent settings" width="1200" />
+<img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/settings-list.png" alt="Stagent settings" width="1200" />
 
 | Browser Tools | Permission Presets | Budget Configuration |
 |:-:|:-:|:-:|
-| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/settings-browser-tools.png" alt="Browser tools MCP toggles" width="380" /> | <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/settings-presets.png" alt="Tool permission presets" width="380" /> | <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/settings-budget.png" alt="Budget configuration" width="380" /> |
+| <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/settings-browser-tools.png" alt="Browser tools MCP toggles" width="380" /> | <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/settings-presets.png" alt="Tool permission presets" width="380" /> | <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/settings-budget.png" alt="Budget configuration" width="380" /> |
 
 #### CLI
 The `npx stagent` entry point boots a Next.js server from the published npm package. It is built from `bin/cli.ts` into `dist/cli.js` using tsup, and serves as the primary distribution channel — no clone required.
@@ -337,7 +349,7 @@ Global `⌘K` command palette for fast navigation and search across tasks, proje
 
 | Empty Palette | Search Results |
 |:-:|:-:|
-| <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/command-palette-empty.png" alt="Command palette empty state" width="580" /> | <img src="https://raw.githubusercontent.com/navam-io/stagent/main/public/readme/command-palette-search.png" alt="Command palette search results" width="580" /> |
+| <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/command-palette-empty.png" alt="Command palette empty state" width="580" /> | <img src="https://raw.githubusercontent.com/manavsehgal/stagent/main/public/readme/command-palette-search.png" alt="Command palette search results" width="580" /> |
 
 #### App Shell
 Responsive sidebar with collapsible icon-only mode, custom Stagent logo, tooltip navigation, dark/light/system theme, and OKLCH hue 250 blue-indigo color palette. Built on shadcn/ui (New York style) with PWA manifest and app icons. Routes: Home, Dashboard, Inbox, Chat, Projects, Workflows, Documents, Monitor, Profiles, Schedules, Cost & Usage, AI Native Book, User Guide, Environment, Settings.
@@ -511,12 +523,13 @@ All 14 features shipped across three layers:
 |----------|---------|
 | **Documents** (5) | File attachments, preprocessing (5 formats), agent context injection, document browser, output generation |
 | **Agent Intelligence** (6) | Multi-agent routing, autonomous loops, multi-agent swarm, AI assist→workflows, agent self-improvement, workflow context batching |
-| **Agent Profiles** (2) | Agent profile catalog (21 profiles), workflow blueprints (8 templates) |
+| **Agent Profiles** (2) | Agent profile catalog (<!-- STAT:builtinProfiles -->21<!-- /STAT --> profiles), workflow blueprints (<!-- STAT:workflowBlueprints -->13<!-- /STAT --> templates) |
 | **UI Enhancement** (13) | Ambient approvals, learned context UX, micro-visualizations, command palette, operational surface, profile surface, accessibility, UI density, kanban operations, board persistence, detail view redesign, playbook documentation, workflow UX overhaul |
 | **Platform** (8) | Scheduled prompt loops, tool permissions, provider runtimes, OpenAI Codex runtime, cross-provider profiles, parallel fork/join, tool permission presets, npm publish (deferred) |
 | **Runtime Quality** (2) | SDK runtime hardening, E2E test automation |
 | **Governance** (3) | Usage metering ledger, spend budget guardrails, cost & usage dashboard |
-| **Chat** (6) | Chat data layer, chat engine (5-tier context, CRUD tools), API routes (SSE streaming), UI shell, message rendering (Quick Access pills), input composer (tool catalog, model selector) |
+| **Chat** (10) | Chat data layer, chat engine (5-tier context, CRUD tools), API routes (SSE streaming), UI shell, message rendering (Quick Access pills), input composer (tool catalog, model selector), skill composition (multi-skill with conflict detection), filter namespace (`#key:value` grammar), pinned + saved searches, conversation templates |
+| **Platform Hardening** (2) | Runtime validation hardening (MCP-tool runtime-id validation with safe fallbacks), upgrade detection (hourly upstream poll + guided merge sessions) |
 | **Environment** (11) | Environment scanner, cache, dashboard, git checkpoint manager, sync engine, project onboarding, templates, cross-project comparison, skill portfolio, health scoring, agent profile from environment |
 | **Living Book** (5) | Content merge (chapters → playbook), author's notes, reading paths, markdown pipeline, self-updating chapters |
 
@@ -539,7 +552,7 @@ All 14 features shipped across three layers:
 ### Contributor Setup
 
 ```bash
-git clone https://github.com/navam-io/stagent.git && cd stagent && npm install
+git clone https://github.com/manavsehgal/stagent.git && cd stagent && npm install
 
 # Set up one or both runtime credentials
 cat > .env.local <<'EOF'
@@ -567,4 +580,4 @@ See `AGENTS.md` for architecture details and development conventions.
 
 Licensed under the [Apache License 2.0](LICENSE).
 
-Copyright 2025-2026 [Navam](https://navam.io)
+Copyright 2025-2026 [Manav Sehgal](https://github.com/manavsehgal)

package/dist/cli.js

@@ -154,6 +154,9 @@ function bootstrapStagentDatabase(sqlite2) {
       status TEXT DEFAULT 'planned' NOT NULL,
       assigned_agent TEXT,
       agent_profile TEXT,
+      effective_runtime_id TEXT,
+      effective_model_id TEXT,
+      runtime_fallback_reason TEXT,
       priority INTEGER DEFAULT 2 NOT NULL,
       result TEXT,
       session_id TEXT,
@@ -385,6 +388,9 @@ function bootstrapStagentDatabase(sqlite2) {
   };
   addColumnIfMissing(`ALTER TABLE tasks ADD COLUMN agent_profile TEXT;`);
   sqlite2.exec(`CREATE INDEX IF NOT EXISTS idx_tasks_agent_profile ON tasks(agent_profile);`);
+  addColumnIfMissing(`ALTER TABLE tasks ADD COLUMN effective_runtime_id TEXT;`);
+  addColumnIfMissing(`ALTER TABLE tasks ADD COLUMN effective_model_id TEXT;`);
+  addColumnIfMissing(`ALTER TABLE tasks ADD COLUMN runtime_fallback_reason TEXT;`);
   addColumnIfMissing(`ALTER TABLE tasks ADD COLUMN workflow_id TEXT REFERENCES workflows(id);`);
   sqlite2.exec(`CREATE INDEX IF NOT EXISTS idx_tasks_workflow_id ON tasks(workflow_id);`);
   addColumnIfMissing(`ALTER TABLE tasks ADD COLUMN schedule_id TEXT REFERENCES schedules(id);`);
@@ -408,6 +414,8 @@ function bootstrapStagentDatabase(sqlite2) {
   addColumnIfMissing(`ALTER TABLE documents ADD COLUMN source TEXT DEFAULT 'upload';`);
   addColumnIfMissing(`ALTER TABLE documents ADD COLUMN conversation_id TEXT REFERENCES conversations(id);`);
   addColumnIfMissing(`ALTER TABLE documents ADD COLUMN message_id TEXT;`);
+  addColumnIfMissing(`ALTER TABLE conversations ADD COLUMN active_skill_id TEXT;`);
+  addColumnIfMissing(`ALTER TABLE conversations ADD COLUMN active_skill_ids TEXT DEFAULT '[]';`);
   addColumnIfMissing(`ALTER TABLE workflows ADD COLUMN resume_at INTEGER;`);
   sqlite2.exec(`CREATE INDEX IF NOT EXISTS idx_documents_source ON documents(source);`);
   sqlite2.exec(`CREATE INDEX IF NOT EXISTS idx_documents_conversation_id ON documents(conversation_id);`);
@@ -520,6 +528,8 @@ function bootstrapStagentDatabase(sqlite2) {
       status TEXT DEFAULT 'active' NOT NULL,
       session_id TEXT,
       context_scope TEXT,
+      active_skill_id TEXT,
+      active_skill_ids TEXT DEFAULT '[]',
       created_at INTEGER NOT NULL,
       updated_at INTEGER NOT NULL,
       FOREIGN KEY (project_id) REFERENCES projects(id) ON UPDATE NO ACTION ON DELETE NO ACTION
@@ -1012,6 +1022,20 @@ function markAllMigrationsApplied(sqlite2, migrationsFolder, migrationsTable = "
 var __dirname = dirname2(fileURLToPath(import.meta.url));
 var appDir = join3(__dirname, "..");
 var launchCwd = process.cwd();
+var _envLocalPath = join3(launchCwd, ".env.local");
+if (existsSync2(_envLocalPath)) {
+  for (const line of readFileSync(_envLocalPath, "utf-8").split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith("#")) continue;
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx === -1) continue;
+    const key = trimmed.slice(0, eqIdx).trim();
+    const val = trimmed.slice(eqIdx + 1).trim().replace(/^(['"])(.*)\1$/, "$2");
+    if (key && !(key in process.env)) {
+      process.env[key] = val;
+    }
+  }
+}
 var pkg = JSON.parse(readFileSync(join3(appDir, "package.json"), "utf-8"));
 function getHelpText() {
   const dir = getStagentDataDir();

package/docs/.coverage-gaps.json

@@ -1,29 +1,159 @@
 {
-  "generated": "2026-04-08T20:00:00Z",
-  "summary": {
-    "totalFeatures": 86,
-    "coveredFeatures": 85,
-    "gapCount": 1,
-    "unusedScreenshotCount": 0,
-    "brokenReferences": 0,
-    "orphanedImages": 0
-  },
+  "generated": "2026-04-16T05:57:41Z",
   "gaps": [
     {
-      "feature": "tables-document-import",
-      "category": "Structured Data",
-      "screenshots": [],
-      "journeyCoverage": ["work-use"],
-      "suggestedPersona": "work",
-      "note": "Import wizard has no dedicated screenshot. The feature is referenced narratively in the Work journey at Step 7, but a dedicated capture is blocked by the Tables list being empty (no seed data). Residual gap — revisit after seeding sample tables."
+      "feature": "ai-assist-workflow-creation",
+      "category": "Agent Intelligence",
+      "screenshots": [
+        "dashboard-create-form-ai-assist.png",
+        "dashboard-create-form-ai-applied.png",
+        "dashboard-create-form-ai-breakdown.png",
+        "dashboard-workflow-confirm.png"
+      ],
+      "journeyCoverage": [],
+      "suggestedPersona": "power-user"
+    },
+    {
+      "feature": "autonomous-loop-execution",
+      "category": "Schedules",
+      "screenshots": [
+        "schedules-detail.png"
+      ],
+      "journeyCoverage": [],
+      "suggestedPersona": "power-user"
+    },
+    {
+      "feature": "chat-composition-ui-v1",
+      "category": "Chat",
+      "screenshots": [
+        "chat-skills-tab.png"
+      ],
+      "journeyCoverage": [],
+      "suggestedPersona": "personal"
+    },
+    {
+      "feature": "chat-dedup-variant-tolerance",
+      "category": "Chat",
+      "screenshots": [
+        "chat-conversation.png"
+      ],
+      "journeyCoverage": [],
+      "suggestedPersona": "personal"
+    },
+    {
+      "feature": "chat-file-mentions",
+      "category": "Chat",
+      "screenshots": [
+        "chat-mentions-popover.png",
+        "chat-entities-tab.png"
+      ],
+      "journeyCoverage": [],
+      "suggestedPersona": "personal"
+    },
+    {
+      "feature": "chat-settings-tool",
+      "category": "Chat",
+      "screenshots": [
+        "chat-tools-tab.png"
+      ],
+      "journeyCoverage": [],
+      "suggestedPersona": "personal"
+    },
+    {
+      "feature": "chat-skill-composition",
+      "category": "Agent Intelligence",
+      "screenshots": [
+        "chat-skills-tab.png",
+        "chat-slash-popover.png"
+      ],
+      "journeyCoverage": [],
+      "suggestedPersona": "power-user"
+    },
+    {
+      "feature": "instance-bootstrap",
+      "category": "Platform/Runtime",
+      "screenshots": [
+        "settings-instance.png"
+      ],
+      "journeyCoverage": [],
+      "suggestedPersona": "developer"
+    },
+    {
+      "feature": "multi-agent-swarm",
+      "category": "Agent Intelligence",
+      "screenshots": [
+        "dashboard-create-form-ai-breakdown.png"
+      ],
+      "journeyCoverage": [],
+      "suggestedPersona": "power-user"
+    },
+    {
+      "feature": "task-definition-ai",
+      "category": "Agent Intelligence",
+      "screenshots": [
+        "dashboard-create-form-ai-assist.png",
+        "dashboard-create-form-empty.png",
+        "dashboard-create-form-filled.png"
+      ],
+      "journeyCoverage": [],
+      "suggestedPersona": "power-user"
+    },
+    {
+      "feature": "upgrade-detection",
+      "category": "Platform/Runtime",
+      "screenshots": [
+        "settings-instance.png"
+      ],
+      "journeyCoverage": [],
+      "suggestedPersona": "developer"
+    }
+  ],
+  "unusedScreenshots": [
+    "analytics-list.png",
+    "chat-actions-tab.png",
+    "chat-conversation.png",
+    "chat-entities-tab.png",
+    "chat-mentions-popover.png",
+    "chat-model-picker.png",
+    "chat-search-filter.png",
+    "chat-skills-tab.png",
+    "chat-slash-popover.png",
+    "chat-tools-tab.png",
+    "dashboard-below-fold.png",
+    "dashboard-create-form-ai-applied.png",
+    "dashboard-create-form-ai-assist.png",
+    "dashboard-create-form-ai-breakdown.png",
+    "dashboard-create-form-empty.png",
+    "dashboard-create-form-filled.png",
+    "dashboard-workflow-confirm.png",
+    "schedules-create-form-empty.png",
+    "schedules-create-form-filled.png",
+    "schedules-detail.png",
+    "settings-browser-tools.png",
+    "settings-channels-add-form.png",
+    "settings-instance.png",
+    "settings-ollama-connected.png",
+    "settings-ollama.png",
+    "tables-detail-details.png",
+    "tables-detail-triggers.png",
+    "tables-detail.png",
+    "trust-tier-popover.png",
+    "workflows-create-form-delay.png"
+  ],
+  "contentMismatches": [
+    {
+      "journey": "work-use.md",
+      "step": "Step 14",
+      "screenshot": "inbox-expanded.png",
+      "severity": "WRONG",
+      "issue": "Shows task detail page, not expanded inbox notification. Needs recapture."
     }
   ],
-  "brokenReferences": [],
-  "orphanedImages": [],
-  "notes": [
-    "Closed 3 of 4 prior gaps: book-content-merge, book-reading-paths, database-snapshot-backup.",
-    "Closed 14 prior broken references — journey docs now reference only fixtures that exist in public/readme/.",
-    "Cleared 20 orphaned images by overwriting public/readme/ with the fresh screengrab set.",
-    "Added 4 new feature entries to reflect schedule-orchestration-v2, workflow-step-delays, bulk-row-enrichment, instance-bootstrap/upgrade-session/license-metering."
-  ]
-}
+  "summary": {
+    "totalFeatures": 50,
+    "coveredFeatures": 39,
+    "gapCount": 11,
+    "unusedScreenshotCount": 30,
+    "contentMismatchCount": 1
+  }
+}

package/docs/.last-generated

@@ -1 +1 @@
-2026-04-08T20:00:00Z
+2026-04-16T06:32:25Z

package/docs/features/agent-intelligence.md

@@ -4,9 +4,9 @@ category: "feature-reference"
 section: "agent-intelligence"
 route: "cross-cutting"
 tags: [ai-assist, routing, autonomous, swarm, self-improvement, context, parallel, episodic-memory, handoffs]
-features: ["task-definition-ai", "multi-agent-routing", "autonomous-loop-execution", "multi-agent-swarm", "agent-self-improvement", "workflow-context-batching", "parallel-research-fork-join", "agent-episodic-memory", "agent-async-handoffs"]
+features: ["task-definition-ai", "multi-agent-routing", "autonomous-loop-execution", "multi-agent-swarm", "agent-self-improvement", "workflow-context-batching", "parallel-research-fork-join", "agent-episodic-memory", "agent-async-handoffs", "chat-skill-composition"]
 screengrabCount: 0
-lastUpdated: "2026-03-31"
+lastUpdated: "2026-04-15"
 ---
 
 # Agent Intelligence
@@ -65,6 +65,16 @@ Agents can hand off work to other agents asynchronously through a message bus:
 
 This enables multi-agent workflows where a researcher discovers a code issue and hands it off to the code reviewer without requiring a pre-built workflow definition.
 
+### Skill Composition
+
+Chat conversations on capable runtimes can run multiple skills simultaneously, layering specialized behaviors (research, code review, document drafting) onto a single session. The composition engine enforces three guardrails:
+
+- **Capability gating** — only runtimes that advertise `supportsSkillComposition` accept more than one active skill; others fall back to single-skill mode with a visible hint.
+- **Conflict heuristic** — new skills whose tools or instructions overlap with an active one trigger a confirmation dialog before the swap is applied.
+- **Prompt-budget eviction** — when the combined skill prompts approach the model's context budget, the oldest low-priority skill is evicted automatically so the conversation stays responsive.
+
+The active stack persists on the conversation row (`conversations.active_skill_ids`), and the `mergeActiveSkillIds` helper keeps updates atomic across concurrent activations. See the [Chat](./chat.md) feature doc for the user-facing flow.
+
 ### Workflow Context Batching
 
 In multi-step workflows, context from earlier steps is batched and forwarded to downstream steps. This prevents information loss across the workflow and ensures each step has the full picture of prior results.

package/docs/features/chat.md

@@ -3,10 +3,10 @@ title: "Chat"
 category: "feature-reference"
 section: "chat"
 route: "/chat"
-tags: ["chat", "conversation", "ai", "tool-catalog", "mentions", "channels", "bidirectional"]
-features: ["chat-data-layer", "chat-engine", "chat-api-routes", "chat-ui-shell", "chat-message-rendering", "chat-input-composer", "bidirectional-channel-chat"]
+tags: ["chat", "conversation", "ai", "tool-catalog", "mentions", "channels", "bidirectional", "skills", "templates", "filters", "saved-searches"]
+features: ["chat-data-layer", "chat-engine", "chat-api-routes", "chat-ui-shell", "chat-message-rendering", "chat-input-composer", "bidirectional-channel-chat", "chat-skill-composition", "chat-composition-ui-v1", "chat-conversation-templates", "chat-filter-namespace", "chat-pinned-saved-searches", "saved-search-polish-v1"]
 screengrabCount: 4
-lastUpdated: "2026-03-31"
+lastUpdated: "2026-04-15"
 ---
 
 # Chat
@@ -18,10 +18,10 @@ The Chat page is your AI-powered command center for everything in your workspace
 ![Chat tool catalog](../screengrabs/chat-list.png)
 *Tool catalog with hero heading, category tabs (Explore / Create / Debug / Automate), Smart Picks row, and conversation sidebar*
 
-![Model selector](../screengrabs/chat-model-selector.png)
+![Model selector](../screengrabs/chat-model-picker.png)
 *Model selector dropdown showing Claude and Codex models organized by provider with cost tiers*
 
-![Create category tab](../screengrabs/chat-create-tab.png)
+![Create category tab](../screengrabs/chat-actions-tab.png)
 *Create category selected, showing prompts for spinning up tasks, workflows, and projects*
 
 ![Active conversation](../screengrabs/chat-conversation.png)
@@ -61,6 +61,41 @@ Every chat starts a new conversation that is saved automatically. Your conversat
 
 When bidirectional chat is enabled on a Slack or Telegram delivery channel, messages sent to Stagent from those platforms create conversations visible in the Chat sidebar. The same chat engine handles both web and channel conversations, including tool access, permission handling, and multi-turn context.
 
+### Skill Composition
+
+On runtimes that support multiple active skills, you can stack specialized behaviors onto a single conversation. Open the slash (`/`) popover and switch to the **Skills** tab — each skill card has an **+ Add** button. Active skills show a badge, and the header reads "N of M active" so you always know where you stand against the runtime's cap (`maxActiveSkills`).
+
+- **Modes** — add a skill in `replace` mode to swap it in, or `add` mode to layer it on top of the current stack.
+- **Conflict heuristic** — if a new skill clashes with one already active (overlapping tool needs, contradictory instructions), a confirmation dialog surfaces the conflict so you can choose which to keep.
+- **Prompt-budget eviction** — when the active skill set approaches the model's context budget, the oldest or lowest-priority skill is evicted automatically and shown in a lightweight toast.
+- **Capability gating** — runtimes that do not support composition (currently gated by `RuntimeFeatures.supportsSkillComposition`) render the Skills tab read-only with a "composition disabled on this runtime" hint.
+
+The currently active skills are persisted on the conversation itself (`conversations.active_skill_ids`) so re-opening a conversation restores the exact same stack.
+
+### Conversation Templates
+
+Rather than starting every conversation from a blank prompt, you can kick one off from a saved blueprint. Three entry points:
+
+- **Empty-state button** — the chat hero shows a "Start from template" button when no conversation is active.
+- **Slash command** — type `/new-from-template` in the composer to open the picker inline.
+- **Command palette** — press `⌘K` and pick the **Templates** group to browse by name.
+
+Each template resolves its opening prompt from the blueprint's optional `chatPrompt` field (falling back to the first step's prompt template if `chatPrompt` is not set). Variables in the prompt are filled in at launch so the conversation opens already primed with context.
+
+### Filter Namespace
+
+Type `#` in the chat search, the `@` popover, or the Skills popover to filter by namespace. Values can be double-quoted to include spaces — for example, `#scope:"customer support"` matches only entries whose scope equals that phrase. Supported qualifiers include `#scope:`, `#type:`, and surface-specific keys. The same `FilterInput` component powers the `/documents` list page and the `⌘K` palette, so the syntax is identical everywhere.
+
+### Saved Searches
+
+Frequently used filter + query combinations can be pinned and reused:
+
+- **Save a view** — run any search, then click **Save view** in the footer to name and pin it.
+- **Reuse from the palette** — `⌘K` shows a **Saved** group at the top; pick one to re-apply instantly.
+- **Reuse from mentions** — the `@` popover also surfaces saved searches in a dedicated group for in-composer reuse.
+
+Saved searches round-trip via `GET/PUT /api/settings/chat/saved-searches`, and the `cleanFilterInput()` helper strips any mention-trigger residue (`@`, `#`, `/`) so a pinned query stays clean no matter where you saved it from.
+
 ### Streaming Responses
 
 Responses stream in token by token with a blinking cursor. Markdown formatting -- headings, lists, code blocks with syntax highlighting, tables, and links -- renders as the text streams in. Code blocks include a copy button and language label.

package/docs/features/cost-usage.md

@@ -15,7 +15,7 @@ Track spend across providers and monitor token consumption with the cost and usa
 
 ## Screenshots
 
-![Cost and usage dashboard with spend breakdown](../screengrabs/cost-usage-list.png)
+![Cost and usage dashboard with spend breakdown](../screengrabs/costs-list.png)
 *The cost and usage dashboard showing spend metrics, provider breakdown, and budget pacing indicators.*
 
 ![Cost and usage below fold](../screengrabs/cost-usage-below-fold.png)