environments

Take another environment into the conversation when the chosen one cannot do a step, and ask for sub-agents.

• Layer: base (optional: only where a configuration enables it)
• Needs: –
• Requires: –
• Conflicts with: –
• Never dropped: no
• Mixin: skills.environments:Environments
• Manifest: skills/environments/skill.toml

Functions

use_environment

def use_environment(kind, why, folder=None)

Take another environment into this conversation: kind is one the user’s installation has (“project”, “browser”, “desktop”, “apps”, “display”), why one sentence the user reads when they are asked. A project needs folder. Returns the environment, whose calls are then kind.call(…); raises ValueError with the reason when the user or their settings refuse. None when the user paused first.

release_environment

def release_environment(kind)

Give an environment taken with use_environment back. True when it was attached.

request_agents

def request_agents(why)

Ask the user to switch sub-agents on for this conversation (why: one sentence they read). True once they are on (delegate, wait_agents, send_agent and cancel_agent are then calls of this conversation); ValueError with the reason when refused.

What the model reads

From the workspace prompt pack, with the core skills enabled:

  use_environment(kind, why, folder=None)   take "project" (files and commands in one
                                    folder: give folder), "browser" (an isolated background
                                    browser), "desktop" (the user's screen), "apps" or
                                    "display" into this conversation. why: one sentence the
                                    user reads if they are asked. Its calls are then
                                    kind.NAME(...), described once it is attached. A refusal
                                    raises ValueError with the reason: go on without it and
                                    say in your answer what you could not confirm.
  release_environment(kind)         give it back when the step is done