Pixir.Delegate.Handle (pixir v0.1.12)

Stable Delegate handle helpers.

Delegate service mode has two identities:

delegate_id is the user-facing service handle returned by Delegate surfaces;
parent_session_id is the durable Pixir Session Log root used for diagnostics, tree projection, and restart-safe status.

The current implementation has no separate durable Delegate index. To keep status/attach/cancel useful before a resident owner exists, delegate_id is a reversible dlg1_... wrapper around parent_session_id. Future owner-backed service mode may move this mapping into a durable index, but it must continue exposing the parent Session id instead of hiding Log truth behind an opaque service id.

Bare and decoded parent Session ids use Pixir.SessionId exactly as supplied. This boundary never trims or otherwise normalizes an invalid id before validation.

Summary

Functions

build(parent_session_id, opts \\ [])

Build a versioned Delegate handle from a parent Session id.

resolve(handle_or_session_id, opts \\ [])

Resolve either a Delegate id or a parent Session id into the stable handle shape.

Functions

build(parent_session_id, opts \\ [])

@spec build(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, map()}

Build a versioned Delegate handle from a parent Session id.

resolve(handle_or_session_id, opts \\ [])

@spec resolve(
  String.t(),
  keyword()
) :: {:ok, map()} | {:error, map()}

Resolve either a Delegate id or a parent Session id into the stable handle shape.

Bare Session ids remain accepted for compatibility with the existing attached runner and diagnostics commands. A future durable Delegate index can replace the reversible encoding without changing callers that already inspect parent_session_id.