agentic-sdk 0.0.1__tar.gz

agentic_sdk-0.0.1/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

agentic_sdk-0.0.1/.python-version

@@ -0,0 +1 @@
+3.11

agentic_sdk-0.0.1/LICENSE

@@ -0,0 +1,12 @@
+BSD Zero Clause License (SPDX: 0BSD)
+
+Permission to use, copy, modify, and/or distribute this software for any purpose
+with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
+FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
+OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
+TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF
+THIS SOFTWARE.

agentic_sdk-0.0.1/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: agentic-sdk
+Version: 0.0.1
+Summary: Python bindings for the Agentic C++ SDK — orchestrate coding agents and LLMs with a unified session model, event stream, and tool system.
+Project-URL: Homepage, https://github.com/BuildWithCollab/Agentic
+Project-URL: Repository, https://github.com/BuildWithCollab/Agentic
+Project-URL: Issues, https://github.com/BuildWithCollab/Agentic/issues
+Author-email: Mrowr Purr <mrowr.purr@gmail.com>
+License-Expression: 0BSD
+License-File: LICENSE
+Keywords: agent-orchestration,agentic,ai,claude-code,codex,coding-agent,gemini,llm,sdk,tools
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: C++
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+# agentic-sdk
+
+> ⚠️ **Pre-release placeholder.** This package reserves the name — the real thing is coming soon.
+
+Python bindings for the [Agentic](https://github.com/BuildWithCollab/Agentic) C++ SDK — a unified library for orchestrating AI coding agents and direct LLM APIs.
+
+## What it is
+
+Agentic is a C++ SDK (with Python bindings via this package) that treats coding agents and LLM conversations as first-class **sessions** with a shared event model:
+
+- **Unified session API** — the same `prompt` / event-stream interface whether you're talking to an LLM directly or driving a CLI coding agent like Claude Code, Gemini CLI, or Codex.
+- **Structured event database** — every tool call, reasoning step, and response is captured in a queryable local database. Slice by session, tool, time, or full-text search.
+- **Pythonic tool definitions** — define tools as decorated functions with Pydantic models. The LLM gets the schema, you get the type safety.
+- **Async event streams** — subscribe to events as they happen, across sessions, across processes.
+- **Forking** — branch a session at any point to explore alternate paths without losing the original context.
+- **Extensible** — providers for new coding agents or LLMs load as dynamic libraries.
+
+## Status
+
+Not yet functional. The C++ SDK is under active development and the Python bindings will land shortly after it stabilizes.
+
+If you're curious about the design, the full interface design document lives in the [main repo](https://github.com/BuildWithCollab/Agentic/blob/main/interface-designing.md).
+
+## Coming soon
+
+```python
+import agentic
+from agentic.tools import tool
+from pydantic import BaseModel
+
+class WeatherArgs(BaseModel):
+    city: str
+
+@tool(description="Get the weather for a city")
+def weather(args: WeatherArgs) -> dict:
+    return {"temp": 72, "conditions": "sunny"}
+
+ctx = agentic.Context()
+
+with ctx.llm_session(model="anthropic/claude-sonnet-4", tools=[weather]) as session:
+    async for event in session.prompt("What's the weather in Portland?"):
+        print(f"{event.event_type}: {event.content}")
+```
+
+## License
+
+[0BSD](LICENSE) — BSD Zero Clause. Do whatever you want.

agentic_sdk-0.0.1/README.md

@@ -0,0 +1,47 @@
+# agentic-sdk
+
+> ⚠️ **Pre-release placeholder.** This package reserves the name — the real thing is coming soon.
+
+Python bindings for the [Agentic](https://github.com/BuildWithCollab/Agentic) C++ SDK — a unified library for orchestrating AI coding agents and direct LLM APIs.
+
+## What it is
+
+Agentic is a C++ SDK (with Python bindings via this package) that treats coding agents and LLM conversations as first-class **sessions** with a shared event model:
+
+- **Unified session API** — the same `prompt` / event-stream interface whether you're talking to an LLM directly or driving a CLI coding agent like Claude Code, Gemini CLI, or Codex.
+- **Structured event database** — every tool call, reasoning step, and response is captured in a queryable local database. Slice by session, tool, time, or full-text search.
+- **Pythonic tool definitions** — define tools as decorated functions with Pydantic models. The LLM gets the schema, you get the type safety.
+- **Async event streams** — subscribe to events as they happen, across sessions, across processes.
+- **Forking** — branch a session at any point to explore alternate paths without losing the original context.
+- **Extensible** — providers for new coding agents or LLMs load as dynamic libraries.
+
+## Status
+
+Not yet functional. The C++ SDK is under active development and the Python bindings will land shortly after it stabilizes.
+
+If you're curious about the design, the full interface design document lives in the [main repo](https://github.com/BuildWithCollab/Agentic/blob/main/interface-designing.md).
+
+## Coming soon
+
+```python
+import agentic
+from agentic.tools import tool
+from pydantic import BaseModel
+
+class WeatherArgs(BaseModel):
+    city: str
+
+@tool(description="Get the weather for a city")
+def weather(args: WeatherArgs) -> dict:
+    return {"temp": 72, "conditions": "sunny"}
+
+ctx = agentic.Context()
+
+with ctx.llm_session(model="anthropic/claude-sonnet-4", tools=[weather]) as session:
+    async for event in session.prompt("What's the weather in Portland?"):
+        print(f"{event.event_type}: {event.content}")
+```
+
+## License
+
+[0BSD](LICENSE) — BSD Zero Clause. Do whatever you want.

agentic_sdk-0.0.1/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "agentic-sdk"
+version = "0.0.1"
+description = "Python bindings for the Agentic C++ SDK — orchestrate coding agents and LLMs with a unified session model, event stream, and tool system."
+readme = "README.md"
+license = "0BSD"
+license-files = ["LICENSE"]
+requires-python = ">=3.11"
+authors = [
+    { name = "Mrowr Purr", email = "mrowr.purr@gmail.com" },
+]
+keywords = [
+    "agentic",
+    "ai",
+    "llm",
+    "coding-agent",
+    "claude-code",
+    "gemini",
+    "codex",
+    "agent-orchestration",
+    "sdk",
+    "tools",
+]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: C++",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://github.com/BuildWithCollab/Agentic"
+Repository = "https://github.com/BuildWithCollab/Agentic"
+Issues = "https://github.com/BuildWithCollab/Agentic/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agentic_sdk"]

agentic_sdk-0.0.1/src/agentic_sdk/__init__.py

@@ -0,0 +1,18 @@
+"""
+agentic-sdk — Python bindings for the Agentic C++ SDK.
+
+⚠️  Pre-release placeholder. The real package is coming soon.
+
+Agentic is a C++ SDK for orchestrating AI coding agents (Claude Code,
+Gemini CLI, Codex, and more) and direct LLM APIs — with a unified
+session model, event stream, and tool system.
+
+This Python package will ship native bindings to the C++ core so you
+can use Agentic from Python with a Pythonic API: context managers,
+async generators, Pydantic-based tool definitions, and a structured
+event stream you can query or subscribe to.
+
+Not yet ready for use — watch this space.
+"""
+
+__version__ = "0.0.1"