lingtai-kernel 0.1.0__tar.gz

lingtai_kernel-0.1.0/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: lingtai-kernel
+Version: 0.1.0
+Summary: Minimal agent kernel — think, communicate, remember, host tools
+License-Expression: MIT
+Requires-Python: >=3.11

lingtai_kernel-0.1.0/README.md

@@ -0,0 +1,86 @@
+# lingtai-kernel
+
+> [English](README.md) | [中文](README.zh.md) | [文言](README.wen.md)
+
+> *灵台者有持，而不知其所持，而不可持者也。*
+> *The spirit platform holds something, yet knows not what it holds — and what it holds cannot be held by force.*
+> — 庄子·庚桑楚
+
+Minimal agent kernel — think, communicate, remember, host tools.
+
+## Philosophy
+
+**灵台**，心也 — the spirit platform is the mind. In Zhuangzi, it is where consciousness dwells: a place that naturally holds everything the soul needs, without knowing what it holds, and without forcing it.
+
+In this framework, the agent's 灵台 is its **working directory** — a folder on disk where memory, covenant, identity, and mailbox live. The directory IS the agent. Give the kernel a folder and an LLM service, it brings the agent to life. Take the folder away, the agent ceases to exist. The kernel holds the agent's world, but does not interpret it — like the 灵台 of Zhuangzi, it holds without knowing what it holds.
+
+This kernel follows Unix design:
+
+- **Everything is a file.** The agent's identity is its directory path. No abstract IDs — the path is the address, the lock, the truth.
+- **The kernel defines protocols, not implementations.** `LLMService` and `ChatSession` are abstract interfaces. How they're fulfilled — adapters, API keys, rate limiting — is the caller's concern.
+- **Each agent is a self-contained process.** Own directory, own LLM service, own mail, own logs. Agents communicate through filesystem mail, not shared memory.
+- **The kernel is minimal.** Think (LLM), communicate (mail), remember (memory), host tools. Capabilities, file I/O, orchestration — those live in [lingtai](https://github.com/user/lingtai).
+
+## Install
+
+```bash
+pip install lingtai-kernel
+```
+
+## What the kernel provides
+
+| Component | Purpose |
+|-----------|---------|
+| **BaseAgent** | Kernel coordinator — lifecycle, message loop, tool dispatch |
+| **4 intrinsics** | mail (IPC), system (lifecycle), eigen (memory/identity), soul (inner voice) |
+| **LLM protocol** | `LLMService` ABC, `ChatSession` ABC, provider-agnostic types |
+| **Services** | Filesystem mail transport, structured JSONL logging |
+| **WorkingDir** | Directory management — locking, git, manifest |
+
+## What the kernel does NOT provide
+
+Capabilities, file I/O, MCP, vision, web search, bash, avatars, LLM adapters, rate limiting — these live in `lingtai`.
+
+## Quick start
+
+```python
+from lingtai_kernel import BaseAgent
+
+# The caller provides the LLM service (any implementation of the ABC)
+agent = BaseAgent(
+    service=my_llm_service,
+    working_dir="/agents/alice",    # the 灵台 — where the soul lives
+    agent_name="alice",             # optional display name
+)
+
+agent.add_tool("hello", schema={...}, handler=lambda args: {"msg": "hi"})
+agent.start()
+agent.send("Say hello")
+agent.stop()
+```
+
+The kernel takes a directory path and a service. It doesn't know or care how either was created.
+
+## Agent identity
+
+```
+/agents/alice/              ← this path IS the agent
+  .agent.lock               ← exclusive lock (one process per directory)
+  .agent.heartbeat          ← liveness proof (updated periodically)
+  .agent.json               ← manifest (name, address, config)
+  system/
+    covenant.md             ← protected instructions
+    memory.md               ← agent's working notes
+  mailbox/
+    inbox/                  ← received messages
+    outbox/                 ← pending sends
+    sent/                   ← delivery audit trail
+  logs/
+    events.jsonl            ← structured event log
+```
+
+No `agent_id`. The path is the identity. The heartbeat proves liveness. The lock proves exclusivity.
+
+## License
+
+MIT

lingtai_kernel-0.1.0/pyproject.toml

@@ -0,0 +1,20 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lingtai-kernel"
+version = "0.1.0"
+requires-python = ">=3.11"
+dependencies = []
+description = "Minimal agent kernel — think, communicate, remember, host tools"
+license = "MIT"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+lingtai_kernel = ["i18n/*.json"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

lingtai_kernel-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

lingtai_kernel-0.1.0/src/lingtai_kernel/__init__.py

@@ -0,0 +1,16 @@
+"""lingtai-kernel — minimal agent kernel: think, communicate, remember, host tools."""
+from .types import UnknownToolError
+from .config import AgentConfig
+from .base_agent import BaseAgent
+from .state import AgentState
+from .message import Message, MSG_REQUEST, MSG_USER_INPUT
+
+__all__ = [
+    "BaseAgent",
+    "AgentConfig",
+    "AgentState",
+    "Message",
+    "MSG_REQUEST",
+    "MSG_USER_INPUT",
+    "UnknownToolError",
+]