fimo 2.7.1 → 2.8.0-staging.1

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.
@@ -29,27 +29,27 @@ Use plain, friendly language. Describe what users see, where they click, and wha
29
29
 
30
30
  Read the relevant reference file when the user's question matches a topic.
31
31
 
32
- | Topic | Reference | When to read |
33
- | ------------------------ | --------------------------------------- | ----------------------------------------------------- |
34
- | Command Palette | references/command-palette.md | "What can I open with Cmd+K?", "Quick actions" |
35
- | Publish & Deploy | references/publish-and-deploy.md | "How do I publish?", "How do I make my site live?" |
36
- | Custom Domains | references/custom-domains.md | "How do I use my own domain?", "DNS setup" |
37
- | Content Management (CMS) | references/cms.md | "How does the CMS work?", "How do I add blog posts?" |
38
- | Media Library | references/media-library.md | "How do I upload images?", "Where are my files?" |
39
- | AI Chat | references/ai-chat.md | "What can the AI do?", "How do I give context?" |
40
- | Code Editor | references/code-editor.md | "How do I edit code?", "Where are my files?" |
41
- | SEO Settings | references/seo-settings.md | "How do I set up SEO?", "Favicon, title, share image" |
42
- | Agents | references/agents.md | "Run an agent", "Pause an agent", "Next agent run" |
43
- | Schedules | references/schedules.md | "Recurring commands", "Run history", "Run now" |
44
- | Webhooks | references/webhooks.md | "React to forms", "Send events to another service" |
45
- | Connections | references/connections.md | "Connect a service", "Add an MCP server" |
46
- | Preview & Responsive | references/preview-and-responsive.md | "How does it look on mobile?", "How do I test sizes?" |
47
- | Visual Editing | references/visual-editing.md | "Can I edit visually?", "How do I change colors?" |
48
- | Version History | references/version-history.md | "How do I undo?", "How do I go back?" |
49
- | Sharing & Collaboration | references/sharing-and-collaboration.md | "How do I share?", "How do I invite someone?" |
50
- | Project Creation | references/project-creation.md | "How do I start a new project?" |
51
- | Billing & Credits | references/billing-and-credits.md | "What are credits?", "How do I upgrade?" |
52
- | Drawing & Wireframing | references/drawing-and-wireframing.md | "How do I sketch my idea?" |
32
+ | Topic | Reference | When to read |
33
+ | ------------------------ | --------------------------------------- | ------------------------------------------------------------------ |
34
+ | Command Palette | references/command-palette.md | "What can I open with Cmd+K?", "Quick actions" |
35
+ | Publish & Deploy | references/publish-and-deploy.md | "How do I publish?", "How do I make my site live?" |
36
+ | Custom Domains | references/custom-domains.md | "How do I use my own domain?", "DNS setup" |
37
+ | Content Management (CMS) | references/cms.md | "How does the CMS work?", "How do I add blog posts?" |
38
+ | Media Library | references/media-library.md | "How do I upload images?", "Where are my files?" |
39
+ | AI Chat | references/ai-chat.md | "What can the AI do?", "How do I give context?" |
40
+ | Code Editor | references/code-editor.md | "How do I edit code?", "Where are my files?" |
41
+ | SEO Settings | references/seo-settings.md | "How do I set up SEO?", "Favicon, title, share image" |
42
+ | Agents | references/agents.md | "Run an agent", "Pause an agent", "Next agent run" |
43
+ | Schedules | references/schedules.md | "Recurring commands", "Run history", "Run now" |
44
+ | Webhooks | references/webhooks.md | "React to forms", "Send events to another service" |
45
+ | Connections | references/connections.md | "Connect a service", "Add an MCP server" |
46
+ | Preview & Responsive | references/preview-and-responsive.md | "How does it look on mobile?", "How do I test sizes?" |
47
+ | Visual Editing | references/visual-editing.md | "Can I edit visually?", "How do I change colors?" |
48
+ | Version History | references/version-history.md | "How do I undo?", "How do I go back?" |
49
+ | Sharing & Collaboration | references/sharing-and-collaboration.md | "How do I share?", "How do I invite someone?" |
50
+ | Project Creation | references/project-creation.md | "How do I start a new project?" |
51
+ | Billing & Credits | references/billing-and-credits.md | "What are credits?", "How do I upgrade?", "How do referrals work?" |
52
+ | Drawing & Wireframing | references/drawing-and-wireframing.md | "How do I sketch my idea?" |
53
53
 
54
54
  ## Cross-feature references
55
55
 
@@ -1,8 +1,22 @@
1
1
  # Agents
2
2
 
3
- Project agents are versioned bundles from the project's repository. Studio lets project members inspect their configuration and run history, while project managers can start, stop, resume, and delete them.
3
+ Project agents come from either the Fimo-managed library or the project's Git repository. Both use the same run history and change review. Check the selected agent's source before editing settings: library behavior is managed by Fimo; Git bundle behavior is edited in the repository.
4
4
 
5
- ## Open an agent
5
+ ## Enable a library agent
6
+
7
+ 1. Open **Agents → Agents → Add agent**.
8
+ 2. Choose a library agent and review its project access, connections, and requested secret keys.
9
+ 3. Select **Accept and enable**. This enables the agent without starting a run.
10
+
11
+ Library instructions, examples, tone, and runtime configuration are shared. Do not create a local bundle or edit project files to customize a library agent. Project managers configure its schedules under **Settings** using Daily, Weekly, or Advanced cron and an explicit timezone. Schedules can be edited, paused, retried after wiring errors, and deleted. A saved schedule cannot run while the agent is blocked or disabled. Library webhook triggers are unavailable.
12
+
13
+ If a library edit expands access, **Review permissions** opens the new requirements. Only a project manager can accept them; do not approve access on the user's behalf through a tool or API. **Accept changes** keeps a disabled agent disabled. **Needs setup** links to project settings for missing connections or secrets.
14
+
15
+ Choose **Disable agent** to block new runs and cancel queued or active work. **Stopping** persists until cancellation settles; **Retry** retries incomplete stopping. Reports and captured changes remain reviewable. **Enable agent** resumes future scheduled ticks after current permissions and setup are satisfied; missed ticks are not replayed.
16
+
17
+ When Studio context identifies `definition_source: library`, address it with `activation_id`. `agent_display_name` is a label, not a Git bundle path or unique identifier. `view` identifies whether the user is reading Runs or Settings. Use the shared run detail when `run_id` is provided.
18
+
19
+ ## Open a Git agent
6
20
 
7
21
  1. Open the project and choose **Agents**.
8
22
  2. Select **Agents** again to see the available bundles.
@@ -12,7 +26,7 @@ On a user Branch, the list also shows new bundles that exist only on that Branch
12
26
 
13
27
  When the agent has a live schedule, its next run appears first in **Runs**, marked **Scheduled**. The row uses **Next** for its projected ID, a relative date such as **Tomorrow at 11:00 AM**, and **—** for changes and duration until it starts. **Settings** shows the bundle's declared capabilities and trigger wiring; it is read-only because the repository remains the source of truth.
14
28
 
15
- ## Run, stop, or resume
29
+ ## Run, stop, or resume a Git agent
16
30
 
17
31
  Choose **Run** to start an agent whose manual trigger is live.
18
32
 
@@ -22,7 +36,7 @@ A stopped agent shows **Paused** in the header. **Resume** makes the same trigge
22
36
 
23
37
  Only project managers see Run, Stop, and Resume. Other project members can still see schedule timing, status, settings, and run history.
24
38
 
25
- ## Delete an agent
39
+ ## Delete a Git agent
26
40
 
27
41
  Project managers can open **Agent actions** beside Run/Stop, choose **Delete agent**, and confirm. Deletion stops planned or running work and commits removal of the agent bundle from `main`. Recorded runs remain in history. Remove the bundle from a local checkout before deploying again, or that deployment recreates the agent.
28
42
 
@@ -30,4 +44,4 @@ If a run cannot be stopped or `main` changes before deletion commits, the defini
30
44
 
31
45
  ## Inspect runs
32
46
 
33
- Open **Runs** on an agent to see only that bundle's history. Select a run to read its status, report, captured changes, and any question or review state that needs attention.
47
+ Open **Runs** on an agent to see only that agent's history. Select a run to read its status, report, captured changes, and any question or review state that needs attention.
@@ -17,6 +17,16 @@ Look for the **coin icon with a number** near the chat send button. That number
17
17
 
18
18
  From a linked project directory, `fimo credits` shows the same organization balance in the CLI. Its "Available now" total already includes the visible buckets.
19
19
 
20
+ ## Referral progress
21
+
22
+ Open **Earn free credits** from the project header (or the project menu on mobile), then use **Copy** inside the link field.
23
+
24
+ - **Signed up** counts people who registered through your link, including those who later published. Link visits do not count.
25
+ - **Published** counts people who published their first project, not the number of projects they publish.
26
+ - **AI credits earned** shows inviter rewards already credited to you. It excludes your own bonus for joining through someone else's link; a publication can appear before its reward is credited.
27
+
28
+ Each signup uses one of the five referral slots. Publishing unlocks the reward but does not reopen a slot. The dialog shows signups used and how many people have not published yet. **Terms and Conditions** opens the program terms; **Close** dismisses the dialog.
29
+
20
30
  ## Buying More Credits
21
31
 
22
32
  Buying credits is available while a paid plan is effective, including after scheduling its cancellation. Cancellation stops automatic spending immediately but keeps the current plan until renewal. A deliberate credit purchase still charges the payment method on file.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "bundled": true,
3
3
  "bundler": "esbuild",
4
- "bundledAt": "2026-09-16T13:43:08.740Z",
4
+ "bundledAt": "2026-09-29T11:16:17.964Z",
5
5
  "cliVersion": "2.7.1",
6
6
  "external": [
7
7
  "oxc-parser",