forge.identity

Python identity package; imports are explicit from this package.

Package contract

Field	Value
Language	python
Source version	0.1.0
Manifest	`forge-py/pyproject.toml`
Source files	7
Evidence	Source reference; registry publication and runtime conformance are separate checks

Import boundary

import forge.identity

Use a source checkout or your verified private registry. Manifest coordinates identify the package; they do not establish that a public registry release exists.

Download package reference JSON. Each original source file and generated declaration artifact has its own SHA-256 digest. Function bodies and constant values are omitted from downloads. These are source declaration inventories, not compiler-resolved rustdoc, TypeDoc, DocC, or Dokka output. Private modules can contain public declarations that are not reachable through the package boundary; consult the entry point before importing.

agent_identity.py

Read declaration text · 20 declaration entries

class OasDocumentRef()

def has_proof(self) -> bool

def has_lineage(self) -> bool

def lineage_generation(self) -> int | None

def human_root_did(self) -> str | None

def to_json(self) -> str

def from_json(data: str) -> OasDocumentRef

class WasmKeyRef()

class ForgeAgentIdentity()

def __init__(self, did: str, kind: str, keypair: WasmKeyRef, document: OasDocumentRef, lineage_depth: int) -> None

def did(self) -> str

def kind(self) -> str

def keypair(self) -> WasmKeyRef

def document(self) -> OasDocumentRef

def lineage_depth(self) -> int

def verifying_key_bytes(self) -> bytes

def sign(self, message: bytes) -> bytes

def verify(self, message: bytes, signature: bytes) -> bool

def to_dict(self) -> dict[str, Any]

def from_dict(data: dict[str, Any]) -> ForgeAgentIdentity

error.py

Read declaration text · 11 declaration entries

class ForgeIdentityError(ForgeError)

class IdentityDerivationError(ForgeIdentityError)

def __init__(self, parent_did: str, path: str, reason: str) -> None

class LineageVerificationError(ForgeIdentityError)

def __init__(self, did: str, reason: str) -> None

class ChainTooDeepError(ForgeIdentityError)

def __init__(self, depth: int, max_depth: int) -> None

class InvalidIdentityError(ForgeIdentityError)

def __init__(self, reason: str) -> None

class IdentityPersistenceError(ForgeIdentityError)

def __init__(self, reason: str) -> None

glyph.py

Read declaration text · 22 declaration entries

class GlyphEntityKind(Enum)

def parse_kind(s: str) -> GlyphEntityKind | None

def as_str(self) -> str

def as_u8(self) -> int

def from_u8(v: int) -> GlyphEntityKind | None

class GlyphColor()

def to_hex(self) -> str

def rgb(r: int, g: int, b: int) -> GlyphColor

def to_dict(self) -> dict[str, int]

def from_dict(data: dict[str, int]) -> GlyphColor

class GlyphPalette()

class GlyphDescriptor()

def to_dict(self) -> dict[str, Any]

def from_dict(data: dict[str, Any]) -> GlyphDescriptor

def to_json(self) -> str

def from_json(data: str) -> GlyphDescriptor

class GlyphRenderTarget(Enum)

class GlyphRenderFormat(Enum)

class GlyphRenderOptions()

class GlyphRenderResult()

def svg_data(self) -> str | None

def derive_palette(did: str, kind: GlyphEntityKind) -> GlyphPalette

lineage.py

Read declaration text · 12 declaration entries

class LineageProof()

def to_dict(self) -> dict[str, Any]

def from_dict(data: dict[str, Any]) -> LineageProof

class LineageChain()

def depth(self) -> int

def is_root(self) -> bool

def to_dict(self) -> dict[str, Any]

def from_dict(data: dict[str, Any]) -> LineageChain

def create_hmr_identity(namespace: str, identifier: str) -> ForgeAgentIdentity

def create_mhr_identity(namespace: str, identifier: str) -> ForgeAgentIdentity

def derive_agent_identity(parent: ForgeAgentIdentity, name: str, namespace: str, *, max_depth: int=DEFAULT_MAX_LINEAGE_DEPTH) -> ForgeAgentIdentity

def verify_lineage_chain(identity: ForgeAgentIdentity, document_store: dict[str, dict[str, Any]] | None=None) -> LineageChain

local_dev.py

Read declaration text · 14 declaration entries

def forge_dev_did(machine_id: str, kind: str, identifier: str) -> str

def derive_machine_id(profile_name: str) -> str

def derive_machine_id_from_parts(hostname: str, username: str, profile_name: str) -> str

def validate_forge_dev_did(did: str) -> str | None

class LocalOrg()

def id(self) -> str

class ForgeDevIdentity()

def to_dict(self) -> dict[str, Any]

def from_dict(data: dict[str, Any]) -> ForgeDevIdentity

class LocalDevProfile()

def create(profile_name: str='default') -> LocalDevProfile

def agent_identity(self, agent_name: str) -> ForgeDevIdentity

def agent_count(self) -> int

def to_dict(self) -> dict[str, Any]

persistence.py

Read declaration text · 13 declaration entries

class IdentityStore(ABC)

def save(self, identity: ForgeAgentIdentity) -> None

def load(self, did: str) -> ForgeAgentIdentity | None

def delete(self, did: str) -> bool

def list_dids(self) -> list[str]

class MemoryIdentityStore(IdentityStore)

def __init__(self) -> None

def save(self, identity: ForgeAgentIdentity) -> None

def load(self, did: str) -> ForgeAgentIdentity | None

def delete(self, did: str) -> bool

def list_dids(self) -> list[str]

def save_identity(identity: ForgeAgentIdentity, path: Path | str) -> None

def load_identity(path: Path | str) -> ForgeAgentIdentity