Update: __init__ and README

Co-authored-by: Copilot <copilot@github.com>

Author: JohnRichard4096

README.md

@@ -1,8 +1,30 @@
-# AmritaSense
-Next-Gen Graph workflow engine.
-
 <center>
+<img src="./docs/public/Amrita.png" alt="Logo" width="200" height="200">
+
+<h1>AmritaSense</h1>
+
+<p>
+    <a href="https://img.shields.io/pypi/v/amrita-sense">
+      <img src="https://img.shields.io/pypi/v/amrita-sense?color=blue&style=flat-square" alt="PyPI Version">
+    </a>
+    <a href="https://www.python.org/">
+      <img src="https://img.shields.io/badge/python-3.10+-blue?logo=python&style=flat-square" alt="Python Version">
+    </a>
+    <a href="LICENSE">
+      <img src="https://img.shields.io/github/license/AmritaBot/AmritaSense?style=flat-square" alt="License">
+    </a>
+    <a href="https://discord.gg/byAD3sbjjj">
+      <img src="https://img.shields.io/badge/Discord-Project.Amrita-blue?logo=discord&style=flat-square" alt="Discord">
+    </a>
+    <a href="https://qm.qq.com/q/9J23pPZN3a">
+      <img src="https://img.shields.io/badge/QQ-1006893368-blue?style=flat-square" alt="QQ Group">
+    </a>
+  </p>
+
+> ### _"Any is things all you need."_
+
+</center>
 
-> ## *"Any is things all you need."*
+## Significants
 
-</center>
+Docs and tests are still in progress...

log.txt

@@ -0,0 +1,36 @@
+from .exceptions import (
+    DependsException,
+    DependsInjectFailed,
+    DependsResolveFailed,
+    InterruptNotice,
+    NullPointerException,
+)
+from .instructions import ALIAS, DO, IF, INTERRUPT, NOP, WHILE, Try
+from .node import Node, NodeCompose, NodeComposeRendered, NodeType
+from .runtime.deps import POINTER_DEPENDS
+from .runtime.workflow import WorkflowInterpreter, WorkflowPC
+from .types import PointerVector, Stack
+
+__all__ = [
+    "ALIAS",
+    "DO",
+    "IF",
+    "INTERRUPT",
+    "NOP",
+    "POINTER_DEPENDS",
+    "WHILE",
+    "DependsException",
+    "DependsInjectFailed",
+    "DependsResolveFailed",
+    "InterruptNotice",
+    "Node",
+    "NodeCompose",
+    "NodeComposeRendered",
+    "NodeType",
+    "NullPointerException",
+    "PointerVector",
+    "Stack",
+    "Try",
+    "WorkflowInterpreter",
+    "WorkflowPC",
+]

src/amrita_sense/__init__.py

@@ -1,4 +1,4 @@
-from .alias import AliasNode
+from .alias import ALIAS
 from .if_clause import IF
 from .jump import GOTO
 from .loop.do_while import DO
@@ -7,12 +7,12 @@
 from .workfl_ctrl import INTERRUPT, NOP
 
 __all__ = (
+    "ALIAS",
     "DO",
     "GOTO",
     "IF",
     "INTERRUPT",
     "NOP",
     "WHILE",
-    "AliasNode",
     "Try",
 )

src/amrita_sense/instructions/__init__.py

@@ -1,9 +1,12 @@
-from .core import NodeComposeRendered
+from .core import Node as NodeType
+from .core import NodeCompose, NodeComposeRendered
 from .self_compile import SelfCompileInstruction
 from .wrapper import Node
 
 __all__ = [
     "Node",
+    "NodeCompose",
     "NodeComposeRendered",
+    "NodeType",
     "SelfCompileInstruction",
 ]

src/amrita_sense/node/__init__.py

@@ -5,7 +5,7 @@
 from copy import deepcopy
 from functools import wraps
 from inspect import iscoroutinefunction
-from typing import Any, TypeAlias
+from typing import Any, Generic, TypeAlias, TypeVar, cast
 
 from amrita_core import SuspendObjectStream, logger
 from amrita_core.hook.matcher import DependsFactory, MatcherFactory
@@ -24,21 +24,23 @@
     "WorkflowPC::each_node"  # When stop at this checkpoint, change address is allowed.
 )
 
+io_T = TypeVar("io_T", bound=SuspendObjectStream, covariant=True)
 
-class WorkflowInterpreter:
+
+class WorkflowInterpreter(Generic[io_T]):
     _graph: NodeComposeRendered
     _pointer: PointerVector
     _ava_args: tuple
     _ava_kwargs: dict[str, Any]
     _exc_ignored: tuple[type[BaseException], ...]
-    object_io: SuspendObjectStream
+    object_io: io_T
     _ret_addr_stack: Stack[PointerVector]
     _jump_marked: bool
 
     def __init__(
         self,
         node_compose: NodeComposeRendered | SelfCompileInstruction,
-        object_io: SuspendObjectStream | None = None,
+        object_io: SuspendObjectStream[Any] | None = None,
         *,
         exception_ignored: tuple[type[BaseException], ...],
         extra_args: tuple,
@@ -52,7 +54,8 @@ def __init__(
         self._ava_args = (self, *extra_args)
         self._ava_kwargs = deepcopy(extra_kwargs)
         self._exc_ignored = (*exception_ignored, InterruptNotice)
-        self.object_io = object_io or SuspendObjectStream()
+        object_io = object_io or SuspendObjectStream()
+        self.object_io = cast(io_T, object_io)
         self._ret_addr_stack = addr_stack or Stack()
         self._jump_marked = False