stagent 0.6.2 → 0.6.3

package/src/components/workflows/workflow-status-view.tsx

@@ -23,7 +23,10 @@ import {
   MessageSquareMore,
   FileText,
   Paperclip,
+  ArrowRight,
+  FolderKanban,
 } from "lucide-react";
+import { Checkbox } from "@/components/ui/checkbox";
 import ReactMarkdown from "react-markdown";
 import remarkGfm from "remark-gfm";
 import { toast } from "sonner";
@@ -72,6 +75,13 @@ interface WorkflowStatusData {
   swarmConfig?: SwarmConfig;
   stepDocuments?: Record<string, DocumentInfo[]>;
   parentDocuments?: DocumentInfo[];
+  runNumber?: number;
+  runHistory?: Array<{
+    runNumber: number | null;
+    taskCount: number;
+    completedCount: number;
+    failedCount: number;
+  }>;
 }
 
 interface WorkflowStatusViewProps {
@@ -315,6 +325,23 @@ export function WorkflowStatusView({ workflowId }: WorkflowStatusViewProps) {
                 <p className="text-sm text-muted-foreground mt-1">
                   {patternLabels[data.pattern] ?? data.pattern}
                 </p>
+                <div className="flex items-center gap-2 mt-1">
+                  {data.projectId && (
+                    <Badge
+                      variant="outline"
+                      className="text-xs cursor-pointer hover:bg-accent gap-1"
+                      onClick={() => router.push(`/projects/${data.projectId}`)}
+                    >
+                      <FolderKanban className="h-3 w-3" />
+                      Project
+                    </Badge>
+                  )}
+                  {data.runNumber != null && data.runNumber > 0 && (
+                    <Badge variant="outline" className="text-xs font-normal">
+                      Run #{data.runNumber}
+                    </Badge>
+                  )}
+                </div>
               </div>
             </div>
             <div className="flex items-center gap-2">
@@ -330,56 +357,53 @@ export function WorkflowStatusView({ workflowId }: WorkflowStatusViewProps) {
                 </Button>
               )}
 
-              {/* Edit — draft only */}
-              {data.status === "draft" && hasDefinition && (
+              {/* Edit — draft, completed, or failed */}
+              {["draft", "completed", "failed"].includes(data.status) && hasDefinition && (
                 <Button
-                  variant="ghost"
-                  size="icon"
-                  className="h-7 w-7"
-                  aria-label="Edit workflow"
+                  variant="outline"
+                  size="sm"
                   onClick={() => router.push(`/workflows/${workflowId}/edit`)}
                 >
-                  <Pencil className="h-3.5 w-3.5" />
+                  <Pencil className="h-3.5 w-3.5 mr-1.5" />
+                  Edit
                 </Button>
               )}
 
               {/* Clone — always available */}
               {hasDefinition && (
                 <Button
-                  variant="ghost"
-                  size="icon"
-                  className="h-7 w-7"
-                  aria-label="Clone workflow"
+                  variant="outline"
+                  size="sm"
                   onClick={() => router.push(`/workflows/${workflowId}/edit?clone=true`)}
                 >
-                  <Copy className="h-3.5 w-3.5" />
+                  <Copy className="h-3.5 w-3.5 mr-1.5" />
+                  Clone
                 </Button>
               )}
 
               {/* Re-run — completed/failed only */}
               {(data.status === "completed" || data.status === "failed") && (
                 <Button
-                  variant="ghost"
-                  size="icon"
-                  className="h-7 w-7"
-                  aria-label="Re-run workflow"
+                  variant="outline"
+                  size="sm"
                   onClick={handleRerun}
                   disabled={executing}
                 >
-                  <RotateCcw className="h-3.5 w-3.5" />
+                  <RotateCcw className="h-3.5 w-3.5 mr-1.5" />
+                  Re-run
                 </Button>
               )}
 
               {/* Delete — not active */}
               {data.status !== "active" && (
                 <Button
-                  variant="ghost"
-                  size="icon"
-                  className="h-7 w-7 text-destructive"
-                  aria-label="Delete workflow"
+                  variant="outline"
+                  size="sm"
+                  className="text-destructive hover:text-destructive"
                   onClick={() => setConfirmDelete(true)}
                 >
-                  <Trash2 className="h-3.5 w-3.5" />
+                  <Trash2 className="h-3.5 w-3.5 mr-1.5" />
+                  Delete
                 </Button>
               )}
             </div>
@@ -614,6 +638,11 @@ export function WorkflowStatusView({ workflowId }: WorkflowStatusViewProps) {
         />
       )}
 
+      {/* Output Dock — chain into new workflow */}
+      {data.status === "completed" && hasStepDocs && (
+        <OutputDock stepDocuments={data.stepDocuments!} steps={data.steps} />
+      )}
+
       {/* Delete confirmation */}
       <ConfirmDialog
         open={confirmDelete}
@@ -627,3 +656,119 @@ export function WorkflowStatusView({ workflowId }: WorkflowStatusViewProps) {
     </div>
   );
 }
+
+/** Output Dock — selectable output documents for chaining into a new workflow */
+function OutputDock({
+  stepDocuments,
+  steps,
+}: {
+  stepDocuments: Record<string, DocumentInfo[]>;
+  steps: StepWithState[];
+}) {
+  const router = useRouter();
+  const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set());
+
+  // Flatten all output documents
+  const allOutputDocs = Object.entries(stepDocuments).flatMap(
+    ([taskId, docs]) => {
+      const step = steps.find((s) => s.state.taskId === taskId);
+      return docs.map((doc) => ({
+        ...doc,
+        stepName: step?.name ?? "Unknown Step",
+      }));
+    }
+  );
+
+  if (allOutputDocs.length === 0) return null;
+
+  function toggleDoc(id: string) {
+    setSelectedIds((prev) => {
+      const next = new Set(prev);
+      if (next.has(id)) next.delete(id);
+      else next.add(id);
+      return next;
+    });
+  }
+
+  function selectAll() {
+    setSelectedIds(new Set(allOutputDocs.map((d) => d.id)));
+  }
+
+  function chainIntoNewWorkflow() {
+    if (selectedIds.size === 0) return;
+    const params = new URLSearchParams({
+      inputDocs: [...selectedIds].join(","),
+    });
+    router.push(`/workflows/new?${params}`);
+  }
+
+  return (
+    <Card>
+      <CardHeader className="pb-3">
+        <div className="flex items-center justify-between">
+          <CardTitle className="text-sm font-medium flex items-center gap-2">
+            <ArrowRight className="h-4 w-4" />
+            Chain Output Documents
+          </CardTitle>
+          <Button
+            variant="ghost"
+            size="sm"
+            onClick={selectAll}
+            className="text-xs"
+          >
+            Select All
+          </Button>
+        </div>
+        <p className="text-xs text-muted-foreground">
+          Select output documents to use as inputs in a new workflow
+        </p>
+      </CardHeader>
+      <CardContent>
+        <div className="grid grid-cols-1 sm:grid-cols-2 gap-2 mb-4">
+          {allOutputDocs.map((doc) => {
+            const isChecked = selectedIds.has(doc.id);
+            return (
+              <div
+                key={doc.id}
+                role="button"
+                tabIndex={0}
+                onClick={() => toggleDoc(doc.id)}
+                onKeyDown={(e) => { if (e.key === "Enter" || e.key === " ") { e.preventDefault(); toggleDoc(doc.id); } }}
+                className={`flex items-center gap-3 p-3 rounded-lg text-left transition-colors border cursor-pointer ${
+                  isChecked
+                    ? "bg-accent/50 border-accent"
+                    : "hover:bg-muted/50 border-border/50"
+                }`}
+              >
+                <Checkbox
+                  checked={isChecked}
+                  onCheckedChange={() => toggleDoc(doc.id)}
+                />
+                <FileText className="h-4 w-4 flex-shrink-0 text-muted-foreground" />
+                <div className="flex-1 min-w-0">
+                  <p className="text-sm font-medium truncate">
+                    {doc.originalName}
+                  </p>
+                  <p className="text-xs text-muted-foreground truncate">
+                    {doc.stepName}
+                  </p>
+                </div>
+              </div>
+            );
+          })}
+        </div>
+
+        {selectedIds.size > 0 && (
+          <Button
+            onClick={chainIntoNewWorkflow}
+            className="w-full gap-2"
+            size="sm"
+          >
+            <ArrowRight className="h-4 w-4" />
+            Chain {selectedIds.size} Document{selectedIds.size !== 1 ? "s" : ""} Into New Workflow
+          </Button>
+        )}
+      </CardContent>
+    </Card>
+  );
+}

package/src/lib/__tests__/npx-process-cwd.test.ts

@@ -40,6 +40,7 @@ describe("npx safety: no process.cwd() for app-internal asset resolution", () =>
   const ALLOWED_FILES = [
     "bin/cli.ts",                                // CLI entrypoint defines cwd context
     "src/lib/environment/workspace-context.ts",   // defines getLaunchCwd fallback
+    "src/lib/utils/app-root.ts",                  // validated fallback when import.meta.dirname is virtual
     "drizzle.config.ts",                          // build-time config
   ];
 
@@ -50,8 +51,13 @@ describe("npx safety: no process.cwd() for app-internal asset resolution", () =>
   const DANGEROUS_PATTERNS = [
     /process\.cwd\(\)\s*,\s*["'](?:public|docs|book|ai-native-notes|src)\b/,
     /process\.cwd\(\)\s*,\s*["'].*?\.(?:png|ico|svg|jpg|md|json)["']/,
+    // Catch bare process.cwd() in book/docs/profiles modules (even without join)
+    /process\.cwd\(\)/,
   ];
 
+  // Files in these directories are NEVER allowed to use process.cwd()
+  const STRICT_DIRS = ["src/lib/book/", "src/lib/docs/", "src/lib/agents/profiles/"];
+
   it("server-side code does not use process.cwd() for internal asset paths", () => {
     const srcFiles = collectFiles(join(PROJECT_ROOT, "src"));
     const binFiles = collectFiles(join(PROJECT_ROOT, "bin"));
@@ -69,10 +75,19 @@ describe("npx safety: no process.cwd() for app-internal asset resolution", () =>
 
       const content = readFileSync(filePath, "utf-8");
       const lines = content.split("\n");
+      const isStrictDir = STRICT_DIRS.some((d) => relative.startsWith(d));
 
       for (let i = 0; i < lines.length; i++) {
         const line = lines[i];
-        for (const pattern of DANGEROUS_PATTERNS) {
+        // In strict dirs, ANY process.cwd() in code (not comments) is a violation
+        const trimmed = line.trim();
+        const isComment = trimmed.startsWith("//") || trimmed.startsWith("*") || trimmed.startsWith("/*");
+        if (isStrictDir && !isComment && /process\.cwd\(\)/.test(line)) {
+          violations.push({ file: relative, line: i + 1, text: line.trim() });
+          continue;
+        }
+        // Elsewhere, only flag process.cwd() combined with app-internal paths
+        for (const pattern of DANGEROUS_PATTERNS.slice(0, 2)) {
           if (pattern.test(line)) {
             violations.push({ file: relative, line: i + 1, text: line.trim() });
           }
@@ -119,7 +134,7 @@ describe("npx safety: no process.cwd() for app-internal asset resolution", () =>
 
   it("icon assets referenced in metadata exist in public/", () => {
     const publicDir = join(PROJECT_ROOT, "public");
-    const requiredIcons = ["stagent-s-64.png", "stagent-s-128.png", "icon.svg"];
+    const requiredIcons = ["stagent-s-64.png", "stagent-s-128.png"];
 
     const missing = requiredIcons.filter((name) => {
       try {

package/src/lib/agents/profiles/registry.ts

@@ -15,11 +15,14 @@ import { eq, and } from "drizzle-orm";
  * Builtins ship inside the repo at src/lib/agents/profiles/builtins/.
  * At runtime they are copied (if missing) to ~/.claude/skills/ so users
  * can customize them without touching source.
- * Uses import.meta.dirname (not process.cwd()) so it works under npx.
+ * Uses getAppRoot + known subpath because Turbopack compiles import.meta.dirname
+ * to a virtual /ROOT/ path that doesn't exist on the filesystem.
  */
+import { getAppRoot } from "@/lib/utils/app-root";
+
 const BUILTINS_DIR = path.resolve(
-  import.meta.dirname ?? __dirname,
-  "builtins"
+  getAppRoot(import.meta.dirname, 4),
+  "src", "lib", "agents", "profiles", "builtins"
 );
 
 function getBuiltinsDir(): string {

package/src/lib/book/__tests__/chapter-slugs.test.ts

@@ -0,0 +1,80 @@
+import { describe, expect, it } from "vitest";
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join, resolve } from "path";
+import { CHAPTER_SLUGS, CHAPTER_MAPPING } from "../chapter-mapping";
+
+const PROJECT_ROOT = resolve(__dirname, "..", "..", "..", "..");
+const CHAPTERS_DIR = join(PROJECT_ROOT, "book", "chapters");
+
+describe("book chapter slug consistency", () => {
+  it("CHAPTER_SLUGS is the only slug map (no duplicates in other files)", () => {
+    const bookDir = resolve(__dirname, "..");
+    const files = readdirSync(bookDir).filter((f) => f.endsWith(".ts") && !f.endsWith(".test.ts"));
+    const violations: Array<{ file: string; line: number; text: string }> = [];
+
+    for (const file of files) {
+      if (file === "chapter-mapping.ts") continue; // canonical source
+      const content = readFileSync(join(bookDir, file), "utf-8");
+      const lines = content.split("\n");
+
+      for (let i = 0; i < lines.length; i++) {
+        // Detect inline slug maps: object literals with "ch-N": "ch-N-..." patterns
+        if (/["']ch-\d+["']\s*:\s*["']ch-\d+-/.test(lines[i])) {
+          violations.push({ file, line: i + 1, text: lines[i].trim() });
+        }
+      }
+    }
+
+    expect(
+      violations,
+      `Found duplicate slug maps outside chapter-mapping.ts (use CHAPTER_SLUGS import instead):\n${violations
+        .map((v) => `  ${v.file}:${v.line} → ${v.text}`)
+        .join("\n")}`
+    ).toEqual([]);
+  });
+
+  it("every CHAPTER_SLUGS entry has a corresponding markdown file", () => {
+    const missing: string[] = [];
+
+    for (const [chapterId, slug] of Object.entries(CHAPTER_SLUGS)) {
+      const filePath = join(CHAPTERS_DIR, `${slug}.md`);
+      if (!existsSync(filePath)) {
+        missing.push(`${chapterId} → book/chapters/${slug}.md`);
+      }
+    }
+
+    expect(
+      missing,
+      `Chapter markdown files missing for slug entries:\n  ${missing.join("\n  ")}`
+    ).toEqual([]);
+  });
+
+  it("no orphan chapter files exist without a CHAPTER_SLUGS entry", () => {
+    const validSlugs = new Set(Object.values(CHAPTER_SLUGS));
+    const files = readdirSync(CHAPTERS_DIR).filter((f) => f.endsWith(".md"));
+    const orphans: string[] = [];
+
+    for (const file of files) {
+      const slug = file.replace(/\.md$/, "");
+      if (!validSlugs.has(slug)) {
+        orphans.push(file);
+      }
+    }
+
+    expect(
+      orphans,
+      `Orphan chapter files found (not in CHAPTER_SLUGS — stale or misnamed):\n  ${orphans.join("\n  ")}`
+    ).toEqual([]);
+  });
+
+  it("CHAPTER_SLUGS and CHAPTER_MAPPING cover the same chapter IDs", () => {
+    const slugIds = new Set(Object.keys(CHAPTER_SLUGS));
+    const mappingIds = new Set(Object.keys(CHAPTER_MAPPING));
+
+    const inSlugsOnly = [...slugIds].filter((id) => !mappingIds.has(id));
+    const inMappingOnly = [...mappingIds].filter((id) => !slugIds.has(id));
+
+    expect(inSlugsOnly, `In CHAPTER_SLUGS but not CHAPTER_MAPPING`).toEqual([]);
+    expect(inMappingOnly, `In CHAPTER_MAPPING but not CHAPTER_SLUGS`).toEqual([]);
+  });
+});

package/src/lib/book/chapter-generator.ts

@@ -1,7 +1,8 @@
 import { readFileSync, existsSync } from "fs";
 import { join } from "path";
-import { CHAPTER_MAPPING } from "./chapter-mapping";
+import { CHAPTER_MAPPING, CHAPTER_SLUGS } from "./chapter-mapping";
 import { getChapter } from "./content";
+import { getAppRoot } from "../utils/app-root";
 
 /** Shared context gathered from disk for prompt assembly */
 interface ChapterContext {
@@ -29,10 +30,9 @@ export function gatherChapterContext(chapterId: string): ChapterContext {
 
   const mapping = CHAPTER_MAPPING[chapterId];
   const sourceDocSlugs = mapping?.docs ?? [];
-  const slug = chapterIdToSlug(chapterId);
+  const slug = CHAPTER_SLUGS[chapterId] ?? chapterId;
 
-  // Resolve paths relative to source file, not cwd (npx-safe)
-  const appRoot = join(import.meta.dirname ?? __dirname, "..", "..", "..");
+  const appRoot = getAppRoot(import.meta.dirname, 3);
 
   // Read the current chapter markdown (if it exists)
   const chapterMdPath = join(appRoot, "book", "chapters", `${slug}.md`);
@@ -179,18 +179,3 @@ export function buildChapterRegenerationPrompt(chapterId: string): string {
   return sections.join("\n");
 }
 
-/** Map chapter ID to markdown filename slug */
-function chapterIdToSlug(chapterId: string): string {
-  const slugMap: Record<string, string> = {
-    "ch-1": "ch-1-project-management",
-    "ch-2": "ch-2-task-execution",
-    "ch-3": "ch-3-document-processing",
-    "ch-4": "ch-4-workflow-orchestration",
-    "ch-5": "ch-5-scheduled-intelligence",
-    "ch-6": "ch-6-agent-self-improvement",
-    "ch-7": "ch-7-multi-agent-swarms",
-    "ch-8": "ch-8-human-in-the-loop",
-    "ch-9": "ch-9-autonomous-organization",
-  };
-  return slugMap[chapterId] ?? chapterId;
-}

package/src/lib/book/chapter-mapping.ts

@@ -1,5 +1,22 @@
 /** Maps book chapters to Playbook feature docs and journeys */
 
+/**
+ * Single source of truth: chapter ID → markdown filename slug.
+ * Used by content loader, chapter generator, and update detector.
+ * Slug corresponds to files in book/chapters/ (without .md extension).
+ */
+export const CHAPTER_SLUGS: Record<string, string> = {
+  "ch-1": "ch-1-project-management",
+  "ch-2": "ch-2-task-execution",
+  "ch-3": "ch-3-document-processing",
+  "ch-4": "ch-4-workflow-orchestration",
+  "ch-5": "ch-5-scheduled-intelligence",
+  "ch-6": "ch-6-agent-self-improvement",
+  "ch-7": "ch-7-multi-agent-swarms",
+  "ch-8": "ch-8-human-in-the-loop",
+  "ch-9": "ch-9-autonomous-organization",
+};
+
 interface ChapterMapping {
   docs: string[];
   journey?: string;

package/src/lib/book/content.ts

@@ -1,17 +1,5 @@
 import type { Book, BookChapter, BookPart } from "./types";
-
-/** Mapping from chapter ID to markdown filename slug (without ch-N- prefix) */
-const CHAPTER_SLUG_MAP: Record<string, string> = {
-  "ch-1": "ch-1-project-management",
-  "ch-2": "ch-2-task-execution",
-  "ch-3": "ch-3-document-processing",
-  "ch-4": "ch-4-workflow-orchestration",
-  "ch-5": "ch-5-scheduled-intelligence",
-  "ch-6": "ch-6-agent-self-improvement",
-  "ch-7": "ch-7-multi-agent-swarms",
-  "ch-8": "ch-8-human-in-the-loop",
-  "ch-9": "ch-9-the-autonomous-organization",
-};
+import { CHAPTER_SLUGS } from "./chapter-mapping";
 
 /** The three parts of the AI Native book */
 export const PARTS: BookPart[] = [
@@ -143,7 +131,7 @@ function tryLoadMarkdownChapter(id: string): BookChapter | null {
   if (typeof window !== "undefined") return null;
 
   try {
-    const fileSlug = CHAPTER_SLUG_MAP[id];
+    const fileSlug = CHAPTER_SLUGS[id];
     if (!fileSlug) return null;
 
     // Dynamic require to avoid bundling fs in client builds
@@ -154,8 +142,9 @@ function tryLoadMarkdownChapter(id: string): BookChapter | null {
     // eslint-disable-next-line @typescript-eslint/no-require-imports
     const { parseMarkdownChapter } = require("./markdown-parser") as { parseMarkdownChapter: (md: string, slug: string) => { sections: Array<{ id: string; title: string; content: import("./types").ContentBlock[] }> } };
 
-    // Resolve relative to source file, not cwd (npx-safe)
-    const appRoot = join(import.meta.dirname ?? __dirname, "..", "..", "..");
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const { getAppRoot } = require("../utils/app-root") as { getAppRoot: (metaDirname: string | undefined, depth: number) => string };
+    const appRoot = getAppRoot(import.meta.dirname, 3);
     const filePath = join(appRoot, "book", "chapters", `${fileSlug}.md`);
     if (!existsSync(filePath)) return null;
 

package/src/lib/book/update-detector.ts

@@ -1,7 +1,8 @@
 import { execFileSync } from "child_process";
 import { existsSync, readFileSync } from "fs";
 import { join } from "path";
-import { CHAPTER_MAPPING } from "./chapter-mapping";
+import { CHAPTER_MAPPING, CHAPTER_SLUGS } from "./chapter-mapping";
+import { getAppRoot } from "../utils/app-root";
 
 export interface ChapterStaleness {
   chapterId: string;
@@ -15,26 +16,12 @@ export interface ChapterStaleness {
   changedFiles: string[];
 }
 
-/** Chapter ID to markdown filename mapping */
-const CHAPTER_SLUGS: Record<string, string> = {
-  "ch-1": "ch-1-project-management",
-  "ch-2": "ch-2-task-execution",
-  "ch-3": "ch-3-document-processing",
-  "ch-4": "ch-4-workflow-orchestration",
-  "ch-5": "ch-5-scheduled-intelligence",
-  "ch-6": "ch-6-agent-self-improvement",
-  "ch-7": "ch-7-multi-agent-swarms",
-  "ch-8": "ch-8-human-in-the-loop",
-  "ch-9": "ch-9-autonomous-organization",
-};
-
 /** Read the lastGeneratedBy timestamp from a chapter's markdown frontmatter */
 function getLastGenerated(chapterId: string): string | null {
   const slug = CHAPTER_SLUGS[chapterId];
   if (!slug) return null;
 
-  // Resolve relative to source file, not cwd (npx-safe)
-  const appRoot = join(import.meta.dirname ?? __dirname, "..", "..", "..");
+  const appRoot = getAppRoot(import.meta.dirname, 3);
   const mdPath = join(appRoot, "book", "chapters", `${slug}.md`);
   if (!existsSync(mdPath)) return null;
 

package/src/lib/chat/engine.ts

@@ -299,6 +299,7 @@ export async function* sendMessage(
             "mcp__stagent__upload_document",
             "mcp__stagent__update_document",
             "mcp__stagent__delete_document",
+            "mcp__stagent__set_settings",
           ]);
           if (toolName.startsWith("mcp__stagent__") && !PERMISSION_GATED_TOOLS.has(toolName)) {
             // Emit tool-use status so the user sees what the model is doing

package/src/lib/chat/system-prompt.ts

@@ -27,6 +27,7 @@ export const STAGENT_SYSTEM_PROMPT = `You are Stagent, an AI workspace assistant
 - delete_workflow: Delete a workflow and its children [requires approval]
 - execute_workflow: Start workflow execution [requires approval]
 - get_workflow_status: Get current execution status with step progress
+- find_related_documents: Search the project document pool for documents to attach as workflow context
 
 ### Schedules
 - list_schedules: List all scheduled prompt loops
@@ -81,4 +82,11 @@ Be proactive with tools. If the user asks about project status, use list_tasks t
 - If a project context is active, scope operations to it unless the user specifies otherwise.
 - Tools marked [requires approval] will prompt the user before executing.
 - For workflows, valid patterns are: sequence, parallel, checkpoint, planner-executor, swarm, loop.
-- When a working directory is specified, always create files relative to it. Never assume the git root is the working directory — they may differ in worktree environments.`;
+- When a working directory is specified, always create files relative to it. Never assume the git root is the working directory — they may differ in worktree environments.
+
+## Document Pool Awareness
+When creating follow-up workflows that should reference documents from prior work:
+1. **Proactively discover**: Use find_related_documents to check for output documents from completed workflows in the project
+2. **Wire documents in**: Pass documentIds to create_workflow to attach pool documents as context for all steps
+3. **After execution**: Mention output documents by name and suggest they can be used in follow-up workflows
+4. **Never ask for raw IDs**: Use find_related_documents to discover documents by name or source workflow — don't make the user look up IDs manually`;

package/src/lib/chat/tool-catalog.ts

@@ -136,6 +136,7 @@ const STAGENT_TOOLS: ToolCatalogEntry[] = [
 
   // ── Settings ──
   { name: "get_settings", description: "Get current Stagent settings", group: "Settings", paramHint: "key" },
+  { name: "set_settings", description: "Update a Stagent setting (approval required)", group: "Settings", paramHint: "key, value" },
 
   // ── Chat History ──
   { name: "list_conversations", description: "List recent chat conversations", group: "Chat", paramHint: "search, limit" },