Deletion

Deletion removes the selected entity and resolves its structural references: dependent entities may be deleted, while removable references are erased from surviving entities. The editor computes these changes before applying them.

VS Code opens a deletion review before changing the project. The review groups the result into:

Section	Meaning
Selected subtree	The selected entity and definitions contained by it.
Also deleted	Dependent entities that cannot remain without the selection.
Will be updated	Surviving entities whose reference to the selection is removed.
Imports to clean up	Pinned projects made unused by this deletion.

Canceling the review leaves the project unchanged. Rebind a dependent entity before deletion if it must be retained. The review covers references in project.json; it does not repair arbitrary imports or references in authored Python.

Reference effects

Deleted entity	What else changes
Feature	Conditions and effects that observe it are removed from every edge. The edges remain.
Subroutine-local profile or session	Agent nodes selecting it and Subroutine call nodes passing it as a child resource are deleted, together with their attached edges and visits.
Workflow profile or session	Deletion is refused while an entry binding uses it. Rebind the entry parameter before deleting the resource.
Profile or session parameter	The corresponding argument is removed from Subroutine calls and workflow entry bindings; those callers remain. Agent nodes selecting the parameter and Subroutine call nodes passing it onward are deleted, together with their attached edges and visits.
Node	Every attached edge is deleted, together with its visit below an executable target. Enter, exit, and failure ports cannot be deleted.
Edge	Its generated ◆ edges/<edge-id>/__init__.py is removed and the edge registry is regenerated. When the target is executable, its visit below that node is also deleted, including the authored ● impl.py.
Subroutine	Its nested definition tree is deleted. Workflows outside that tree that wrap a removed subroutine are also deleted, followed by call nodes targeting removed definitions and those nodes' attached edges and visits. Selecting the root main subroutine resets it instead of removing its identity.
Workflow	Every Workflow call node targeting it is deleted, together with the node's attached edges and visits. Deleting a local workflow preserves the subroutine it wraps. The root main workflow cannot be deleted.

A root reset replaces main with enter, exit, and failure ports and an enter-to-exit edge. It removes the former graph's authored files, nested definitions, and resources, and clears the root workflow's profiles, sessions, and entry bindings. The project and root workflow identities remain.

Files and imported projects

The editor moves selected authored files and entity directories to the operating system's trash. Generated files are omitted from the review; generation removes obsolete paths and recreates declarations required by the updated graph.

If the deletion removes the final use of a pinned project, the review also lists that import. Confirming the cleanup removes the newly unused pin after applying the graph edit. A modified pinned checkout may prevent this cleanup, in which case the pin remains available for a subsequent attempt. Pins that were already unused are excluded from an unrelated deletion.

A deleted identifier becomes available again immediately. Existing projects pinned to an earlier commit are unaffected because their graph and code remain fixed at that commit.