Skip to content

symfonic.platform.working_reference

working_reference

Closed opt-in reference composition: one Working writer and Agent HMS graph.

WorkingReference

WorkingReference(graph, provider, owners, *, sink, retention=100)

InMemory-only, exact-scope/session reference. No generated/default wiring.

owners keys are (MemoryScope.path, session_id); values are verified principal ids provisioned by the trusted host. TTL is maintenance metadata, not an on-read expiry claim. Chat history publication is not implemented.

Source code in src/symfonic/platform/working_reference.py
def __init__(self, graph, provider, owners, *, sink, retention=100):
    self.graph, self.provider = graph, provider
    self.store = GraphBackedHms(graph)
    self.authority = InMemoryWorkingWriteAuthority(graph, owners)
    self.create = WorkingCreateService(
        self, graph, self.store, self.authority, retention=retention, sink=sink
    )
    self._agents, self._closed = {}, False