Repository navigation
v0.49.1
Stageflow v0.49.1
Release notes for versions since v0.46.0.
0.49.1
Fixes
- Hosted provider login no longer stops on a localhost page. When the console is reached by a public hostname (
STAGEFLOW_ALLOWED_HOSTS) or listens outside loopback (STAGEFLOW_BIND), Codex sign-in uses device code and skips the browser-or-device choice. If device code is not enabled, browser sign-in continues, and the paste field explains that a localhost error page is expected. When the provider also accepts an API key, the panel says it can be added in Settings, Providers.
0.49.0
Features
- Stage independence modes.
independenceisstrict,persistent, oropen. Omitted meanspersistent: after a turn with no envelope the stage keeps working, up to twenty quiet reminders, and a tool call resets that count.strictkeeps the previous short budget, including its offer to emit failure.openadds permission to try another approach with the tools and inputs already given, and does not add tools or loadAGENTS.md. Set it on the stage, the pipeline, or the manifest; the stage wins. A fragment's copy is ignored. See YAML catalog. - Checkout
AGENTS.mdopt-in.checkout_context: trueon the stage body loads that checkout'sAGENTS.mdas extra context. The stage assignment wins where they conflict. The author'ssystem_promptis not rewritten. A stage with no checkout fails prepare (stage.checkout_context_unbound). A missing file does not fail the stage. A symlink or hard link is not read. - Built-in
grep,find, andls. Inside a sandbox those tools see/workspaceand, when one is mounted, the read-only folder. Outside a sandbox they search the stage working tree. A host path, a~path, a..escape, and a symlink used as the search path are rejected. Search skips.gitandnode_modules.
Changes
- Default independence is persistent. A stage that does not set
independencekeeps working; the old short reminder budget is nowindependence: strict. - Compaction for persistent or open stages records the next approach. A summary written at one level is not reused at another. Compaction stays on.
- Eval snapshots record the effective independence and
checkout_context. Agent eval fingerprints omit both, so they stay comparable.
0.48.0
Features
- Customer identity for protected agent chat. A Host can admit a business's own customers with a signed handoff or OIDC Authorization Code and PKCE, map them to accounts, and authorize order reads. Consumers stay separate from Workspace owners. Admission stays opt-in:
sf uileaves it off until the Host manages identity or an embedder passesconsumerAuthorization. See Consumer identity. - Turn identity on from the console. On a Host that manages identity itself, Turn on identity creates the Workspace store under
$STAGEFLOW_HOME/identity/, starts with the built-in access rules, and needs no restart. Setup covers the order API (write-only credential, Host-generated ES256 signing key, ownership contract test) and the authorization engine (built-in rules or a Workspace-local Cerbos server, with a test that rejects unreachable servers and allow-all policies). An embedder-supplied authorization wins and makes setup read-only (identity.managed_externally). - Identity console. Connections, People & access, Check access, Activity and Setup as guided tabs, with drawers and dialogs for handoff/OIDC go-live, grants, and preview. Secrets and order contents never appear in the UI.
- Identity documentation. Protect an agent's chat with customer sign-in, Console: Identity, and an Order API contract, plus operator API, glossary, data-directory and environment entries.
Changes
- Consumer identity host port. Operator routes and agent chat talk to
ConsumerAuthorizationonly; admission returns a bearer token with expiry in one step, and the identity store stays internal to the identity module.
Fixes
- Granting access again to a person who was revoked now works. Saving their access reactivates it with a new revision; their old sessions stay invalid.
- Rebinding a protected conversation no longer fails when the Access Grant changes.
bindupdates the existing row; expired consumer sessions are removed when a new session is established.
0.47.0
Features
- Log in once in your own Chrome, then run headless.
browser.host: attachdrives the operator's Chrome over CDP (browser.attach.cdp_url); it never launches or closes it. Withbrowser.login_host: attach, a login stage opens in your Chrome, the Host copies the session into its own browser and probes it with the stage'scheck. A site that rejects the copy pins the profile to your Chrome (host-hint.json, orbrowser.profile_hosts). See Browser sessions. - Blocked sites escalate instead of failing. A stage that reports
site blocked this browser:pins its profile to your Chrome and retries once in the same run. - Saved browser logins in the console, CLI and API. Connections shows each login with its sites, last login and last check, and offers Delete, Switch back, Check now and Log in again. New:
GET/DELETE /api/browser/profiles…,…/pin,…/check,…/login,…/login/finish, andsf browser unpin;sf browser profileslists more fields. - Live browser in the redesigned gate with a window frame and back, forward and reload (
POST …/live-view/navigate). - Docs and agent guidance cover the login handoff and which sites suit it: browser docs, the browser and
stageflow-authorskills, and the Guide's built-in knowledge. Seeexamples/browser-login-handoff/.