On this page

StaticCommandSystem๏ƒ

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

Implementation source

class StaticCommandSystem(*, rift: Rift, space: RiftSpace, workstation: Workstation)[source]๏ƒ

Internal

Static-room command surface.

Purpose:

Keep the shared command infrastructure while owning the static-safe command surface for StaticRiftSpace.

Contract:

  • Inherits all shared selected-target, ACL, and workstation behavior from CommandSystem.

  • Owns live-only spell runtime retrieval under the shared getter names.

  • Owns static-specific spell status and reuse-only command helpers.

  • Does not expose topology mutation or direct meld(...) because those methods now live on the capability surface instead of being denied after inheritance.

  • Leaves already-bound workstation objects outside post-bind policing.

Registration:

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

Subsystem Context:

The static posture of the command family, beside CapabilityCommandSystem and CodegenCommandSystem. All three inherit shared infrastructure from CommandSystem and differ only in the vocabulary they own.

System Context:

The third contract line records a genuine architectural correction and is worth reading closely: topology mutation and direct meld(...) are not DENIED here after inheritance - they simply LIVE ON the capability surface instead. That difference matters. Inheriting a dangerous method and then refusing it means the method exists on the object, appears in introspection, and must be defended at every call site. Never inheriting it means the static surface is honestly narrow, and agents enumerating the room's commands see the truth rather than a list of things that will reject them. "Leaves already-bound workstation objects outside post-bind policing" is the matching honesty: once an object is in the canvas it is the caller's, and pretending to police it afterwards would promise a containment this room cannot actually enforce.

AGENT_ACCESS: internal

AGENT_PURPOSE:

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

get_conduit_cloud(*, frame_name: str | None = None) → None[source]๏ƒ

Static rooms do not expose the live conduit-cloud runtime object.

Parameters:

frame_name -- Unused static-room frame selector.

Return type:

None

Raises:

AttributeError -- Always, because static rooms do not expose direct conduit-cloud runtime access.

get_conduit_by_id(conduit_id: str, *, frame_name: str | None = None) → None[source]๏ƒ

Static rooms do not expose live conduit runtime objects by id.

Parameters:

  • conduit_id -- Unused conduit id.

  • frame_name -- Unused static-room frame selector.

Return type:

None

Raises:

AttributeError -- Always, because static rooms do not expose direct conduit runtime-object access.

get_conduit_by_name(conduit_name: str, *, frame_name: str | None = None) → None[source]๏ƒ

Static rooms do not expose live conduit runtime objects by name.

Parameters:

  • conduit_name -- Unused conduit name.

  • frame_name -- Unused static-room frame selector.

Return type:

None

Raises:

AttributeError -- Always, because static rooms do not expose direct conduit runtime-object access.

get_spell_by_source_id(spell_source_id: str, *, frame_name: str | None = None) → object[source]๏ƒ

Return one already-live spell runtime object using a published spell source id.

Parameters:

  • spell_source_id -- Published spell source id in spellbook_id:spell_id form.

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

Returns:

Already-live spell runtime object.

Return type:

object

Raises:

ValueError -- If the spell is not published in the selected frame or is not currently live.

describe_spell_status_by_source_id(spell_source_id: str, *, frame_name: str | None = None) → dict[source]๏ƒ

Return static availability status for one published spell source id.

Parameters:

  • spell_source_id -- Published spell source id in spellbook_id:spell_id form.

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

Returns:

Static spell status payload.

Return type:

dict

describe_spell_status_by_id(spell_id: str, *, frame_name: str | None = None) → dict[source]๏ƒ

Return static availability status for one current spell id.

Parameters:

  • spell_id -- Current spell id to resolve.

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

Returns:

Static spell status payload.

Return type:

dict

describe_spell_status_by_index_id(spell_index_id: str, *, frame_name: str | None = None) → dict[source]๏ƒ

Return static availability status for one stable spell-index id.

Parameters:

  • spell_index_id -- Stable SpellIndex id to resolve.

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

Returns:

Static spell status payload.

Return type:

dict

get_spell_by_index_id(spell_index_id: str, *, frame_name: str | None = None) → object[source]๏ƒ

Return one already-live spell runtime object by stable spell-index id.

Parameters:

  • spell_index_id -- Stable SpellIndex id to resolve.

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

Returns:

Already-live spell runtime object.

Return type:

object

Raises:

ValueError -- If the spell index is not published in the selected frame or does not currently have a live creation.

get_spell_by_id(spell_id: str, *, frame_name: str | None = None) → object[source]๏ƒ

Return one already-live spell runtime object by current spell id.

Parameters:

  • spell_id -- Current spell id to resolve.

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

Returns:

Already-live spell runtime object.

Return type:

object

Raises:

ValueError -- If the spell is not published in the selected frame or does not currently have a live creation.

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[source]๏ƒ

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

Purpose:

Keep the reuse-only spell-activation helper on the static command surface without inheriting the broader capability activation set.

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

list_supported_command_methods() → tuple[str, ...][source]๏ƒ

Return the public command methods supported by static rooms.

Returns:

Shared command names plus static-owned helper

names in stable presentation order.

Return type:

tuple[str, ...]

Topic reference ยท Full contents