Browser-based graphical shell and control plane for a Linux server you own — real terminal, file manager, live metrics and BYOK AI in one mobile-first workspace. Next.js 16 · React 19 · node-pty · Tailwind v4 · shadcn/ui. Public alpha, self-hosted.
TypeScript browser-shellcontrol-planefile-managerhomelabmobile-firstnextjsptyreactself-hostedserver-managementshadcn-uisysadmintailwindcssterminaltypescriptvpsweb-desktopweb-terminal
docs(workflows): document proactive turns on durable sessions in workflow graphs
Abdurrahman Fakhrul8bd242bf489c
diff --git a/docs/AUTOMATION-FLOWS.md b/docs/AUTOMATION-FLOWS.mdindex 1dfd0ceb..7bf1a275 100644--- a/docs/AUTOMATION-FLOWS.md+++ b/docs/AUTOMATION-FLOWS.md@@ -91,7 +91,7 @@ Reusing a key with identical project/definition/input returns its existing receiis rejected. Receipts are private and checkpointed around each step. They are not an exactly-onceguarantee from external providers. A process interruption leaves an uncertain mutation:inspect the provider, then deliberately choose a new key if another attempt is appropriate.-There is no automatic external retry, background queue or automatic rollback.+There is no automatic external retry, background queue or automatic rollback; scheduled proactive agent turns execute via in-process workflow graph triggers bound to durable sessions.The runner currently remains in the MSO process; use existing managed jobs for standalone builds.## Add MCP, assets and canvasdiff --git a/docs/WORKFLOW-GRAPH.md b/docs/WORKFLOW-GRAPH.mdindex 5eec7f6f..c0d3d445 100644--- a/docs/WORKFLOW-GRAPH.md+++ b/docs/WORKFLOW-GRAPH.md@@ -41,6 +41,8 @@ Webhook endpoint:`responseMode=onReceived` returns a run id immediately. `responseMode=lastNode` waits for bounded execution and returns only the explicit output-node result. Active webhooks fail closed unless `authVariable` names a secret-marked string of at least 16 characters; unauthenticated lookup traffic is rate-limited before graph discovery and cannot consume the authenticated execution bucket.+Schedule triggers can drive proactive workflow graphs that target durable agent sessions via `agent` nodes configured with `sessionRef`, allowing always-on agent turn cycles without external cron or daemon processes.+### Flow control- `condition` — true/false handles@@ -62,7 +64,7 @@ Graph edges stay acyclic. Item fan-out uses `loop`; conditional loop-back uses `- `project_mcp`- `integration`- `script` — execute a saved, validated repo-local RASMIC automation manifest by `project + script_id`; the graph stores only the reference, while runtime re-validates the manifest before replay-- `agent`+- `agent` — execute an organization seat, a project agent, or target a durable agent session via `sessionRef` for proactive/scheduled agent turns with history and event audit persistence- `project`- `folder`- `skill`@@ -73,6 +75,8 @@ Project/folder nodes resolve the live canonical server path when the graph runsScript nodes intentionally do **not** execute arbitrary shell or browser-supplied JavaScript. The Inspector can search the selected project's `.agent/scripts` catalog, shows candidate/tested state and step count, and persists the chosen `script_id` in the graph. Execution delegates to `project_script_run`, which re-reads the manifest and refuses steps outside the bounded replay-safe RASMIC policy. A successful candidate replay is promoted to tested by the existing script runner.+Agent nodes configured with `sessionRef` bind turn execution directly to a same-owner durable session: the bounded turn runs via the local session agent seam, serializes via an at-most-one execution lease to avoid interleaving concurrent writes, appends an audit event, and updates the session's durable conversation history.+## Repeat Until and saved Session workflows`repeat` is the bounded equivalent of a normal `while` / `do...while` automation loop: