On this page

• CapabilityCommandSystem
  • CapabilityCommandSystem
    • CapabilityCommandSystem.get_links()
    • CapabilityCommandSystem.get_conduit_cloud()
    • CapabilityCommandSystem.get_conduit_by_id()
    • CapabilityCommandSystem.get_conduit_by_name()
    • CapabilityCommandSystem.list_conduit_ids()
    • CapabilityCommandSystem.list_conduit_names()
    • CapabilityCommandSystem.count_conduits()
    • CapabilityCommandSystem.has_conduit_id()
    • CapabilityCommandSystem.has_conduit_name()
    • CapabilityCommandSystem.find_conduit_id_by_name()
    • CapabilityCommandSystem.create_lesser_conduit()
    • CapabilityCommandSystem.create_cluster()
    • CapabilityCommandSystem.delete_cluster()
    • CapabilityCommandSystem.join_cluster()
    • CapabilityCommandSystem.leave_cluster()
    • CapabilityCommandSystem.list_clusters()
    • CapabilityCommandSystem.link()
    • CapabilityCommandSystem.get_lesser_conduit()
    • CapabilityCommandSystem.get_initiated_conduit()
    • CapabilityCommandSystem.get_provider_conduit()
    • CapabilityCommandSystem.get_initiated_conduits()
    • CapabilityCommandSystem.get_provider_conduits()
    • CapabilityCommandSystem.get_contracted_conduits()
    • CapabilityCommandSystem.get_spell_in_contracts()
    • CapabilityCommandSystem.get_spells_in_contract_by_conduit()
    • CapabilityCommandSystem.get_spells_in_contract_by_conduit_name()
    • CapabilityCommandSystem.sever_link()
    • CapabilityCommandSystem.meld()
    • CapabilityCommandSystem.meld_existing_spell()
    • CapabilityCommandSystem.research_walk()
    • CapabilityCommandSystem.research_history()
    • CapabilityCommandSystem.research_heads()
    • CapabilityCommandSystem.research_residency()
    • CapabilityCommandSystem.research_diff()
    • CapabilityCommandSystem.research_campaign_view()
    • CapabilityCommandSystem.research_source()
    • CapabilityCommandSystem.research_impact()
    • CapabilityCommandSystem.research_module_graph()
    • CapabilityCommandSystem.research_source_drift()
    • CapabilityCommandSystem.research_module()
    • CapabilityCommandSystem.research_part()
    • CapabilityCommandSystem.research_part_diff()
    • CapabilityCommandSystem.research_parts()
    • CapabilityCommandSystem.research_group_view()
    • CapabilityCommandSystem.research_group_diff()
    • CapabilityCommandSystem.research_group_impact()
    • CapabilityCommandSystem.research_group_footprint()
    • CapabilityCommandSystem.research_group_drift()
    • CapabilityCommandSystem.research_group_history()
    • CapabilityCommandSystem.research_recent()
    • CapabilityCommandSystem.list_supported_command_methods()

CapabilityCommandSystem

Receive this surface through a capability Rift's space.command_system; use that owning object's public entry point.

Implementation source

class CapabilityCommandSystem(*, rift: Rift, space: RiftSpace, workstation: Workstation)

Internal

Capability-room command surface.

Purpose:

Own the broad manual-runtime command surface for CapabilityRiftSpace.

Contract:

• Inherits shared command infrastructure plus truly shared public helpers from CommandSystem.

• Owns topology mutation, cluster, direct meld(...), and reuse-only meld_existing_spell(...) command methods explicitly.

• Represents the broad manual-runtime posture between static and later slimmer codegen command surfaces.

Registration:

MELDER KERNEL - guarded. Built by CapabilityRiftSpace through the room's command-system factory seam.

Subsystem Context:

The broad manual posture of the command family. It owns the commands that deliberately do not exist on the static surface: conduit discovery, link and contract topology helpers, topology mutation, and both direct meld(...) and reuse-only meld_existing_spell(...).

System Context:

Owning meld(...) is the line that separates this posture from static, because direct meld CONSTRUCTS. Static keeps only the reuse form, which observes an instance that already exists; capability adds the form that brings one into being, and with it the responsibility for lifetime and existence semantics. Topology mutation is the second half of the same widening: this room can link, unlink, and rewire relationships that other conduits are actively resolving through. Lower Melder frame truth still adjudicates - a capability room cannot mutate topology on an automatic-mode frame, and the frame's refusal is final regardless of what the room advertises. It carries the twenty-one research READS but none of the preview, synthesis, or group-organization verbs, because those take or produce code and belong to the codegen posture.

AGENT_ACCESS: internal

AGENT_PURPOSE:

access: internal. Capability-room command surface. Melder kernel machinery: read it to understand the runtime, do not drive it directly.

get_links(conduit_id: str, *, frame_name: str | None = None) → Tuple[object, ...]

Return the current peer links for one conduit.

Parameters:

• conduit_id -- Conduit id whose peer links should be returned.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Linked conduit objects.

Return type:

Tuple[object, ...]

get_conduit_cloud(*, frame_name: str | None = None) → object

Return the live conduit cloud for one hosted frame.

Parameters:

frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Live conduit-cloud object for the resolved frame.

Return type:

object

get_conduit_by_id(conduit_id: str, *, frame_name: str | None = None) → object

Return one live conduit object by id, including lesser-conduit fallback.

Parameters:

• conduit_id -- Conduit id to resolve.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Live conduit object.

Return type:

object

get_conduit_by_name(conduit_name: str, *, frame_name: str | None = None) → object

Return one live root/normal conduit object by name.

Parameters:

• conduit_name -- Conduit name to resolve.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Live conduit object.

Return type:

object

list_conduit_ids(*, frame_name: str | None = None) → Tuple[str, ...]

Return the command-enabled published conduit ids for one frame.

Parameters:

frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Published command-enabled conduit ids.

Return type:

Tuple[str, ...]

list_conduit_names(*, frame_name: str | None = None) → Tuple[str, ...]

Return the command-enabled published conduit names for one frame.

Parameters:

frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Published command-enabled conduit names.

Return type:

Tuple[str, ...]

count_conduits(*, frame_name: str | None = None) → int

Return the number of command-enabled published conduits for one frame.

Parameters:

frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Number of published command-enabled conduits.

Return type:

int

has_conduit_id(conduit_id: str, *, frame_name: str | None = None) → bool

Return whether one published command-enabled conduit id exists.

Parameters:

• conduit_id -- Conduit id to check.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

True when the conduit id is published and command-enabled.

Return type:

bool

has_conduit_name(conduit_name: str, *, frame_name: str | None = None) → bool

Return whether one published command-enabled conduit name exists.

Parameters:

• conduit_name -- Conduit name to check.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

True when the conduit name is published and command-enabled.

Return type:

bool

find_conduit_id_by_name(conduit_name: str, *, frame_name: str | None = None) → str | None

Return the published command-enabled conduit id for one conduit name.

Parameters:

• conduit_name -- Conduit name to resolve.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Matching conduit id, or None when missing.

Return type:

Optional[str]

create_lesser_conduit(conduit_id: str, *, frame_name: str | None = None) → object

Create one lesser conduit beneath an existing conduit.

Purpose:

Provide the capability-room manual runtime seam for lesser-conduit creation without forcing callers to fetch a conduit first and then call into it directly.

Parameters:

• conduit_id -- Conduit id that should own the new lesser conduit.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Newly created lesser conduit object.

Return type:

object

create_cluster(conduit_id: str, cluster_name: str, *, frame_name: str | None = None) → None

Create one cluster through an existing conduit.

Parameters:

• conduit_id -- Conduit id that should issue the cluster creation request.

• cluster_name -- Cluster name to create.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

None.

delete_cluster(conduit_id: str, cluster_name: str, *, frame_name: str | None = None) → None

Delete one cluster through an existing conduit.

Parameters:

• conduit_id -- Conduit id that should issue the cluster deletion request.

• cluster_name -- Cluster name to delete.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

None.

join_cluster(conduit_id: str, cluster_name: str, *, frame_name: str | None = None) → None

Join one conduit to one cluster through the capability command surface.

Parameters:

• conduit_id -- Conduit id that should join the cluster.

• cluster_name -- Cluster name to join.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

None.

leave_cluster(conduit_id: str, cluster_name: str, *, frame_name: str | None = None) → None

Remove one conduit from one cluster through the capability command surface.

Parameters:

• conduit_id -- Conduit id that should leave the cluster.

• cluster_name -- Cluster name to leave.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

None.

list_clusters(conduit_id: str, *, frame_name: str | None = None) → Tuple[str, ...]

Return the cluster names visible from one conduit.

Parameters:

• conduit_id -- Conduit id whose cluster membership view should be queried.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Cluster names visible from the conduit.

Return type:

Tuple[str, ...]

link(source_conduit_id: str, target_conduit_id: str, *, frame_name: str | None = None) → bool

Link two conduits through the capability command surface.

Parameters:

• source_conduit_id -- Conduit id that should initiate the link.

• target_conduit_id -- Target conduit id.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

True when the link succeeds.

Return type:

bool

get_lesser_conduit(parent_conduit_id: str, conduit_id: str, *, frame_name: str | None = None) → object

Return one lesser conduit linked beneath a parent conduit.

Parameters:

• parent_conduit_id -- Parent conduit id that owns the lesser lineage.

• conduit_id -- Lesser conduit id to resolve.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Matching lesser conduit object, or None when missing.

Return type:

object

get_initiated_conduit(conduit_id: str, peer_conduit_id: str, *, frame_name: str | None = None) → object

Return one outbound linked conduit from a source conduit.

Parameters:

• conduit_id -- Source conduit id whose outbound link set should be queried.

• peer_conduit_id -- Peer conduit id to resolve from the source conduit's initiated links.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Matching outbound linked conduit object.

Return type:

object

get_provider_conduit(conduit_id: str, peer_conduit_id: str, *, frame_name: str | None = None) → object

Return one inbound provider conduit for a source conduit.

Parameters:

• conduit_id -- Source conduit id whose inbound provider link set should be queried.

• peer_conduit_id -- Peer conduit id to resolve from the source conduit's provider links.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Matching inbound provider conduit object.

Return type:

object

get_initiated_conduits(conduit_id: str, *, frame_name: str | None = None) → Tuple[object, ...]

Return the outbound linked conduits for one conduit.

Parameters:

• conduit_id -- Source conduit id whose outbound links should be returned.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Outbound linked conduit objects.

Return type:

Tuple[object, ...]

get_provider_conduits(conduit_id: str, *, frame_name: str | None = None) → Tuple[object, ...]

Return the inbound provider conduits for one conduit.

Parameters:

• conduit_id -- Source conduit id whose inbound provider links should be returned.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Inbound provider conduit objects.

Return type:

Tuple[object, ...]

get_contracted_conduits(conduit_id: str, *, frame_name: str | None = None) → object

Return the contracted peer conduits for one conduit.

Parameters:

• conduit_id -- Source conduit id whose contracted peers should be returned.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Lower-runtime contracted conduit collection.

Return type:

object

get_spell_in_contracts(conduit_id: str, spell_id: str, *, frame_name: str | None = None) → object

Return one contracted spell lookup result from a conduit.

Parameters:

• conduit_id -- Source conduit id whose contract view should be queried.

• spell_id -- Current spell id to resolve inside the conduit's contract set.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Lower-runtime spell-in-contract lookup result.

Return type:

object

get_spells_in_contract_by_conduit(conduit_id: str, peer_conduit_id: str, *, frame_name: str | None = None) → object

Return contracted spell data keyed by peer conduit id.

Parameters:

• conduit_id -- Source conduit id whose contract table should be queried.

• peer_conduit_id -- Peer conduit id whose contract spell data should be returned.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Lower-runtime contract spell payload for the peer conduit.

Return type:

object

get_spells_in_contract_by_conduit_name(conduit_id: str, conduit_name: str, *, frame_name: str | None = None) → object

Return contracted spell data keyed by peer conduit name.

Parameters:

• conduit_id -- Source conduit id whose contract table should be queried.

• conduit_name -- Peer conduit name whose contract spell data should be returned.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

Lower-runtime contract spell payload for the peer name.

Return type:

object

sever_link(source_conduit_id: str, target_conduit_id: str, *, frame_name: str | None = None) → bool

Sever one conduit link through the capability command surface.

Parameters:

• source_conduit_id -- Conduit id that owns the link to sever.

• target_conduit_id -- Target conduit id.

• frame_name -- Optional frame name. When omitted, the room default frame is used.

Returns:

True when the link is removed.

Return type:

bool

meld(conduit_id: str, spell_name: str | None = None, *, spell: object | None = None, spellframe: object | None = None, binding_name: str | None = None, frame_name: str | None = None, override: dict | list | tuple | None = None) → object

Resolve and activate one spell through a command-selected conduit.

Parameters:

• conduit_id -- Conduit id that should perform the meld.

• spell_name -- Optional logical spell name key.

• spell -- Optional spell id string or spell object.

• spellframe -- Optional spellframe / protocol / frame key.

• binding_name -- Optional binding name for resolution.

• frame_name -- Optional hosted frame name. When omitted, the room default frame is used.

• override -- Optional per-call override payload forwarded to the conduit.

Returns:

Activated runtime object returned by the conduit meld path.

Return type:

object

meld_existing_spell(conduit_id: str, spell_name: str | None = None, *, spell: object | None = None, spellframe: object | None = None, binding_name: str | None = None, frame_name: str | None = None) → object

Return one already-live spell runtime object through a selected conduit.

Parameters:

• conduit_id -- Conduit id that should perform the reuse-only resolution.

• spell_name -- Optional logical spell name key.

• spell -- Optional spell id string or spell object.

• spellframe -- Optional spellframe / protocol / frame key.

• binding_name -- Optional binding name for resolution.

• frame_name -- Optional hosted frame name. When omitted, the room default frame is used.

Returns:

Already-live runtime object returned by the conduit.

Return type:

object

research_walk(lane: str = 'default') → object

Return one research lane's line of versions (read-only).

Parameters:

lane -- Lane name or id; the default lane when omitted.

Returns:

Ordered node payloads (detached).

Return type:

object

research_history(spell_id: str) → object

Return everything the research record knows about one identity.

Parameters:

spell_id -- Binding-signature SHA256 to report on.

Returns:

History payload (detached).

Return type:

object

research_heads() → object

Return the tip identity of every open research lane.

Returns:

lane name -> tip spell id mapping (detached).

Return type:

object

research_residency(spell_id: str) → object

Return the query-time residency join for one identity.

Parameters:

spell_id -- Binding-signature SHA256 to locate.

Returns:

Residency payload (detached).

Return type:

object

research_diff(left_spell_id: str, right_spell_id: str, *, strategy: str = 'structural') → object

Return a derived diff between two research identities (read-only).

Parameters:

• left_spell_id -- Left version identity.

• right_spell_id -- Right version identity.

• strategy -- Registered diff strategy name.

Returns:

Detached diff verdict.

Return type:

object

research_campaign_view(campaign: str) → object

Return everything the record knows about one research campaign.

Parameters:

campaign -- Campaign stamp to gather.

Returns:

Campaign payload (detached).

Return type:

object

research_source(spell_id: str, *, module_name: str | None = None) → object

Return the code of one spell's module world (or one module of it).

Parameters:

• spell_id -- Binding-signature SHA256 whose world to read.

• module_name -- Optional single module to return.

Returns:

Per-module source rows (recorded-first, live-disk

fallback, honest text_unavailable).

Return type:

object

research_impact(*, spell_id: str | None = None, module_name: str | None = None) → object

Return one blast radius joined with research residency.

Parameters:

• spell_id -- Optional spell SHA256 at the blast center.

• module_name -- Optional canonical module name at the blast center.

Returns:

Radius payload plus the per-spell research join

(declared/lane/campaign rows).

Return type:

object

research_module_graph(spell_id: str) → object

Return one spell's module world as a walkable graph payload.

Parameters:

spell_id -- Binding-signature SHA256 whose world to walk.

Returns:

Modules, dependency edges, local reverse edges,

export surfaces, fingerprints, paths, and load order.

Return type:

object

research_source_drift() → object

Return the full recorded-vs-disk drift report with radii.

Returns:

Drift statuses per sealed module plus blast radii for

every module that is not unchanged.

Return type:

object

research_module(spell_id: str, module_name: str) → object

Return the full crystal dossier for one module of one version.

Parameters:

• spell_id -- Binding-signature SHA256 whose world carries it.

• module_name -- Module to gather.

Returns:

Source (labeled synthetic/user/live_disk), fingerprint,

path, deps, local importers, export surface, drift.

Return type:

object

research_part(spell_id: str, part_name: str, *, kind: str | None = None, module_name: str | None = None) → object

Return one named top-level function/class's text from a version.

Parameters:

• spell_id -- Binding-signature SHA256 whose world to search.

• part_name -- Top-level part name.

• kind -- Optional "function" or "class" filter.

• module_name -- Optional single module to search.

Returns:

Part text + span + carrying module, or an honest miss.

Return type:

object

research_part_diff(left_spell_id: str, right_spell_id: str, part_name: str, *, kind: str | None = None, module_name: str | None = None) → object

Unified text diff of one named part between two versions + radius.

Parameters:

• left_spell_id -- Left version identity.

• right_spell_id -- Right version identity.

• part_name -- Top-level part name to compare.

• kind -- Optional "function" or "class" filter.

• module_name -- Optional single module to search on both sides.

Returns:

Per-side found flags/modules/kinds, unified diff of the

part text (recorded material only), and the carrying module's residency-joined blast radius.

Return type:

object

research_parts(spell_id: str, *, module_name: str | None = None) → object

Return every top-level class/function of a version, with code.

Parameters:

• spell_id -- Binding-signature SHA256 whose world to inventory.

• module_name -- Optional single module to inventory.

Returns:

Per-module part rows (name/kind/span/text) with

per-module honesty (text_unavailable / parse_error).

Return type:

object

research_group_view(group_id: str) → object

Return one composition's roster with residence and drift truth.

Parameters:

group_id -- Composition identity to gather.

Returns:

Roster + per-member lane joins + behind drift flags.

Return type:

object

research_group_diff(left_group_id: str, right_group_id: str, *, strategy: str = 'members') → object

Return a derived diff between two recorded compositions.

Parameters:

• left_group_id -- Left composition identity.

• right_group_id -- Right composition identity.

• strategy -- Registered grouped strategy ("members" default: added/removed members + lane-evidenced version moves).

Returns:

Detached grouped-diff verdict.

Return type:

object

research_group_impact(group_id: str) → object

Return one composition's union blast radius with closure math.

Parameters:

group_id -- Composition identity at the blast center.

Returns:

Union radius, internal/outbound split, closure

fraction, affected compositions, residency join.

Return type:

object

research_group_footprint(group_id: str) → object

Return one composition's physical shadow (module footprint).

Parameters:

group_id -- Composition identity to shadow.

Returns:

Union of member module worlds, per-module member map,

shared modules, honest unknown-custody members.

Return type:

object

research_group_drift(group_id: str) → object

Return recorded-vs-disk drift filtered to one composition.

Parameters:

group_id -- Composition identity to check.

Returns:

Footprint-narrowed drift statuses, radii, and counts.

Return type:

object

research_group_history(group_id: str, *, campaign: str | None = None) → object

Return the journal story of one subsystem area.

Parameters:

• group_id -- Composition identity to gather around.

• campaign -- Optional campaign stamp - narrow the area's story to one effort (the WHERE x WHEN join).

Returns:

Subsystem-lane, member, and member-lane events in

journal order, campaign stamps intact.

Return type:

object

research_recent(*, limit: int = 50) → object

Return the newest journal events across the whole record.

Purpose:

The cold-landing read: "what happened here lately" in one call, before choosing where to work.

Parameters:

limit -- Bound on the number of newest entries.

Returns:

Newest journal entries in journal order, with the

total entry count and next sequence.

Return type:

object

list_supported_command_methods() → Tuple[str, ...]

Return the public command methods supported by capability rooms.

Returns:

Shared command names plus capability-owned method names in stable presentation order.

Return type:

Tuple[str, ...]

Topic reference · Full contents