fimo 2.7.1-staging.4 → 2.8.0-staging.1

package/assets/skills/fimo-studio/references/agents.md

@@ -1,8 +1,22 @@
 # Agents
 
-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.
+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.
 
-## Open an agent
+## Enable a library agent
+
+1. Open **Agents → Agents → Add agent**.
+2. Choose a library agent and review its project access, connections, and requested secret keys.
+3. Select **Accept and enable**. This enables the agent without starting a run.
+
+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.
+
+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.
+
+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.
+
+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.
+
+## Open a Git agent
 
 1. Open the project and choose **Agents**.
 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
 
 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.
 
-## Run, stop, or resume
+## Run, stop, or resume a Git agent
 
 Choose **Run** to start an agent whose manual trigger is live.
 
@@ -22,7 +36,7 @@ A stopped agent shows **Paused** in the header. **Resume** makes the same trigge
 
 Only project managers see Run, Stop, and Resume. Other project members can still see schedule timing, status, settings, and run history.
 
-## Delete an agent
+## Delete a Git agent
 
 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.
 
@@ -30,4 +44,4 @@ If a run cannot be stopped or `main` changes before deletion commits, the defini
 
 ## Inspect runs
 
-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.
+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.

package/dist/cli/bundle.json

@@ -1,7 +1,7 @@
 {
   "bundled": true,
   "bundler": "esbuild",
-  "bundledAt": "2026-09-28T12:09:42.498Z",
+  "bundledAt": "2026-09-29T11:16:17.964Z",
   "cliVersion": "2.7.1",
   "external": [
     "oxc-parser",