stagent 0.4.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +67 -31
- package/dist/cli.js +151 -2
- package/docs/.coverage-gaps.json +21 -0
- package/docs/.last-generated +1 -1
- package/docs/features/agent-intelligence.md +36 -14
- package/docs/features/chat.md +53 -71
- package/docs/features/cost-usage.md +14 -10
- package/docs/features/dashboard-kanban.md +30 -13
- package/docs/features/delivery-channels.md +198 -0
- package/docs/features/design-system.md +10 -10
- package/docs/features/documents.md +8 -8
- package/docs/features/home-workspace.md +20 -15
- package/docs/features/inbox-notifications.md +22 -10
- package/docs/features/keyboard-navigation.md +11 -11
- package/docs/features/monitoring.md +1 -1
- package/docs/features/playbook.md +30 -32
- package/docs/features/profiles.md +33 -11
- package/docs/features/projects.md +2 -2
- package/docs/features/provider-runtimes.md +58 -14
- package/docs/features/schedules.md +77 -41
- package/docs/features/settings.md +134 -51
- package/docs/features/shared-components.md +7 -15
- package/docs/features/tool-permissions.md +9 -9
- package/docs/features/workflows.md +32 -21
- package/docs/getting-started.md +33 -9
- package/docs/index.md +25 -16
- package/docs/journeys/developer.md +124 -207
- package/docs/journeys/personal-use.md +70 -79
- package/docs/journeys/power-user.md +107 -151
- package/docs/journeys/work-use.md +81 -113
- package/docs/manifest.json +79 -47
- package/docs/superpowers/plans/2026-03-30-finish-in-progress-features.md +547 -0
- package/docs/superpowers/specs/2026-03-27-chat-screenshot-display-design.md +303 -0
- package/docs/use-cases/agency-operator.md +84 -0
- package/docs/use-cases/solo-founder.md +75 -0
- package/docs/why-stagent.md +59 -0
- package/package.json +12 -3
- package/src/app/api/channels/[id]/route.ts +103 -0
- package/src/app/api/channels/[id]/test/route.ts +52 -0
- package/src/app/api/channels/inbound/slack/route.ts +109 -0
- package/src/app/api/channels/inbound/telegram/poll/route.ts +128 -0
- package/src/app/api/channels/inbound/telegram/route.ts +76 -0
- package/src/app/api/channels/route.ts +71 -0
- package/src/app/api/chat/conversations/[id]/messages/route.ts +3 -2
- package/src/app/api/chat/conversations/route.ts +15 -0
- package/src/app/api/chat/entities/search/route.ts +112 -0
- package/src/app/api/documents/[id]/file/route.ts +4 -1
- package/src/app/api/environment/profiles/suggest/route.ts +19 -3
- package/src/app/api/environment/scan/route.ts +8 -1
- package/src/app/api/handoffs/[id]/route.ts +76 -0
- package/src/app/api/handoffs/route.ts +89 -0
- package/src/app/api/memory/route.ts +181 -0
- package/src/app/api/profiles/[id]/route.ts +16 -1
- package/src/app/api/profiles/[id]/test/route.ts +4 -0
- package/src/app/api/profiles/[id]/test-results/route.ts +22 -0
- package/src/app/api/profiles/[id]/test-single/route.ts +64 -0
- package/src/app/api/profiles/assist/route.ts +35 -0
- package/src/app/api/profiles/import-repo/apply-updates/route.ts +123 -0
- package/src/app/api/profiles/import-repo/check-updates/route.ts +163 -0
- package/src/app/api/profiles/import-repo/confirm/route.ts +118 -0
- package/src/app/api/profiles/import-repo/preview/route.ts +107 -0
- package/src/app/api/profiles/import-repo/route.ts +29 -0
- package/src/app/api/profiles/import-repo/scan/route.ts +25 -0
- package/src/app/api/profiles/route.ts +73 -22
- package/src/app/api/projects/[id]/route.ts +119 -9
- package/src/app/api/projects/__tests__/delete-project.test.ts +170 -0
- package/src/app/api/runtimes/ollama/route.ts +86 -0
- package/src/app/api/runtimes/suggest/route.ts +29 -0
- package/src/app/api/schedules/[id]/heartbeat-history/route.ts +77 -0
- package/src/app/api/schedules/[id]/route.ts +41 -3
- package/src/app/api/schedules/parse/route.ts +66 -0
- package/src/app/api/schedules/route.ts +71 -12
- package/src/app/api/settings/author-default/route.ts +7 -0
- package/src/app/api/settings/browser-tools/route.ts +68 -0
- package/src/app/api/settings/learning/route.ts +41 -0
- package/src/app/api/settings/ollama/route.ts +34 -0
- package/src/app/api/settings/providers/route.ts +57 -0
- package/src/app/api/settings/routing/route.ts +24 -0
- package/src/app/api/settings/web-search/route.ts +28 -0
- package/src/app/api/tasks/[id]/execute/route.ts +13 -1
- package/src/app/documents/page.tsx +3 -0
- package/src/app/environment/page.tsx +8 -1
- package/src/app/settings/page.tsx +12 -4
- package/src/app/workflows/[id]/edit/page.tsx +2 -0
- package/src/app/workflows/new/page.tsx +2 -0
- package/src/components/chat/chat-command-popover.tsx +280 -0
- package/src/components/chat/chat-input.tsx +90 -10
- package/src/components/chat/chat-message.tsx +9 -3
- package/src/components/chat/chat-model-selector.tsx +42 -1
- package/src/components/chat/chat-shell.tsx +31 -5
- package/src/components/chat/screenshot-gallery.tsx +96 -0
- package/src/components/dashboard/welcome-landing.tsx +9 -9
- package/src/components/environment/artifact-card.tsx +27 -1
- package/src/components/environment/environment-dashboard.tsx +50 -2
- package/src/components/environment/environment-summary-card.tsx +5 -2
- package/src/components/environment/suggested-profiles.tsx +117 -52
- package/src/components/handoffs/handoff-approval-card.tsx +159 -0
- package/src/components/memory/memory-browser.tsx +315 -0
- package/src/components/monitoring/log-entry.tsx +61 -27
- package/src/components/profiles/learned-context-panel.tsx +4 -4
- package/src/components/profiles/profile-assist-panel.tsx +512 -0
- package/src/components/profiles/profile-browser.tsx +109 -8
- package/src/components/profiles/profile-card.tsx +29 -1
- package/src/components/profiles/profile-detail-view.tsx +200 -28
- package/src/components/profiles/profile-form-view.tsx +220 -82
- package/src/components/profiles/repo-import-wizard.tsx +648 -0
- package/src/components/profiles/smoke-test-editor.tsx +106 -0
- package/src/components/projects/project-detail.tsx +15 -2
- package/src/components/schedules/schedule-create-sheet.tsx +32 -330
- package/src/components/schedules/schedule-detail-sheet.tsx +37 -21
- package/src/components/schedules/schedule-edit-sheet.tsx +159 -0
- package/src/components/schedules/schedule-form.tsx +749 -0
- package/src/components/schedules/schedule-list.tsx +31 -2
- package/src/components/settings/auth-method-selector.tsx +7 -1
- package/src/components/settings/browser-tools-section.tsx +247 -0
- package/src/components/settings/budget-guardrails-section.tsx +111 -48
- package/src/components/settings/channels-section.tsx +526 -0
- package/src/components/settings/chat-settings-section.tsx +27 -1
- package/src/components/settings/data-management-section.tsx +8 -6
- package/src/components/settings/learning-context-section.tsx +124 -0
- package/src/components/settings/ollama-section.tsx +270 -0
- package/src/components/settings/providers-runtimes-section.tsx +499 -0
- package/src/components/settings/runtime-timeout-section.tsx +4 -4
- package/src/components/settings/web-search-section.tsx +101 -0
- package/src/components/shared/command-palette.tsx +1 -30
- package/src/components/shared/screenshot-lightbox.tsx +151 -0
- package/src/components/shared/tag-input.tsx +156 -0
- package/src/components/tasks/kanban-board.tsx +32 -0
- package/src/components/tasks/kanban-column.tsx +4 -2
- package/src/components/tasks/task-card.tsx +1 -0
- package/src/components/tasks/task-chip-bar.tsx +6 -1
- package/src/components/tasks/task-create-panel.tsx +55 -5
- package/src/components/workflows/workflow-form-view.tsx +38 -3
- package/src/hooks/use-caret-position.ts +104 -0
- package/src/hooks/use-chat-autocomplete.ts +288 -0
- package/src/hooks/use-project-skills.ts +66 -0
- package/src/hooks/use-tag-suggestions.ts +31 -0
- package/src/instrumentation.ts +4 -1
- package/src/lib/agents/__tests__/browser-mcp.test.ts +175 -0
- package/src/lib/agents/__tests__/claude-agent.test.ts +6 -0
- package/src/lib/agents/__tests__/learned-context.test.ts +10 -0
- package/src/lib/agents/agentic-loop.ts +235 -0
- package/src/lib/agents/browser-mcp.ts +174 -0
- package/src/lib/agents/claude-agent.ts +83 -198
- package/src/lib/agents/handoff/bus.ts +164 -0
- package/src/lib/agents/handoff/governance.ts +47 -0
- package/src/lib/agents/handoff/types.ts +16 -0
- package/src/lib/agents/learned-context.ts +27 -7
- package/src/lib/agents/memory/decay.ts +61 -0
- package/src/lib/agents/memory/extractor.ts +181 -0
- package/src/lib/agents/memory/retrieval.ts +96 -0
- package/src/lib/agents/memory/types.ts +6 -0
- package/src/lib/agents/profiles/__tests__/project-profiles.test.ts +119 -0
- package/src/lib/agents/profiles/__tests__/registry.test.ts +11 -3
- package/src/lib/agents/profiles/builtins/code-reviewer/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/content-creator/SKILL.md +19 -0
- package/src/lib/agents/profiles/builtins/content-creator/profile.yaml +27 -0
- package/src/lib/agents/profiles/builtins/customer-support-agent/SKILL.md +19 -0
- package/src/lib/agents/profiles/builtins/customer-support-agent/profile.yaml +26 -0
- package/src/lib/agents/profiles/builtins/data-analyst/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/devops-engineer/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/document-writer/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/financial-analyst/SKILL.md +19 -0
- package/src/lib/agents/profiles/builtins/financial-analyst/profile.yaml +24 -0
- package/src/lib/agents/profiles/builtins/general/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/health-fitness-coach/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/learning-coach/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/marketing-strategist/SKILL.md +19 -0
- package/src/lib/agents/profiles/builtins/marketing-strategist/profile.yaml +27 -0
- package/src/lib/agents/profiles/builtins/operations-coordinator/SKILL.md +19 -0
- package/src/lib/agents/profiles/builtins/operations-coordinator/profile.yaml +26 -0
- package/src/lib/agents/profiles/builtins/project-manager/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/researcher/SKILL.md +1 -0
- package/src/lib/agents/profiles/builtins/researcher/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/sales-researcher/SKILL.md +19 -0
- package/src/lib/agents/profiles/builtins/sales-researcher/profile.yaml +26 -0
- package/src/lib/agents/profiles/builtins/shopping-assistant/SKILL.md +1 -0
- package/src/lib/agents/profiles/builtins/shopping-assistant/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/sweep/profile.yaml +1 -1
- package/src/lib/agents/profiles/builtins/technical-writer/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/travel-planner/SKILL.md +2 -0
- package/src/lib/agents/profiles/builtins/travel-planner/profile.yaml +2 -2
- package/src/lib/agents/profiles/builtins/wealth-manager/SKILL.md +2 -0
- package/src/lib/agents/profiles/builtins/wealth-manager/profile.yaml +2 -2
- package/src/lib/agents/profiles/project-profiles.ts +193 -0
- package/src/lib/agents/profiles/registry.ts +130 -6
- package/src/lib/agents/profiles/types.ts +28 -0
- package/src/lib/agents/router.ts +174 -2
- package/src/lib/agents/runtime/__tests__/catalog.test.ts +15 -4
- package/src/lib/agents/runtime/anthropic-direct.ts +644 -0
- package/src/lib/agents/runtime/catalog.ts +57 -2
- package/src/lib/agents/runtime/claude.ts +205 -1
- package/src/lib/agents/runtime/index.ts +22 -0
- package/src/lib/agents/runtime/ollama-adapter.ts +409 -0
- package/src/lib/agents/runtime/openai-direct.ts +514 -0
- package/src/lib/agents/runtime/profile-assist-types.ts +30 -0
- package/src/lib/agents/runtime/types.ts +2 -0
- package/src/lib/agents/tool-permissions.ts +203 -0
- package/src/lib/channels/gateway.ts +321 -0
- package/src/lib/channels/poller.ts +268 -0
- package/src/lib/channels/registry.ts +90 -0
- package/src/lib/channels/slack-adapter.ts +188 -0
- package/src/lib/channels/telegram-adapter.ts +218 -0
- package/src/lib/channels/types.ts +43 -0
- package/src/lib/channels/webhook-adapter.ts +74 -0
- package/src/lib/chat/command-data.ts +50 -0
- package/src/lib/chat/context-builder.ts +147 -3
- package/src/lib/chat/engine.ts +182 -19
- package/src/lib/chat/ollama-engine.ts +198 -0
- package/src/lib/chat/slash-commands.ts +191 -0
- package/src/lib/chat/stagent-tools.ts +106 -20
- package/src/lib/chat/tool-catalog.ts +209 -0
- package/src/lib/chat/tool-registry.ts +90 -0
- package/src/lib/chat/tools/chat-history-tools.ts +4 -4
- package/src/lib/chat/tools/document-tools.ts +43 -6
- package/src/lib/chat/tools/handoff-tools.ts +70 -0
- package/src/lib/chat/tools/notification-tools.ts +4 -4
- package/src/lib/chat/tools/profile-tools.ts +3 -3
- package/src/lib/chat/tools/project-tools.ts +3 -3
- package/src/lib/chat/tools/schedule-tools.ts +29 -13
- package/src/lib/chat/tools/settings-tools.ts +2 -2
- package/src/lib/chat/tools/task-tools.ts +66 -11
- package/src/lib/chat/tools/usage-tools.ts +2 -2
- package/src/lib/chat/tools/workflow-tools.ts +8 -8
- package/src/lib/chat/types.ts +22 -6
- package/src/lib/constants/known-tools.ts +19 -0
- package/src/lib/constants/prose-styles.ts +1 -1
- package/src/lib/constants/settings.ts +11 -0
- package/src/lib/data/channel-bindings.ts +85 -0
- package/src/lib/data/clear.ts +38 -4
- package/src/lib/data/profile-test-results.ts +48 -0
- package/src/lib/data/seed-data/conversations.ts +196 -0
- package/src/lib/data/seed-data/learned-context.ts +99 -0
- package/src/lib/data/seed-data/notifications.ts +54 -1
- package/src/lib/data/seed-data/profile-test-results.ts +96 -0
- package/src/lib/data/seed-data/repo-imports.ts +51 -0
- package/src/lib/data/seed-data/views.ts +60 -0
- package/src/lib/data/seed.ts +51 -0
- package/src/lib/db/bootstrap.ts +167 -0
- package/src/lib/db/migrations/0012_add_screenshot_columns.sql +5 -0
- package/src/lib/db/migrations/0013_add_repo_imports.sql +15 -0
- package/src/lib/db/migrations/0014_add_linked_profile_id.sql +3 -0
- package/src/lib/db/migrations/0015_add_channel_bindings.sql +23 -0
- package/src/lib/db/schema.ts +192 -1
- package/src/lib/environment/__tests__/auto-scan.test.ts +86 -0
- package/src/lib/environment/__tests__/profile-linker.test.ts +187 -0
- package/src/lib/environment/auto-scan.ts +48 -0
- package/src/lib/environment/data.ts +25 -0
- package/src/lib/environment/profile-generator.ts +40 -10
- package/src/lib/environment/profile-linker.ts +143 -0
- package/src/lib/environment/profile-rules.ts +96 -0
- package/src/lib/import/dedup.ts +149 -0
- package/src/lib/import/format-adapter.ts +631 -0
- package/src/lib/import/github-api.ts +219 -0
- package/src/lib/import/repo-scanner.ts +251 -0
- package/src/lib/schedules/__tests__/nlp-parser.test.ts +330 -0
- package/src/lib/schedules/active-hours.ts +120 -0
- package/src/lib/schedules/heartbeat-parser.ts +224 -0
- package/src/lib/schedules/heartbeat-prompt.ts +153 -0
- package/src/lib/schedules/nlp-parser.ts +357 -0
- package/src/lib/schedules/scheduler.ts +218 -3
- package/src/lib/screenshots/__tests__/persist.test.ts +104 -0
- package/src/lib/screenshots/persist.ts +114 -0
- package/src/lib/settings/__tests__/budget-guardrails.test.ts +39 -1
- package/src/lib/settings/helpers.ts +6 -0
- package/src/lib/settings/routing.ts +24 -0
- package/src/lib/settings/runtime-setup.ts +28 -1
- package/src/lib/usage/ledger.ts +2 -1
- package/src/lib/utils/stagent-paths.ts +4 -0
- package/src/lib/validators/__tests__/settings.test.ts +9 -0
- package/src/lib/validators/profile.ts +39 -0
- package/src/lib/workflows/blueprints/builtins/business-daily-briefing.yaml +102 -0
- package/src/lib/workflows/blueprints/builtins/content-marketing-pipeline.yaml +90 -0
- package/src/lib/workflows/blueprints/builtins/customer-support-triage.yaml +107 -0
- package/src/lib/workflows/blueprints/builtins/financial-reporting.yaml +104 -0
- package/src/lib/workflows/blueprints/builtins/lead-research-pipeline.yaml +82 -0
|
@@ -4,245 +4,201 @@ category: "user-journey"
|
|
|
4
4
|
persona: "power-user"
|
|
5
5
|
difficulty: "advanced"
|
|
6
6
|
estimatedTime: "30 minutes"
|
|
7
|
-
sections: ["dashboard-kanban", "profiles", "chat", "workflows", "schedules", "monitoring"]
|
|
8
|
-
tags: ["advanced", "automation", "workflows", "profiles", "schedules", "monitoring", "bulk-operations"]
|
|
9
|
-
lastUpdated: "2026-03-
|
|
7
|
+
sections: ["dashboard-kanban", "profiles", "chat", "workflows", "schedules", "monitoring", "settings"]
|
|
8
|
+
tags: ["advanced", "automation", "workflows", "profiles", "schedules", "monitoring", "bulk-operations", "ollama", "episodic-memory", "nlp-scheduling"]
|
|
9
|
+
lastUpdated: "2026-03-31"
|
|
10
10
|
---
|
|
11
11
|
|
|
12
12
|
# Power User Guide
|
|
13
13
|
|
|
14
|
-
Meet Sam, a DevOps engineer who automates everything that can be automated
|
|
14
|
+
Meet Sam, a DevOps engineer who automates everything that can be automated. Sam has already completed the Personal Use Guide and runs Stagent daily as an AI business operating system. Now Sam is ready to go deeper: specialized agent profiles, multi-step workflow pipelines, NLP-driven scheduling, Ollama local models, episodic memory, bulk operations, and real-time monitoring. This guide covers the advanced automation layer that puts entire business processes on autopilot.
|
|
15
15
|
|
|
16
16
|
## Prerequisites
|
|
17
17
|
|
|
18
18
|
- Stagent installed and running locally (`npm run dev`)
|
|
19
19
|
- An Anthropic API key configured in `.env.local`
|
|
20
|
-
- Familiarity with basic Stagent concepts (
|
|
20
|
+
- Familiarity with basic Stagent concepts (see [Personal Use Guide](./personal-use.md))
|
|
21
21
|
- At least one project with several completed tasks (agents learn from past context)
|
|
22
22
|
|
|
23
23
|
## Journey Steps
|
|
24
24
|
|
|
25
25
|
### Step 1: Master Keyboard Navigation
|
|
26
26
|
|
|
27
|
-
Sam refuses to reach for the mouse when a keystroke will do. The Command Palette is the nerve center of keyboard-driven navigation
|
|
27
|
+
Sam refuses to reach for the mouse when a keystroke will do. The Command Palette is the nerve center of keyboard-driven navigation.
|
|
28
28
|
|
|
29
29
|

|
|
30
30
|
|
|
31
|
-
1. Press **Cmd+K**
|
|
32
|
-
2. Without typing anything, scan the **recent items** and **suggested actions**
|
|
33
|
-
3. Type a partial name
|
|
34
|
-
4. Use **arrow keys** to highlight an item and press **Enter** to navigate or execute
|
|
35
|
-
5. Press **Escape** to dismiss the palette and return focus to the current page
|
|
31
|
+
1. Press **Cmd+K** to open the Command Palette
|
|
32
|
+
2. Without typing anything, scan the **recent items** and **suggested actions**
|
|
33
|
+
3. Type a partial name to filter across projects, tasks, workflows, schedules, and pages
|
|
34
|
+
4. Use **arrow keys** to highlight an item and press **Enter** to navigate or execute
|
|
36
35
|
|
|
37
|
-
> **Tip:**
|
|
36
|
+
> **Tip:** Power users open the palette dozens of times per session -- muscle memory for Cmd+K pays for itself on day one.
|
|
38
37
|
|
|
39
38
|
### Step 2: Explore Agent Profiles
|
|
40
39
|
|
|
41
|
-
Before building any automation, Sam reviews the available agent profiles.
|
|
40
|
+
Before building any automation, Sam reviews the available agent profiles. The catalog now includes business-function profiles alongside technical ones.
|
|
42
41
|
|
|
43
|
-

|
|
44
43
|
|
|
45
|
-
1.
|
|
46
|
-
2. Browse
|
|
47
|
-
3. Switch between
|
|
48
|
-
4. Note the
|
|
49
|
-
- **General** -- balanced, all-purpose agent behavior
|
|
50
|
-
- **Code Reviewer** -- focused on code quality, security, and best practices
|
|
51
|
-
- **Researcher** -- optimized for information gathering and synthesis
|
|
52
|
-
- **Document Writer** -- tuned for long-form content generation
|
|
44
|
+
1. Click **Profiles** in the sidebar under the **Manage** group
|
|
45
|
+
2. Browse profile cards -- each displays the name, description, runtime badges, and capabilities
|
|
46
|
+
3. Switch between **Work** and **Personal** tabs
|
|
47
|
+
4. Note the business-function profiles: Marketing Strategist, Sales Researcher, Customer Support Agent, Financial Analyst, Content Creator, and Operations Coordinator
|
|
53
48
|
5. Click any profile card to open its full detail page
|
|
54
49
|
|
|
55
|
-
> **Tip:** Think of profiles
|
|
50
|
+
> **Tip:** Think of profiles as IAM roles -- purpose-fit and least privilege. A Financial Analyst profile produces structured reports with proper methodology; the General profile produces softer summaries.
|
|
56
51
|
|
|
57
52
|
### Step 3: Deep-Dive into Profile Configuration
|
|
58
53
|
|
|
59
|
-
Sam opens a profile detail page to understand exactly what an agent will do when assigned this profile. The detail view exposes the system prompt, tool permissions, and capability badges that govern agent behavior.
|
|
60
|
-
|
|
61
54
|

|
|
62
55
|
|
|
63
|
-
1.
|
|
64
|
-
2. Read the **system prompt** section
|
|
65
|
-
3. Review the **capabilities** list
|
|
66
|
-
4. Check
|
|
67
|
-
5.
|
|
68
|
-
|
|
69
|
-
> **Tip:** When a workflow step produces unexpected output, the profile detail page is the first place to investigate. Nine times out of ten, the system prompt or tool permissions explain the behavior. Small prompt refinements compound across every execution.
|
|
56
|
+
1. Click a profile card to open the detail page
|
|
57
|
+
2. Read the **system prompt** section
|
|
58
|
+
3. Review the **capabilities** list and **tool permissions**
|
|
59
|
+
4. Check runtime compatibility badges to see which providers the profile supports
|
|
60
|
+
5. Note that profiles work across all five runtimes (Claude SDK, Codex, Anthropic Direct, OpenAI Direct, Ollama)
|
|
70
61
|
|
|
71
|
-
### Step 4:
|
|
62
|
+
### Step 4: Connect Ollama for Local Models
|
|
72
63
|
|
|
73
|
-
Sam
|
|
74
|
-
|
|
75
|
-

|
|
64
|
+
Sam wants to run privacy-sensitive tasks on local models with zero API cost.
|
|
76
65
|
|
|
77
|
-
|
|
78
|
-
2. Click the **model selector** in the input composer area to reveal the dropdown
|
|
79
|
-
3. Review the available models -- each displays a **cost tier indicator** ($ to $$$) alongside the model name
|
|
80
|
-
4. Select **Haiku ($)** for quick factual queries like "list my active schedules" or "how many tasks failed this week"
|
|
81
|
-
5. Switch to **Opus ($$$)** for multi-step reasoning like "analyze the error patterns across my last 10 workflow runs and suggest architectural fixes"
|
|
82
|
-
6. Notice the cost tier badge update as you switch between models
|
|
66
|
+

|
|
83
67
|
|
|
84
|
-
|
|
68
|
+
1. Install Ollama from [ollama.com](https://ollama.com) and pull a model: `ollama pull llama3`
|
|
69
|
+
2. Open **Settings** and scroll to the **Ollama** section
|
|
70
|
+
3. Click **Test Connection** -- the status shows "Connected" with a list of available models
|
|
71
|
+
4. Once connected, Ollama models appear in runtime selectors across the workspace
|
|
85
72
|
|
|
86
|
-
|
|
73
|
+
> **Tip:** Ollama executions are tracked at $0 in the cost dashboard. Sam uses Ollama for routine tasks (code formatting, simple summaries) and reserves Claude or GPT for complex reasoning. This habit cuts monthly spend significantly.
|
|
87
74
|
|
|
88
|
-
|
|
75
|
+
### Step 5: Optimize Chat with Model Selection
|
|
89
76
|
|
|
90
|
-

|
|
91
78
|
|
|
92
|
-
1.
|
|
93
|
-
2.
|
|
94
|
-
3.
|
|
95
|
-
4.
|
|
96
|
-
5.
|
|
79
|
+
1. Navigate to **Chat** and click the **model selector** in the input area
|
|
80
|
+
2. Review models with cost tier indicators ($ to $$$)
|
|
81
|
+
3. Select **Haiku ($)** for quick factual queries
|
|
82
|
+
4. Switch to **Opus ($$$)** for complex reasoning
|
|
83
|
+
5. If Ollama is connected, local models appear at $0
|
|
97
84
|
|
|
98
|
-
> **Tip:**
|
|
85
|
+
> **Tip:** Sam's rule of thumb: factual recall = Haiku, thinking = Opus, privacy-sensitive = Ollama. This habit reduces monthly chat spend by 80%.
|
|
99
86
|
|
|
100
|
-
### Step 6:
|
|
87
|
+
### Step 6: Use NLP Scheduling
|
|
101
88
|
|
|
102
|
-
Sam
|
|
89
|
+
Sam creates schedules by describing them in plain English instead of writing cron expressions.
|
|
103
90
|
|
|
104
|
-

|
|
105
92
|
|
|
106
|
-
1. Navigate to **
|
|
107
|
-
2.
|
|
108
|
-
3.
|
|
109
|
-
4.
|
|
110
|
-
5.
|
|
111
|
-
6.
|
|
93
|
+
1. Navigate to **Schedules** and click **Create Schedule**
|
|
94
|
+
2. In the interval field, type natural language: "every weekday at 10pm," "every 6 hours during business hours," or "twice daily at 9am and 5pm"
|
|
95
|
+
3. A **preview** appears showing exactly how the system parsed the input
|
|
96
|
+
4. Select **Heartbeat** type to add intelligence -- the agent evaluates a checklist before acting
|
|
97
|
+
5. Add checklist items specific to your automation needs
|
|
98
|
+
6. Save the schedule
|
|
112
99
|
|
|
113
|
-
> **Tip:**
|
|
100
|
+
> **Tip:** NLP scheduling removes the friction of cron syntax. If the preview does not match your intent, rephrase and it re-parses instantly.
|
|
114
101
|
|
|
115
102
|
### Step 7: Build a Multi-Step Workflow
|
|
116
103
|
|
|
117
|
-
Sam customizes a workflow for a "Deploy & Verify" pipeline
|
|
118
|
-
|
|
119
|
-

|
|
104
|
+
Sam customizes a workflow for a "Deploy & Verify" pipeline with specialized profiles at each step.
|
|
120
105
|
|
|
121
|
-
|
|
122
|
-
2. Enter a **Workflow Name** such as "Nightly Deploy & Verify"
|
|
123
|
-
3. Add a description explaining the pipeline's purpose
|
|
124
|
-
4. Configure **Step 1 -- Run Tests**: assign the **Code Reviewer** profile, set the prompt to "Run the full test suite and report failures with root cause analysis"
|
|
125
|
-
5. Configure **Step 2 -- Deploy to Staging**: assign the **General** profile, set dependency on Step 1
|
|
126
|
-
6. Configure **Step 3 -- Verify Deployment**: assign the **Researcher** profile, set dependency on Step 2, prompt it to "Check all critical endpoints and report status"
|
|
127
|
-
7. Save the workflow
|
|
106
|
+

|
|
128
107
|
|
|
129
|
-
|
|
108
|
+
1. From the Workflows page, click **Create Workflow** (or customize a blueprint)
|
|
109
|
+
2. Configure steps with different agent profiles at each stage
|
|
110
|
+
3. Use the business-function profiles for non-technical steps (e.g., Content Creator for documentation, Operations Coordinator for runbook updates)
|
|
111
|
+
4. Save the workflow
|
|
130
112
|
|
|
131
113
|
### Step 8: Inspect Workflow Execution
|
|
132
114
|
|
|
133
|
-
After triggering a run, Sam opens the workflow detail view to track step-by-step progress, inspect outputs, and diagnose any failures in the pipeline.
|
|
134
|
-
|
|
135
115
|

|
|
136
116
|
|
|
137
|
-
1. Click on a workflow
|
|
138
|
-
2. Review the **step sequence** and dependency chain
|
|
139
|
-
3. Check each step's **status indicator**
|
|
140
|
-
4. Click
|
|
141
|
-
5.
|
|
142
|
-
6. Use the **Run Workflow** button to trigger a new execution
|
|
143
|
-
|
|
144
|
-
> **Tip:** Independent steps (those without dependencies between them) execute concurrently. Sam designs workflows to maximize parallelism -- if two verification checks do not depend on each other, they run simultaneously and the pipeline finishes faster.
|
|
117
|
+
1. Click on a workflow to open the detail view
|
|
118
|
+
2. Review the **step sequence** and dependency chain
|
|
119
|
+
3. Check each step's **status indicator**
|
|
120
|
+
4. Click completed steps to read their full output
|
|
121
|
+
5. Use the **Run Workflow** button to trigger a new execution
|
|
145
122
|
|
|
146
123
|
### Step 9: Batch-Manage Tasks on the Kanban
|
|
147
124
|
|
|
148
|
-
Sam
|
|
125
|
+
Sam cleans up the task board using bulk select mode.
|
|
149
126
|
|
|
150
127
|

|
|
151
128
|
|
|
152
|
-
1. Navigate to the **Dashboard**
|
|
153
|
-
2. Click
|
|
154
|
-
3. Check
|
|
155
|
-
4. Use the
|
|
156
|
-
|
|
157
|
-
- **Move** selected tasks to a different status column
|
|
158
|
-
- **Delete** selected tasks that are no longer needed
|
|
159
|
-
5. Confirm the bulk action and exit select mode
|
|
129
|
+
1. Navigate to the **Dashboard** kanban board
|
|
130
|
+
2. Click **Select** to enter bulk select mode
|
|
131
|
+
3. Check boxes on multiple task cards across columns
|
|
132
|
+
4. Use the bulk action toolbar to queue, move, or delete selected tasks
|
|
133
|
+
5. Confirm and exit select mode
|
|
160
134
|
|
|
161
|
-
> **Tip:** After a weekend of autonomous
|
|
135
|
+
> **Tip:** After a weekend of autonomous heartbeat runs, Sam's first Monday task is always a bulk cleanup.
|
|
162
136
|
|
|
163
137
|
### Step 10: Schedule Automated Prompt Loops
|
|
164
138
|
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-

|
|
168
|
-
|
|
169
|
-
1. Navigate to **Schedules** in the sidebar under the **Manage** group
|
|
170
|
-
2. Click **Create Schedule**
|
|
171
|
-
3. Enter a **Name** such as "Nightly Deploy Pipeline"
|
|
172
|
-
4. Set the **Interval** using natural language: "every day at 10pm" or "every 6 hours"
|
|
173
|
-
5. Link the schedule to the **Nightly Deploy & Verify** workflow
|
|
174
|
-
6. Configure **stop conditions** to prevent runaway execution:
|
|
175
|
-
- **Max iterations**: 1 per trigger (each night = one full pipeline run)
|
|
176
|
-
- **Timeout**: 30 minutes per iteration
|
|
177
|
-
- **Failure threshold**: 1 (pause after first failure for investigation)
|
|
178
|
-
7. Enable the schedule and click **Create**
|
|
139
|
+

|
|
179
140
|
|
|
180
|
-
|
|
141
|
+
1. Click on a schedule to open its detail sheet
|
|
142
|
+
2. Review the **firing history** with timestamps and outcomes (including suppressed heartbeat runs)
|
|
143
|
+
3. Check the **next firing time**
|
|
144
|
+
4. Verify stop conditions and delivery channels
|
|
145
|
+
5. Toggle **Pause/Resume** as needed
|
|
181
146
|
|
|
182
|
-
### Step 11:
|
|
147
|
+
### Step 11: Leverage Episodic Memory
|
|
183
148
|
|
|
184
|
-
Sam
|
|
149
|
+
Sam notices agents are re-researching the same topics. Episodic memory lets agents retain factual knowledge across executions.
|
|
185
150
|
|
|
186
|
-

|
|
187
152
|
|
|
188
|
-
1.
|
|
189
|
-
2.
|
|
190
|
-
3.
|
|
191
|
-
4.
|
|
192
|
-
5.
|
|
193
|
-
6. Close the detail sheet to return to the schedules list
|
|
153
|
+
1. Run several tasks with the same profile on related topics
|
|
154
|
+
2. Open **Monitor** to observe that the agent extracted memory entries during execution
|
|
155
|
+
3. Memory entries persist -- the agent recalls facts from previous tasks in future executions
|
|
156
|
+
4. Memories have confidence scores that decay over time, keeping the context window focused on current knowledge
|
|
157
|
+
5. Visit the memory browser (accessible from the profile detail page) to inspect, edit, or delete stored memories
|
|
194
158
|
|
|
195
|
-
> **Tip:**
|
|
159
|
+
> **Tip:** Episodic memory means a Financial Analyst profile that researches a company once can recall that research in future tasks without re-doing the work. It builds institutional knowledge automatically.
|
|
196
160
|
|
|
197
161
|
### Step 12: Watch Agent Execution in Real-Time
|
|
198
162
|
|
|
199
|
-
|
|
163
|
+

|
|
200
164
|
|
|
201
|
-
|
|
165
|
+
1. Click **Monitor** in the sidebar
|
|
166
|
+
2. Review the execution log showing all recent agent activity
|
|
167
|
+
3. Filter by project, workflow, or agent profile
|
|
168
|
+
4. Click entries to expand full execution traces -- tool calls, outputs, token counts, timing
|
|
169
|
+
5. Watch for error patterns
|
|
202
170
|
|
|
203
|
-
|
|
204
|
-
2. Review the **execution log** showing all recent agent activity in reverse chronological order
|
|
205
|
-
3. Filter by **project**, **workflow**, or **agent profile** to focus on specific activity streams
|
|
206
|
-
4. Click on any log entry to expand the full execution trace -- tool calls, outputs, token counts, and timing
|
|
207
|
-
5. Watch for **error patterns** such as repeated failures on the same tool or profile
|
|
208
|
-
6. Use the monitor to verify that scheduled runs are completing within expected time bounds
|
|
209
|
-
|
|
210
|
-
> **Tip:** The Monitor is Sam's operational dashboard. When something goes wrong in an autonomous loop at 3am, the monitor's execution traces are the fastest path to diagnosis. Sam bookmarks this page and checks it first thing every morning.
|
|
171
|
+
> **Tip:** The Monitor is Sam's operational dashboard. When something goes wrong in an autonomous loop at 3am, the execution traces are the fastest path to diagnosis.
|
|
211
172
|
|
|
212
173
|
### Step 13: Use Chat Suggested Prompts
|
|
213
174
|
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-

|
|
217
|
-
|
|
218
|
-
1. Navigate to **Chat** (or open a new conversation)
|
|
219
|
-
2. Below the input composer, notice the **suggested prompt tabs** -- categories like Create, Analyze, Manage, and more
|
|
220
|
-
3. Click the **Create** tab to see prompts related to creating new entities (tasks, workflows, schedules)
|
|
221
|
-
4. Click a suggested prompt to populate the input composer with pre-written text
|
|
222
|
-
5. Edit the prompt to match your specific needs, then send it
|
|
223
|
-
6. Try other tabs to discover prompts for analysis, troubleshooting, and status checks
|
|
175
|
+

|
|
224
176
|
|
|
225
|
-
|
|
177
|
+
1. Navigate to **Chat** and notice the **suggested prompt tabs** (Explore, Create, Debug, Automate)
|
|
178
|
+
2. Click the **Create** tab to see prompts for creating tasks, workflows, and schedules
|
|
179
|
+
3. Click a suggested prompt to populate the input
|
|
180
|
+
4. Edit and send -- these prompts are optimized for the best agent responses
|
|
226
181
|
|
|
227
|
-
### Step 14: Chain
|
|
182
|
+
### Step 14: Chain Everything Together
|
|
228
183
|
|
|
229
|
-
Sam connects the dots: workflows define *what
|
|
184
|
+
Sam connects the dots: profiles define *how*, workflows define *what*, schedules define *when*, Ollama handles the *cheap stuff*, episodic memory provides the *knowledge*, and delivery channels deliver the *results*.
|
|
230
185
|
|
|
231
186
|

|
|
232
187
|
|
|
233
|
-
1. Review
|
|
234
|
-
2.
|
|
235
|
-
3. Assign
|
|
236
|
-
4.
|
|
237
|
-
5.
|
|
238
|
-
6.
|
|
188
|
+
1. Review workflows and identify which should run on a schedule
|
|
189
|
+
2. Create heartbeat schedules with appropriate checklists
|
|
190
|
+
3. Assign business-function profiles to each step
|
|
191
|
+
4. Route privacy-sensitive steps to Ollama, complex reasoning to Claude
|
|
192
|
+
5. Attach Slack or Telegram channels for delivery
|
|
193
|
+
6. Enable episodic memory for profiles that handle recurring topics
|
|
194
|
+
7. Set up the Monitor as your oversight layer
|
|
239
195
|
|
|
240
|
-
> **Tip:** Sam's automation philosophy: start small, observe, then expand. Run a workflow manually three times before scheduling it.
|
|
196
|
+
> **Tip:** Sam's automation philosophy: start small, observe, then expand. Run a workflow manually three times before scheduling it. Trust builds incrementally -- and so should autonomy.
|
|
241
197
|
|
|
242
198
|
### Step 15: What's Next
|
|
243
199
|
|
|
244
|
-
Sam's
|
|
200
|
+
Sam's workspace is a fully autonomous operations engine. The next step is going deeper into the platform layer.
|
|
245
201
|
|
|
246
|
-
- [Developer Guide](./developer.md) -- Configure authentication
|
|
202
|
+
- [Developer Guide](./developer.md) -- Configure authentication, runtime settings, channel gateway architecture, and CLI tooling
|
|
247
203
|
- [Work Use Guide](./work-use.md) -- Explore team collaboration features, document management, and cost governance
|
|
248
|
-
- [Personal Use Guide](./personal-use.md) -- Review the basics if you need a refresher
|
|
204
|
+
- [Personal Use Guide](./personal-use.md) -- Review the basics if you need a refresher
|