rahman-resources 1.16.0 → 1.16.2

package/lib/manifest.json

@@ -26,7 +26,10 @@
     "notion-database": "notion-ui",
     "notion-sidebar": "notion-ui",
     "notion": "notion-app",
-    "admin-console": "admin"
+    "admin-console": "admin",
+    "ai-chat": "ai-workspace",
+    "ai-studio": "ai-workspace",
+    "ai-agents": "ai-workspace"
   },
   "layouts": [],
   "recipes": [],
@@ -435,10 +438,10 @@
       ]
     },
     {
-      "slug": "ai-chat",
-      "title": "AI Chat — Workbench / Sidebar / Search",
+      "slug": "ai-workspace",
+      "title": "AI Workspace — chat · studio · agents",
       "category": "ai",
-      "description": "One conversational AI feature, three render modes. Same Convex backend (threads + streaming + tool calls + RAG), pick the surface via prop:\n\n  • workbench — Claude.ai / ChatGPT three-column page (default)\n  • sidebar — collapsible copilot panel inside another CRUD app\n  • search — single-question + answer + citations (Perplexity)\n\nUse cases:\n  – Customer-support chatbot embedded in your marketing site\n  – Developer copilot in your PR/docs admin\n  – Knowledge-base search over your blog + docs corpus\n  – Internal AI assistant in your dashboard\n\nWhat it ships: multi-provider (Anthropic / OpenAI / Google / Mistral / Ollama), multimodal (text + image + PDF + audio), typed tool calls with inline inspector, agent mode (plan→execute→reflect), branching threads, RAG citations, resumable streams, usage telemetry. Public surface = consumer chat; admin surface = persona, fallback, guardrails per-bot.",
+      "description": "Three AI surfaces as shadcn-style variants — `npx rr add ai-workspace <variant>` for one, or `npx rr add ai-workspace` for all + a switcher. Only the chat variant pulls a Convex backend (per-variant convex gating).\n\n  • chat — floating <AiChatFab /> + createAgenticChatSend: real function-calling over any ToolHost (@/shared/agentic), key-guarded, over convex/features/aiChat.\n  • studio — <AiStudioPage /> single-prompt generation canvas (variation grid + version tree, Suno / Midjourney / Lovable pattern) + aiStudioTools so a shared agent can drive generations.\n  • agents — <AiAgentsPage /> autonomous-worker run dashboard + createAgentRunner(host) which drives the shared function-calling loop and records each tool_use as a RunStep trace.\n\nUse cases: support chatbot in a marketing site, AI generation product (image / code / text / audio), background workers (nightly audits, scheduled crawls, moderation). studio + agents are frontend-only — wire your own persistence.",
       "source": "rahmanef63/resource-site",
       "docsUrl": "https://sdk.vercel.ai/docs",
       "install": "npm i ai @ai-sdk/anthropic @ai-sdk/openai",
@@ -448,58 +451,19 @@
         "@ai-sdk/openai"
       ],
       "exampleCode": "",
-      "agentRecipe": "Run `npx rr add ai-chat`. Pick `mode=\"workbench\" | \"sidebar\" | \"search\"` on `<AIChat />` (or use the convenience exports `<AIChatWorkbench />`, `<AIChatSidebar />`, `<AIChatSearch />`). Same backend tables + streaming action for all three.",
-      "tags": [
-        "ai",
-        "ai:chat",
-        "streaming",
-        "multimodal",
-        "tool-calls",
-        "agent-mode",
-        "rag",
-        "citations",
-        "branching",
-        "history"
-      ]
-    },
-    {
-      "slug": "ai-studio",
-      "title": "AI Studio — Generation Canvas",
-      "category": "ai",
-      "description": "AI is the primary UI — single big prompt input → live-streaming output → variation grid → version tree. Suno / Midjourney / Lovable / v0 pattern. Output kinds: text, code, image, audio (configurable per template).\n\nUse cases:\n  – AI image generation product (creative output)\n  – AI logo / banner / social-post studio\n  – AI code-snippet generator (component scaffolder)\n  – AI music / voiceover producer\n  – AI blog-draft factory (text)\n\nFeatures: prompt history, branch + compare outputs, like + favorite, share-to-link, templates from ai-admin.",
-      "source": "rahmanef63/resource-site",
-      "install": "",
-      "npmPackages": [],
-      "exampleCode": "",
-      "agentRecipe": "Run `npx rr add ai-studio`. Mount `<GeneratorCanvas />` at /. Use case: prompt → output IS the entire product. Wire your output renderer (text/image/code/audio) via the OutputSlot adapter. Templates loaded from ai-admin.studio.templates.",
+      "agentRecipe": "Run `npx rr add ai-workspace <chat|studio|agents>` for one surface, or `npx rr add ai-workspace` for all. chat: mount <AiChatFab chat={useAction(api.features.aiChat.action.chat)} />. studio: mount <AiStudioPage /> + drive via aiStudioTools. agents: mount <AiAgentsPage /> + trigger via createAgentRunner(host).",
       "tags": [
         "ai",
+        "ai:chatbot",
         "ai:studio",
-        "generation",
-        "streaming",
-        "history",
-        "branching",
-        "image-gen"
-      ]
-    },
-    {
-      "slug": "ai-agents",
-      "title": "AI Agents — Autonomous Workers",
-      "category": "ai",
-      "description": "Background AI workers. Define an agent (skill × model × tools × max-iter), trigger it on-demand or on a cron schedule, watch the step-by-step trace as it runs. Devin / Replit-Agent / Manus pattern.\n\nUse cases:\n  – Nightly audit-bp on the codebase (PR-reviewer style)\n  – Weekly SEO crawl + content suggestions\n  – Auto-moderate comment queue\n  – Scheduled data ingestion + summarization\n  – Long-form research task with multi-source citations\n\nFeatures: queue + live trace, per-step retry policy, hard cost cap, shareable trace URLs, full audit-log integration.",
-      "source": "rahmanef63/resource-site",
-      "install": "",
-      "npmPackages": [],
-      "exampleCode": "",
-      "agentRecipe": "Run `npx rr add ai-agents`. Mount `<RunnerDashboard />` at /agents. Trigger runs via `runAgent({agentSlug, input, scheduleAt?})`. Cron scheduler via Convex cron — wire if you need scheduled runs. Agent definitions managed in ai-admin.",
-      "tags": [
-        "ai",
-        "ai:agents",
+        "ai:agent",
         "agent-mode",
         "tool-calls",
+        "streaming",
+        "generation",
         "async",
-        "queue",
-        "traces"
+        "traces",
+        "multimodal"
       ]
     },
     {
@@ -529,7 +493,7 @@
       "slug": "ai-router",
       "title": "AI Router — Backend Provider Proxy",
       "category": "ai",
-      "description": "Backend infrastructure (no UI). Single proxy that every other ai-* feature calls. Tier-routed — nano (Haiku) for classification, mid (Sonnet) for chat, flagship (Opus) for deep reasoning. Per-call usage log + cost guard. Works with direct provider keys or OpenRouter umbrella.\n\nNot something you mount — installed automatically as a peer when you add ai-chat / ai-studio / ai-agents.",
+      "description": "Backend infrastructure (no UI). Single proxy that every other ai-* feature calls. Tier-routed — nano (Haiku) for classification, mid (Sonnet) for chat, flagship (Opus) for deep reasoning. Per-call usage log + cost guard. Works with direct provider keys or OpenRouter umbrella.\n\nNot something you mount — installed automatically as a peer when you add ai-workspace.",
       "source": "rahmanef63/resource-site",
       "docsUrl": "https://sdk.vercel.ai/docs",
       "install": "npm i ai @openrouter/ai-sdk-provider",
@@ -2331,16 +2295,16 @@
       "agentRecipe": "Run `npx rr add resend-newsletter`. Use Resend Audiences API for newsletter — store subscriber emails in Convex too for segmentation. Double opt-in: subscriber.create with status 'pending' → click link → status 'confirmed'."
     },
     {
-      "slug": "ai-chat",
-      "title": "AI Chat — Workbench / Sidebar / Search",
+      "slug": "ai-workspace",
+      "title": "AI Workspace — chat · studio · agents",
       "category": "ai",
       "kind": "full",
       "version": "0.3.0",
-      "description": "One conversational AI feature, three render modes. Same Convex backend (threads + streaming + tool calls + RAG), pick the surface via prop:\n\n  • workbench — Claude.ai / ChatGPT three-column page (default)\n  • sidebar — collapsible copilot panel inside another CRUD app\n  • search — single-question + answer + citations (Perplexity)\n\nUse cases:\n  – Customer-support chatbot embedded in your marketing site\n  – Developer copilot in your PR/docs admin\n  – Knowledge-base search over your blog + docs corpus\n  – Internal AI assistant in your dashboard\n\nWhat it ships: multi-provider (Anthropic / OpenAI / Google / Mistral / Ollama), multimodal (text + image + PDF + audio), typed tool calls with inline inspector, agent mode (plan→execute→reflect), branching threads, RAG citations, resumable streams, usage telemetry. Public surface = consumer chat; admin surface = persona, fallback, guardrails per-bot.",
+      "description": "Three AI surfaces as shadcn-style variants — `npx rr add ai-workspace <variant>` for one, or `npx rr add ai-workspace` for all + a switcher. Only the chat variant pulls a Convex backend (per-variant convex gating).\n\n  • chat — floating <AiChatFab /> + createAgenticChatSend: real function-calling over any ToolHost (@/shared/agentic), key-guarded, over convex/features/aiChat.\n  • studio — <AiStudioPage /> single-prompt generation canvas (variation grid + version tree, Suno / Midjourney / Lovable pattern) + aiStudioTools so a shared agent can drive generations.\n  • agents — <AiAgentsPage /> autonomous-worker run dashboard + createAgentRunner(host) which drives the shared function-calling loop and records each tool_use as a RunStep trace.\n\nUse cases: support chatbot in a marketing site, AI generation product (image / code / text / audio), background workers (nightly audits, scheduled crawls, moderation). studio + agents are frontend-only — wire your own persistence.",
       "source": "rahmanef63/resource-site",
-      "slicePath": "frontend/slices/ai-chat",
+      "slicePath": "frontend/slices/ai-workspace",
       "convexPaths": [
-        "convex/features/ai"
+        "convex/features/aiChat"
       ],
       "npm": [
         "ai@^4.0.0",
@@ -2348,19 +2312,20 @@
         "@ai-sdk/openai@^0.0.60"
       ],
       "shadcn": [
+        "avatar",
+        "badge",
         "button",
         "card",
-        "badge",
-        "avatar",
+        "progress",
         "scroll-area",
         "select",
         "separator",
         "slider",
         "switch",
-        "textarea",
+        "table",
         "tabs",
-        "command",
-        "sheet"
+        "textarea",
+        "tooltip"
       ],
       "env": [
         {
@@ -2383,152 +2348,64 @@
         {
           "slug": "convex-auth",
           "range": "^0.1",
-          "reason": "Thread ownership requires authenticated user."
+          "reason": "chat/studio/agents ownership requires an authenticated user."
         },
         {
           "slug": "ai-router",
           "range": "^0.1",
-          "reason": "Routes provider calls through tiered proxy."
+          "reason": "Routes provider calls through the tiered proxy."
         },
         {
           "slug": "ai-admin",
           "range": "^0.1",
-          "reason": "Reads instructions / skills / tools / models from ai-admin registry."
+          "reason": "Reads instructions / skills / tools / models / agent defs from the ai-admin registry."
         },
         {
           "slug": "vector-search",
           "range": "^0.1",
-          "reason": "Optional — RAG / search modes pull workspace embeddings."
-        }
-      ],
-      "providers": [],
-      "tags": [
-        "ai",
-        "ai:chat",
-        "streaming",
-        "multimodal",
-        "tool-calls",
-        "agent-mode",
-        "rag",
-        "citations",
-        "branching",
-        "history"
-      ],
-      "agentRecipe": "Run `npx rr add ai-chat`. Pick `mode=\"workbench\" | \"sidebar\" | \"search\"` on `<AIChat />` (or use the convenience exports `<AIChatWorkbench />`, `<AIChatSidebar />`, `<AIChatSearch />`). Same backend tables + streaming action for all three."
-    },
-    {
-      "slug": "ai-studio",
-      "title": "AI Studio — Generation Canvas",
-      "category": "ai",
-      "kind": "full",
-      "version": "0.2.0",
-      "description": "AI is the primary UI — single big prompt input → live-streaming output → variation grid → version tree. Suno / Midjourney / Lovable / v0 pattern. Output kinds: text, code, image, audio (configurable per template).\n\nUse cases:\n  – AI image generation product (creative output)\n  – AI logo / banner / social-post studio\n  – AI code-snippet generator (component scaffolder)\n  – AI music / voiceover producer\n  – AI blog-draft factory (text)\n\nFeatures: prompt history, branch + compare outputs, like + favorite, share-to-link, templates from ai-admin.",
-      "source": "rahmanef63/resource-site",
-      "slicePath": "frontend/slices/ai-studio",
-      "convexPaths": [
-        "convex/features/ai"
-      ],
-      "npm": [
-        "ai@^4.0.0"
-      ],
-      "shadcn": [
-        "button",
-        "card",
-        "badge",
-        "textarea",
-        "tabs",
-        "tooltip",
-        "scroll-area",
-        "select"
-      ],
-      "env": [],
-      "peers": [
-        {
-          "slug": "convex-auth",
-          "range": "^0.1",
-          "reason": "Generation history per user."
-        },
-        {
-          "slug": "ai-router",
-          "range": "^0.1",
-          "reason": "All generation calls flow through router."
-        },
-        {
-          "slug": "ai-admin",
-          "range": "^0.1",
-          "reason": "Templates + few-shot library + moderation rules live in ai-admin."
+          "reason": "Optional — chat RAG mode pulls workspace embeddings."
         }
       ],
       "providers": [],
       "tags": [
         "ai",
+        "ai:chatbot",
         "ai:studio",
-        "generation",
-        "streaming",
-        "history",
-        "branching",
-        "image-gen"
-      ],
-      "agentRecipe": "Run `npx rr add ai-studio`. Mount `<GeneratorCanvas />` at /. Use case: prompt → output IS the entire product. Wire your output renderer (text/image/code/audio) via the OutputSlot adapter. Templates loaded from ai-admin.studio.templates."
-    },
-    {
-      "slug": "ai-agents",
-      "title": "AI Agents — Autonomous Workers",
-      "category": "ai",
-      "kind": "full",
-      "version": "0.2.0",
-      "description": "Background AI workers. Define an agent (skill × model × tools × max-iter), trigger it on-demand or on a cron schedule, watch the step-by-step trace as it runs. Devin / Replit-Agent / Manus pattern.\n\nUse cases:\n  – Nightly audit-bp on the codebase (PR-reviewer style)\n  – Weekly SEO crawl + content suggestions\n  – Auto-moderate comment queue\n  – Scheduled data ingestion + summarization\n  – Long-form research task with multi-source citations\n\nFeatures: queue + live trace, per-step retry policy, hard cost cap, shareable trace URLs, full audit-log integration.",
-      "source": "rahmanef63/resource-site",
-      "slicePath": "frontend/slices/ai-agents",
-      "convexPaths": [
-        "convex/features/ai"
-      ],
-      "npm": [
-        "ai@^4.0.0"
-      ],
-      "shadcn": [
-        "button",
-        "card",
-        "badge",
-        "table",
-        "tabs",
-        "scroll-area",
-        "progress"
-      ],
-      "env": [],
-      "peers": [
-        {
-          "slug": "convex-auth",
-          "range": "^0.1",
-          "reason": "Per-user agent run ownership."
-        },
-        {
-          "slug": "ai-router",
-          "range": "^0.1",
-          "reason": "Step calls flow through router."
-        },
-        {
-          "slug": "ai-admin",
-          "range": "^0.1",
-          "reason": "Agent definitions live in ai-admin → Agents."
-        },
-        {
-          "slug": "audit-log",
-          "range": "^0.1",
-          "reason": "Every step logged."
-        }
-      ],
-      "providers": [],
-      "tags": [
-        "ai",
-        "ai:agents",
+        "ai:agent",
         "agent-mode",
         "tool-calls",
+        "streaming",
+        "generation",
         "async",
-        "queue",
-        "traces"
+        "traces",
+        "multimodal"
       ],
-      "agentRecipe": "Run `npx rr add ai-agents`. Mount `<RunnerDashboard />` at /agents. Trigger runs via `runAgent({agentSlug, input, scheduleAt?})`. Cron scheduler via Convex cron — wire if you need scheduled runs. Agent definitions managed in ai-admin."
+      "agentRecipe": "Run `npx rr add ai-workspace <chat|studio|agents>` for one surface, or `npx rr add ai-workspace` for all. chat: mount <AiChatFab chat={useAction(api.features.aiChat.action.chat)} />. studio: mount <AiStudioPage /> + drive via aiStudioTools. agents: mount <AiAgentsPage /> + trigger via createAgentRunner(host).",
+      "variants": {
+        "default": "chat",
+        "items": [
+          {
+            "id": "chat",
+            "title": "Chat",
+            "description": "Floating assistant FAB with real function-calling over any ToolHost.",
+            "convex": [
+              "convex/features/aiChat"
+            ]
+          },
+          {
+            "id": "studio",
+            "title": "Studio",
+            "description": "Single-prompt generation canvas + agentic generate tool.",
+            "convex": []
+          },
+          {
+            "id": "agents",
+            "title": "Agents",
+            "description": "Autonomous-worker run dashboard + createAgentRunner loop.",
+            "convex": []
+          }
+        ]
+      }
     },
     {
       "slug": "ai-admin",
@@ -2608,7 +2485,7 @@
       "category": "ai",
       "kind": "backend",
       "version": "0.5.0",
-      "description": "Backend infrastructure (no UI). Single proxy that every other ai-* feature calls. Tier-routed — nano (Haiku) for classification, mid (Sonnet) for chat, flagship (Opus) for deep reasoning. Per-call usage log + cost guard. Works with direct provider keys or OpenRouter umbrella.\n\nNot something you mount — installed automatically as a peer when you add ai-chat / ai-studio / ai-agents.",
+      "description": "Backend infrastructure (no UI). Single proxy that every other ai-* feature calls. Tier-routed — nano (Haiku) for classification, mid (Sonnet) for chat, flagship (Opus) for deep reasoning. Per-call usage log + cost guard. Works with direct provider keys or OpenRouter umbrella.\n\nNot something you mount — installed automatically as a peer when you add ai-workspace.",
       "source": "rahmanef63/resource-site",
       "slicePath": "frontend/slices/ai-router",
       "convexPaths": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rahman-resources",
-  "version": "1.16.0",
+  "version": "1.16.2",
   "description": "Rahman Resources (rr) — shadcn-style installer for vertical slices. `npx resources add <slug>` copies slice into your project's `slices/<slug>/`. You own the files.",
   "type": "module",
   "license": "MIT",