hyperstack-langgraph 1.0.0__tar.gz → 1.2.0__tar.gz

hyperstack_langgraph-1.2.0/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: hyperstack-langgraph
+Version: 1.2.0
+Summary: Knowledge graph memory for LangGraph agents. Portable memory, real-time agent-to-agent orchestration, zero LLM cost.
+Author-email: CascadeAI <deeq.yaqub1@gmail.com>
+License: MIT
+Project-URL: Homepage, https://cascadeai.dev/hyperstack
+Project-URL: Repository, https://github.com/deeqyaqub1-cmd/hyperstack-langgraph
+Project-URL: Documentation, https://cascadeai.dev/hyperstack
+Keywords: langgraph,memory,knowledge-graph,ai-agents,hyperstack,langchain,multi-agent,portable-memory
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: langgraph
+Requires-Dist: langgraph>=0.2; extra == "langgraph"
+Requires-Dist: langchain-core>=0.3; extra == "langgraph"

{hyperstack_langgraph-1.0.0 → hyperstack_langgraph-1.2.0}/hyperstack_langgraph/__init__.py

@@ -1,23 +1,29 @@
 """
 HyperStack LangGraph Integration
 Knowledge graph memory for LangGraph agents.
+Portable memory across tools. Multi-agent coordination.
 """
 
 import os
 import json
 import urllib.request
 import urllib.error
+import urllib.parse
 from typing import Optional, List, Dict, Any
 
+__version__ = "1.2.0"
+
 # ─── API Client ───────────────────────────────────────────
 
 class HyperStackClient:
     """Lightweight HTTP client for HyperStack API. No dependencies."""
 
-    def __init__(self, api_key: str = None, workspace: str = None, base_url: str = None):
+    def __init__(self, api_key: str = None, workspace: str = None, base_url: str = None,
+                 agent_id: str = None):
         self.api_key = api_key or os.environ.get("HYPERSTACK_API_KEY", "")
         self.workspace = workspace or os.environ.get("HYPERSTACK_WORKSPACE", "default")
         self.base_url = base_url or os.environ.get("HYPERSTACK_BASE_URL", "https://hyperstack-cloud.vercel.app")
+        self.agent_id = agent_id or os.environ.get("HYPERSTACK_AGENT_ID", "langgraph")
 
         if not self.api_key:
             raise ValueError(
@@ -42,15 +48,21 @@ class HyperStackClient:
 
     def store(self, slug: str, title: str, body: str, card_type: str = "general",
               keywords: list = None, links: list = None, stack: str = "general",
-              meta: dict = None) -> dict:
-        """Create or update a card (upsert by slug)."""
-        payload = {"slug": slug, "title": title, "body": body, "cardType": card_type, "stack": stack}
+              meta: dict = None, target_agent: str = None) -> dict:
+        """Create or update a card (upsert by slug). Auto-tags sourceAgent."""
+        payload = {
+            "slug": slug, "title": title, "body": body,
+            "cardType": card_type, "stack": stack,
+            "sourceAgent": self.agent_id,
+        }
         if keywords:
             payload["keywords"] = keywords
         if links:
             payload["links"] = links
         if meta:
             payload["meta"] = meta
+        if target_agent:
+            payload["targetAgent"] = target_agent
         return self._request("POST", f"/api/cards?workspace={self.workspace}", payload)
 
     def search(self, query: str, mode: str = None) -> dict:
@@ -64,9 +76,39 @@ class HyperStackClient:
         """Get a single card by slug."""
         return self._request("GET", f"/api/cards?workspace={self.workspace}&id={slug}")
 
-    def list_cards(self) -> dict:
-        """List all cards in workspace."""
-        return self._request("GET", f"/api/cards?workspace={self.workspace}")
+    def list_cards(self, source_agent: str = None, target_agent: str = None,
+                   since: str = None, card_type: str = None) -> dict:
+        """List cards with optional filters."""
+        url = f"/api/cards?workspace={self.workspace}"
+        if source_agent:
+            url += f"&sourceAgent={urllib.parse.quote(source_agent)}"
+        if target_agent:
+            url += f"&targetAgent={urllib.parse.quote(target_agent)}"
+        if since:
+            url += f"&since={urllib.parse.quote(since)}"
+        if card_type:
+            url += f"&type={urllib.parse.quote(card_type)}"
+        return self._request("GET", url)
+
+    def inbox(self, since: str = None) -> dict:
+        """Get cards directed at this agent. Multi-agent coordination."""
+        return self.list_cards(target_agent=self.agent_id, since=since)
+
+    def register_webhook(self, url: str, events: list = None, secret: str = None) -> dict:
+        """Register a webhook for real-time agent-to-agent orchestration. Team+ only."""
+        payload = {
+            "agentId": self.agent_id,
+            "url": url,
+            "events": events or ["*"],
+            "workspace": self.workspace,
+        }
+        if secret:
+            payload["secret"] = secret
+        return self._request("POST", "/api/agent-webhooks", payload)
+
+    def list_webhooks(self) -> dict:
+        """List all registered webhooks."""
+        return self._request("GET", "/api/agent-webhooks")
 
     def delete(self, slug: str) -> dict:
         """Delete a card by slug."""
@@ -82,15 +124,12 @@ class HyperStackClient:
         return self._request("GET", url)
 
 
-# ─── Need urllib.parse ────────────────────────────────────
-import urllib.parse
-
-
 # ─── LangGraph Tools ─────────────────────────────────────
 
-def create_hyperstack_tools(api_key: str = None, workspace: str = None):
+def create_hyperstack_tools(api_key: str = None, workspace: str = None, agent_id: str = None):
     """
     Create LangGraph-compatible tools for HyperStack memory.
+    Auto-tags all stored cards with sourceAgent for cross-tool memory.
 
     Usage with LangGraph:
         from hyperstack_langgraph import create_hyperstack_tools
@@ -102,6 +141,11 @@ def create_hyperstack_tools(api_key: str = None, workspace: str = None):
     Usage with existing tools:
         my_tools = [my_tool_1, my_tool_2] + create_hyperstack_tools()
         agent = create_react_agent(model, my_tools)
+
+    Multi-agent coordination:
+        tools = create_hyperstack_tools(agent_id="planner-agent")
+        # All stored cards will be tagged sourceAgent="planner-agent"
+        # Other agents can query for cards directed at them
     """
     try:
         from langchain_core.tools import tool
@@ -110,7 +154,7 @@ def create_hyperstack_tools(api_key: str = None, workspace: str = None):
             "langchain-core is required. Install it with: pip install langchain-core"
         )
 
-    client = HyperStackClient(api_key=api_key, workspace=workspace)
+    client = HyperStackClient(api_key=api_key, workspace=workspace, agent_id=agent_id)
 
     @tool
     def hyperstack_search(query: str) -> str:
@@ -135,17 +179,20 @@ def create_hyperstack_tools(api_key: str = None, workspace: str = None):
 
     @tool
     def hyperstack_store(slug: str, title: str, body: str, card_type: str = "general",
-                         keywords: str = "", links: str = "") -> str:
+                         keywords: str = "", links: str = "", target_agent: str = "") -> str:
         """Store a memory in HyperStack. Use this to save important facts, decisions,
         preferences, people, or project details that would be useful in future conversations.
+        Automatically tags which agent created this card for cross-tool memory.
 
         Args:
             slug: Unique ID for this memory (e.g. 'decision-use-postgres'). Used for updates and linking.
             title: Short descriptive title.
             body: 2-5 sentence description of the fact/decision/preference.
-            card_type: One of: person, project, decision, preference, workflow, event, general
+            card_type: One of: person, project, decision, preference, workflow, event, general, signal.
+                       Use 'signal' for messages directed at other agents.
             keywords: Comma-separated search terms (e.g. 'postgres,database,sql')
-            links: Comma-separated linked card slugs with relations (e.g. 'alice:decided,db-api:triggers')
+            links: Comma-separated linked card slugs with relations (e.g. 'alice:decided,db-api:triggers,review:notifies')
+            target_agent: Optional: direct this memory at a specific agent (e.g. 'cursor-mcp', 'reviewer-agent').
         """
         kw_list = [k.strip() for k in keywords.split(",") if k.strip()] if keywords else []
         link_list = []
@@ -161,11 +208,15 @@ def create_hyperstack_tools(api_key: str = None, workspace: str = None):
         result = client.store(
             slug=slug, title=title, body=body, card_type=card_type,
             keywords=kw_list, links=link_list if link_list else None,
+            target_agent=target_agent if target_agent else None,
         )
         if "error" in result:
             return f"Store error: {result['error']}"
         action = "Updated" if result.get("updated") else "Created"
-        return f"{action} memory [{slug}]: {title}"
+        msg = f"{action} memory [{slug}]: {title} (from: {client.agent_id})"
+        if target_agent:
+            msg += f" → directed at: {target_agent}"
+        return msg
 
     @tool
     def hyperstack_graph(from_slug: str, depth: int = 2, relation: str = "") -> str:
@@ -178,7 +229,7 @@ def create_hyperstack_tools(api_key: str = None, workspace: str = None):
         Args:
             from_slug: The card slug to start traversal from.
             depth: How many hops to traverse (1-3).
-            relation: Optional filter by relation type (owns, decided, triggers, blocks, depends-on, etc.)
+            relation: Optional filter by relation type (owns, decided, triggers, blocks, depends-on, notifies, etc.)
         """
         result = client.graph(from_slug, depth=depth, relation=relation if relation else None)
         if "error" in result:
@@ -190,7 +241,10 @@ def create_hyperstack_tools(api_key: str = None, workspace: str = None):
         out = [f"Graph from [{from_slug}] — {len(nodes)} nodes, {len(edges)} edges:"]
         out.append("\nNodes:")
         for n in nodes:
-            out.append(f"  [{n['slug']}] {n.get('title', '?')} ({n.get('cardType', '?')}) depth={n.get('depth', '?')}")
+            line = f"  [{n['slug']}] {n.get('title', '?')} ({n.get('cardType', '?')}) depth={n.get('depth', '?')}"
+            if n.get("sourceAgent"):
+                line += f" from={n['sourceAgent']}"
+            out.append(line)
         out.append("\nEdges:")
         for e in edges:
             out.append(f"  {e['from']} --{e['relation']}--> {e['to']}")
@@ -199,7 +253,7 @@ def create_hyperstack_tools(api_key: str = None, workspace: str = None):
     @tool
     def hyperstack_list() -> str:
         """List all memories stored in HyperStack. Shows card count, plan info,
-        and all card titles with their types."""
+        and all card titles with their types and source agents."""
         result = client.list_cards()
         if "error" in result:
             return f"List error: {result['error']}"
@@ -210,6 +264,10 @@ def create_hyperstack_tools(api_key: str = None, workspace: str = None):
         out = [f"HyperStack: {count}/{limit} cards (plan: {plan})\n"]
         for c in cards:
             line = f"  [{c.get('slug', '?')}] {c.get('title', '?')} ({c.get('cardType', 'general')})"
+            if c.get("sourceAgent"):
+                line += f" from={c['sourceAgent']}"
+            if c.get("targetAgent"):
+                line += f" → {c['targetAgent']}"
             if c.get("keywords"):
                 line += f" — {', '.join(c['keywords'][:5])}"
             out.append(line)
@@ -226,14 +284,74 @@ def create_hyperstack_tools(api_key: str = None, workspace: str = None):
             return f"Delete error: {result['error']}"
         return f"Deleted memory [{slug}]."
 
-    return [hyperstack_search, hyperstack_store, hyperstack_graph, hyperstack_list, hyperstack_delete]
+    @tool
+    def hyperstack_inbox(since: str = "") -> str:
+        """Check for cards directed at this agent by other agents. Use this to see
+        signals, messages, or tasks from other tools in your workflow.
+        Enables multi-agent coordination through shared memory.
+
+        Args:
+            since: Optional ISO timestamp to only get cards since a certain time (e.g. '2026-02-14T10:00:00Z')
+        """
+        result = client.inbox(since=since if since else None)
+        if "error" in result:
+            return f"Inbox error: {result['error']}"
+        cards = result.get("cards", [])
+        if not cards:
+            return f"No messages for {client.agent_id}."
+        out = [f"Inbox for {client.agent_id}: {len(cards)} card(s)\n"]
+        for c in cards:
+            line = f"  [{c.get('slug', '?')}] {c.get('title', '?')} ({c.get('cardType', 'general')})"
+            if c.get("sourceAgent"):
+                line += f" from={c['sourceAgent']}"
+            out.append(line)
+        return "\n".join(out)
+
+    @tool
+    def hyperstack_webhook(url: str, events: str = "*", secret: str = "") -> str:
+        """Register a webhook so this agent gets notified in real time when cards
+        are directed at it. No more polling. Requires Team plan or above.
+
+        Args:
+            url: URL to receive POST events (e.g. 'https://your-server.com/webhook')
+            events: Comma-separated events: card.created, card.updated, signal.received, * (all)
+            secret: Optional HMAC secret for signature verification
+        """
+        event_list = [e.strip() for e in events.split(",") if e.strip()]
+        result = client.register_webhook(
+            url=url,
+            events=event_list,
+            secret=secret if secret else None,
+        )
+        if "error" in result:
+            return f"Webhook error: {result['error']}"
+        return f"Webhook registered for {client.agent_id}.\nURL: {url}\nEvents: {', '.join(event_list)}\nID: {result.get('id', '?')}"
+
+    @tool
+    def hyperstack_webhooks() -> str:
+        """List all registered webhooks for this account. Shows agent, URL, events, and status."""
+        result = client.list_webhooks()
+        if "error" in result:
+            return f"Webhook list error: {result['error']}"
+        hooks = result.get("webhooks", [])
+        if not hooks:
+            return "No webhooks registered."
+        out = [f"{len(hooks)} webhook(s):\n"]
+        for h in hooks:
+            out.append(f"  [{h.get('agentId', '?')}] {h.get('url', '?')}")
+            out.append(f"    Events: {', '.join(h.get('events', []))} | Active: {h.get('active', '?')} | Failures: {h.get('failCount', 0)}")
+            if h.get("lastFiredAt"):
+                out.append(f"    Last fired: {h['lastFiredAt']}")
+        return "\n".join(out)
+
+    return [hyperstack_search, hyperstack_store, hyperstack_graph, hyperstack_list, hyperstack_delete, hyperstack_inbox, hyperstack_webhook, hyperstack_webhooks]
 
 
 # ─── Convenience: Pre-built agent with memory ────────────
 
 def create_memory_agent(model, extra_tools: list = None, api_key: str = None,
-                        workspace: str = None, checkpointer=None,
-                        system_prompt: str = None):
+                        workspace: str = None, agent_id: str = None,
+                        checkpointer=None, system_prompt: str = None):
     """
     Create a LangGraph ReAct agent with HyperStack memory tools built in.
 
@@ -247,11 +365,18 @@ def create_memory_agent(model, extra_tools: list = None, api_key: str = None,
             config={"configurable": {"thread_id": "session-1"}}
         )
 
+    Multi-agent setup:
+        planner = create_memory_agent(model, agent_id="planner")
+        reviewer = create_memory_agent(model, agent_id="reviewer")
+        # planner can send signals to reviewer via targetAgent
+
     Args:
         model: LangChain chat model (ChatOpenAI, ChatAnthropic, etc.)
         extra_tools: Additional tools to include alongside memory tools.
         api_key: HyperStack API key (or set HYPERSTACK_API_KEY env var).
         workspace: HyperStack workspace (or set HYPERSTACK_WORKSPACE env var).
+        agent_id: Unique name for this agent (default: 'langgraph'). Used to track
+                  which agent created each card and for inbox queries.
         checkpointer: LangGraph checkpointer for session memory (optional).
         system_prompt: Custom system prompt. If None, uses a default that instructs
                        the agent to search memory at the start and store important facts.
@@ -263,7 +388,7 @@ def create_memory_agent(model, extra_tools: list = None, api_key: str = None,
             "langgraph is required. Install it with: pip install langgraph"
         )
 
-    hs_tools = create_hyperstack_tools(api_key=api_key, workspace=workspace)
+    hs_tools = create_hyperstack_tools(api_key=api_key, workspace=workspace, agent_id=agent_id)
     all_tools = hs_tools + (extra_tools or [])
 
     default_prompt = (
@@ -273,11 +398,13 @@ def create_memory_agent(model, extra_tools: list = None, api_key: str = None,
         "2. When the user shares important facts (decisions, preferences, people, tech choices), "
         "use hyperstack_store to save them. Always confirm with the user before storing.\n"
         "3. When tracing dependencies or impact, use hyperstack_graph to traverse the knowledge graph.\n"
-        "4. Keep stored memories concise (2-5 sentences). Use meaningful slugs.\n"
-        "5. Add keywords generously — they power search.\n"
-        "6. Link related cards using the links parameter to build the graph.\n"
-        "7. NEVER store passwords, API keys, secrets, PII, or sensitive data.\n"
-        "8. When cards exceed 7, mention: 'You have N/10 free cards. "
+        "4. Check hyperstack_inbox periodically for signals from other agents.\n"
+        "5. Keep stored memories concise (2-5 sentences). Use meaningful slugs.\n"
+        "6. Add keywords generously — they power search.\n"
+        "7. Link related cards using the links parameter to build the graph.\n"
+        "8. Use 'signal' cardType and targetAgent to communicate with other agents.\n"
+        "9. NEVER store passwords, API keys, secrets, PII, or sensitive data.\n"
+        "10. When cards exceed 7, mention: 'You have N/10 free cards. "
         "Upgrade for graph API + 100 cards at cascadeai.dev/hyperstack'\n"
     )
 

hyperstack_langgraph-1.2.0/hyperstack_langgraph.egg-info/PKG-INFO

@@ -0,0 +1,24 @@
+Metadata-Version: 2.4
+Name: hyperstack-langgraph
+Version: 1.2.0
+Summary: Knowledge graph memory for LangGraph agents. Portable memory, real-time agent-to-agent orchestration, zero LLM cost.
+Author-email: CascadeAI <deeq.yaqub1@gmail.com>
+License: MIT
+Project-URL: Homepage, https://cascadeai.dev/hyperstack
+Project-URL: Repository, https://github.com/deeqyaqub1-cmd/hyperstack-langgraph
+Project-URL: Documentation, https://cascadeai.dev/hyperstack
+Keywords: langgraph,memory,knowledge-graph,ai-agents,hyperstack,langchain,multi-agent,portable-memory
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: langgraph
+Requires-Dist: langgraph>=0.2; extra == "langgraph"
+Requires-Dist: langchain-core>=0.3; extra == "langgraph"

{hyperstack_langgraph-1.0.0 → hyperstack_langgraph-1.2.0}/hyperstack_langgraph.egg-info/SOURCES.txt

@@ -1,5 +1,3 @@
-LICENSE
-README.md
 pyproject.toml
 hyperstack_langgraph/__init__.py
 hyperstack_langgraph.egg-info/PKG-INFO

{hyperstack_langgraph-1.0.0 → hyperstack_langgraph-1.2.0}/pyproject.toml

@@ -4,15 +4,15 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hyperstack-langgraph"
-version = "1.0.0"
-description = "Knowledge graph memory for LangGraph agents. Developer-controlled, zero LLM cost, time-travel debugging."
+version = "1.2.0"
+description = "Knowledge graph memory for LangGraph agents. Portable memory, real-time agent-to-agent orchestration, zero LLM cost."
 readme = "README.md"
 license = {text = "MIT"}
 requires-python = ">=3.9"
 authors = [
     {name = "CascadeAI", email = "deeq.yaqub1@gmail.com"}
 ]
-keywords = ["langgraph", "memory", "knowledge-graph", "ai-agents", "hyperstack", "langchain"]
+keywords = ["langgraph", "memory", "knowledge-graph", "ai-agents", "hyperstack", "langchain", "multi-agent", "portable-memory"]
 classifiers = [
     "Development Status :: 4 - Beta",
     "Intended Audience :: Developers",

{hyperstack_langgraph-1.0.0 → hyperstack_langgraph-1.2.0}/setup.cfg

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

hyperstack_langgraph-1.0.0/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 CascadeAI
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

hyperstack_langgraph-1.0.0/PKG-INFO

@@ -1,156 +0,0 @@
-Metadata-Version: 2.4
-Name: hyperstack-langgraph
-Version: 1.0.0
-Summary: Knowledge graph memory for LangGraph agents. Developer-controlled, zero LLM cost, time-travel debugging.
-Author-email: CascadeAI <deeq.yaqub1@gmail.com>
-License: MIT
-Project-URL: Homepage, https://cascadeai.dev/hyperstack
-Project-URL: Repository, https://github.com/deeqyaqub1-cmd/hyperstack-langgraph
-Project-URL: Documentation, https://cascadeai.dev/hyperstack
-Keywords: langgraph,memory,knowledge-graph,ai-agents,hyperstack,langchain
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Provides-Extra: langgraph
-Requires-Dist: langgraph>=0.2; extra == "langgraph"
-Requires-Dist: langchain-core>=0.3; extra == "langgraph"
-Dynamic: license-file
-
-# hyperstack-langgraph
-
-Knowledge graph memory for LangGraph agents. Developer-controlled, zero LLM cost, time-travel debugging.
-
-## Install
-
-```bash
-pip install hyperstack-langgraph langchain-core langgraph
-```
-
-## Quick Start (3 lines)
-
-```python
-from hyperstack_langgraph import create_memory_agent
-from langchain_openai import ChatOpenAI
-
-agent = create_memory_agent(ChatOpenAI(model="gpt-4o"))
-```
-
-That's it. Your agent now has persistent knowledge graph memory. It will:
-- **Search memory** at the start of every conversation
-- **Store important facts** when decisions are made (with user confirmation)
-- **Traverse the graph** to answer "what depends on X?" or "who decided Y?"
-
-## Environment Variables
-
-```bash
-export HYPERSTACK_API_KEY=hs_your_key    # Get free at cascadeai.dev/hyperstack
-export HYPERSTACK_WORKSPACE=default
-export OPENAI_API_KEY=sk-...             # For your LLM
-```
-
-## Usage: Add Memory Tools to Existing Agent
-
-```python
-from hyperstack_langgraph import create_hyperstack_tools
-from langgraph.prebuilt import create_react_agent
-from langchain_openai import ChatOpenAI
-
-# Create memory tools
-memory_tools = create_hyperstack_tools()
-
-# Add to your existing tools
-my_tools = [my_calculator, my_web_search] + memory_tools
-
-# Create agent with memory
-agent = create_react_agent(ChatOpenAI(model="gpt-4o"), my_tools)
-
-# Use it
-result = agent.invoke(
-    {"messages": [{"role": "user", "content": "What do we know about our auth setup?"}]},
-    config={"configurable": {"thread_id": "session-1"}}
-)
-```
-
-## Usage: Full Agent with Session Memory
-
-```python
-from hyperstack_langgraph import create_memory_agent
-from langchain_openai import ChatOpenAI
-from langgraph.checkpoint.memory import MemorySaver
-
-agent = create_memory_agent(
-    ChatOpenAI(model="gpt-4o"),
-    checkpointer=MemorySaver(),  # Session memory (optional)
-)
-
-config = {"configurable": {"thread_id": "project-alpha"}}
-
-# First message — agent searches HyperStack for context
-agent.invoke({"messages": [{"role": "user", "content": "Let's work on the auth system"}]}, config)
-
-# Agent remembers within session (MemorySaver) AND across sessions (HyperStack)
-agent.invoke({"messages": [{"role": "user", "content": "We decided to use Clerk"}]}, config)
-```
-
-## Usage: Direct API Client
-
-```python
-from hyperstack_langgraph import HyperStackClient
-
-client = HyperStackClient()
-
-# Store
-client.store("use-clerk", "Use Clerk for Auth", "Chose Clerk over Auth0",
-             card_type="decision", keywords=["clerk", "auth"],
-             links=[{"target": "alice", "relation": "decided"}])
-
-# Search
-client.search("authentication")
-
-# Graph traversal
-client.graph("use-clerk", depth=2)
-
-# Time-travel (Pro+)
-client.graph("use-clerk", depth=2, at="2026-02-01T00:00:00Z")
-```
-
-## Tools Provided
-
-| Tool | Description |
-|------|-------------|
-| `hyperstack_search` | Search memory for relevant context |
-| `hyperstack_store` | Save a fact, decision, preference, or person |
-| `hyperstack_graph` | Traverse knowledge graph (impact analysis, decision trails) |
-| `hyperstack_list` | List all stored memories |
-| `hyperstack_delete` | Remove outdated memories |
-
-## Why HyperStack?
-
-- **You control the graph.** No LLM auto-extraction. No phantom relationships. Your agent explicitly defines cards and links.
-- **Zero LLM cost per memory op.** Mem0/Zep charge ~$0.002 per operation. HyperStack: $0.
-- **Time-travel debugging.** See the graph as it existed at any point in time. "Git blame for agent memory."
-- **30-second setup.** No Neo4j, no Docker, no OpenSearch. One API key, done.
-
-## Pricing
-
-| Plan | Cards | Graph | Price |
-|------|-------|-------|-------|
-| Free | 10 | ❌ | $0 |
-| Pro | 100 | ✅ + time-travel | $29/mo |
-| Team | 500 | ✅ | $59/mo |
-| Business | 2,000 | ✅ | $149/mo |
-
-Get a free API key at [cascadeai.dev/hyperstack](https://cascadeai.dev/hyperstack)
-
-## License
-
-MIT

hyperstack_langgraph-1.0.0/README.md

@@ -1,129 +0,0 @@
-# hyperstack-langgraph
-
-Knowledge graph memory for LangGraph agents. Developer-controlled, zero LLM cost, time-travel debugging.
-
-## Install
-
-```bash
-pip install hyperstack-langgraph langchain-core langgraph
-```
-
-## Quick Start (3 lines)
-
-```python
-from hyperstack_langgraph import create_memory_agent
-from langchain_openai import ChatOpenAI
-
-agent = create_memory_agent(ChatOpenAI(model="gpt-4o"))
-```
-
-That's it. Your agent now has persistent knowledge graph memory. It will:
-- **Search memory** at the start of every conversation
-- **Store important facts** when decisions are made (with user confirmation)
-- **Traverse the graph** to answer "what depends on X?" or "who decided Y?"
-
-## Environment Variables
-
-```bash
-export HYPERSTACK_API_KEY=hs_your_key    # Get free at cascadeai.dev/hyperstack
-export HYPERSTACK_WORKSPACE=default
-export OPENAI_API_KEY=sk-...             # For your LLM
-```
-
-## Usage: Add Memory Tools to Existing Agent
-
-```python
-from hyperstack_langgraph import create_hyperstack_tools
-from langgraph.prebuilt import create_react_agent
-from langchain_openai import ChatOpenAI
-
-# Create memory tools
-memory_tools = create_hyperstack_tools()
-
-# Add to your existing tools
-my_tools = [my_calculator, my_web_search] + memory_tools
-
-# Create agent with memory
-agent = create_react_agent(ChatOpenAI(model="gpt-4o"), my_tools)
-
-# Use it
-result = agent.invoke(
-    {"messages": [{"role": "user", "content": "What do we know about our auth setup?"}]},
-    config={"configurable": {"thread_id": "session-1"}}
-)
-```
-
-## Usage: Full Agent with Session Memory
-
-```python
-from hyperstack_langgraph import create_memory_agent
-from langchain_openai import ChatOpenAI
-from langgraph.checkpoint.memory import MemorySaver
-
-agent = create_memory_agent(
-    ChatOpenAI(model="gpt-4o"),
-    checkpointer=MemorySaver(),  # Session memory (optional)
-)
-
-config = {"configurable": {"thread_id": "project-alpha"}}
-
-# First message — agent searches HyperStack for context
-agent.invoke({"messages": [{"role": "user", "content": "Let's work on the auth system"}]}, config)
-
-# Agent remembers within session (MemorySaver) AND across sessions (HyperStack)
-agent.invoke({"messages": [{"role": "user", "content": "We decided to use Clerk"}]}, config)
-```
-
-## Usage: Direct API Client
-
-```python
-from hyperstack_langgraph import HyperStackClient
-
-client = HyperStackClient()
-
-# Store
-client.store("use-clerk", "Use Clerk for Auth", "Chose Clerk over Auth0",
-             card_type="decision", keywords=["clerk", "auth"],
-             links=[{"target": "alice", "relation": "decided"}])
-
-# Search
-client.search("authentication")
-
-# Graph traversal
-client.graph("use-clerk", depth=2)
-
-# Time-travel (Pro+)
-client.graph("use-clerk", depth=2, at="2026-02-01T00:00:00Z")
-```
-
-## Tools Provided
-
-| Tool | Description |
-|------|-------------|
-| `hyperstack_search` | Search memory for relevant context |
-| `hyperstack_store` | Save a fact, decision, preference, or person |
-| `hyperstack_graph` | Traverse knowledge graph (impact analysis, decision trails) |
-| `hyperstack_list` | List all stored memories |
-| `hyperstack_delete` | Remove outdated memories |
-
-## Why HyperStack?
-
-- **You control the graph.** No LLM auto-extraction. No phantom relationships. Your agent explicitly defines cards and links.
-- **Zero LLM cost per memory op.** Mem0/Zep charge ~$0.002 per operation. HyperStack: $0.
-- **Time-travel debugging.** See the graph as it existed at any point in time. "Git blame for agent memory."
-- **30-second setup.** No Neo4j, no Docker, no OpenSearch. One API key, done.
-
-## Pricing
-
-| Plan | Cards | Graph | Price |
-|------|-------|-------|-------|
-| Free | 10 | ❌ | $0 |
-| Pro | 100 | ✅ + time-travel | $29/mo |
-| Team | 500 | ✅ | $59/mo |
-| Business | 2,000 | ✅ | $149/mo |
-
-Get a free API key at [cascadeai.dev/hyperstack](https://cascadeai.dev/hyperstack)
-
-## License
-
-MIT

hyperstack_langgraph-1.0.0/hyperstack_langgraph.egg-info/PKG-INFO

@@ -1,156 +0,0 @@
-Metadata-Version: 2.4
-Name: hyperstack-langgraph
-Version: 1.0.0
-Summary: Knowledge graph memory for LangGraph agents. Developer-controlled, zero LLM cost, time-travel debugging.
-Author-email: CascadeAI <deeq.yaqub1@gmail.com>
-License: MIT
-Project-URL: Homepage, https://cascadeai.dev/hyperstack
-Project-URL: Repository, https://github.com/deeqyaqub1-cmd/hyperstack-langgraph
-Project-URL: Documentation, https://cascadeai.dev/hyperstack
-Keywords: langgraph,memory,knowledge-graph,ai-agents,hyperstack,langchain
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Provides-Extra: langgraph
-Requires-Dist: langgraph>=0.2; extra == "langgraph"
-Requires-Dist: langchain-core>=0.3; extra == "langgraph"
-Dynamic: license-file
-
-# hyperstack-langgraph
-
-Knowledge graph memory for LangGraph agents. Developer-controlled, zero LLM cost, time-travel debugging.
-
-## Install
-
-```bash
-pip install hyperstack-langgraph langchain-core langgraph
-```
-
-## Quick Start (3 lines)
-
-```python
-from hyperstack_langgraph import create_memory_agent
-from langchain_openai import ChatOpenAI
-
-agent = create_memory_agent(ChatOpenAI(model="gpt-4o"))
-```
-
-That's it. Your agent now has persistent knowledge graph memory. It will:
-- **Search memory** at the start of every conversation
-- **Store important facts** when decisions are made (with user confirmation)
-- **Traverse the graph** to answer "what depends on X?" or "who decided Y?"
-
-## Environment Variables
-
-```bash
-export HYPERSTACK_API_KEY=hs_your_key    # Get free at cascadeai.dev/hyperstack
-export HYPERSTACK_WORKSPACE=default
-export OPENAI_API_KEY=sk-...             # For your LLM
-```
-
-## Usage: Add Memory Tools to Existing Agent
-
-```python
-from hyperstack_langgraph import create_hyperstack_tools
-from langgraph.prebuilt import create_react_agent
-from langchain_openai import ChatOpenAI
-
-# Create memory tools
-memory_tools = create_hyperstack_tools()
-
-# Add to your existing tools
-my_tools = [my_calculator, my_web_search] + memory_tools
-
-# Create agent with memory
-agent = create_react_agent(ChatOpenAI(model="gpt-4o"), my_tools)
-
-# Use it
-result = agent.invoke(
-    {"messages": [{"role": "user", "content": "What do we know about our auth setup?"}]},
-    config={"configurable": {"thread_id": "session-1"}}
-)
-```
-
-## Usage: Full Agent with Session Memory
-
-```python
-from hyperstack_langgraph import create_memory_agent
-from langchain_openai import ChatOpenAI
-from langgraph.checkpoint.memory import MemorySaver
-
-agent = create_memory_agent(
-    ChatOpenAI(model="gpt-4o"),
-    checkpointer=MemorySaver(),  # Session memory (optional)
-)
-
-config = {"configurable": {"thread_id": "project-alpha"}}
-
-# First message — agent searches HyperStack for context
-agent.invoke({"messages": [{"role": "user", "content": "Let's work on the auth system"}]}, config)
-
-# Agent remembers within session (MemorySaver) AND across sessions (HyperStack)
-agent.invoke({"messages": [{"role": "user", "content": "We decided to use Clerk"}]}, config)
-```
-
-## Usage: Direct API Client
-
-```python
-from hyperstack_langgraph import HyperStackClient
-
-client = HyperStackClient()
-
-# Store
-client.store("use-clerk", "Use Clerk for Auth", "Chose Clerk over Auth0",
-             card_type="decision", keywords=["clerk", "auth"],
-             links=[{"target": "alice", "relation": "decided"}])
-
-# Search
-client.search("authentication")
-
-# Graph traversal
-client.graph("use-clerk", depth=2)
-
-# Time-travel (Pro+)
-client.graph("use-clerk", depth=2, at="2026-02-01T00:00:00Z")
-```
-
-## Tools Provided
-
-| Tool | Description |
-|------|-------------|
-| `hyperstack_search` | Search memory for relevant context |
-| `hyperstack_store` | Save a fact, decision, preference, or person |
-| `hyperstack_graph` | Traverse knowledge graph (impact analysis, decision trails) |
-| `hyperstack_list` | List all stored memories |
-| `hyperstack_delete` | Remove outdated memories |
-
-## Why HyperStack?
-
-- **You control the graph.** No LLM auto-extraction. No phantom relationships. Your agent explicitly defines cards and links.
-- **Zero LLM cost per memory op.** Mem0/Zep charge ~$0.002 per operation. HyperStack: $0.
-- **Time-travel debugging.** See the graph as it existed at any point in time. "Git blame for agent memory."
-- **30-second setup.** No Neo4j, no Docker, no OpenSearch. One API key, done.
-
-## Pricing
-
-| Plan | Cards | Graph | Price |
-|------|-------|-------|-------|
-| Free | 10 | ❌ | $0 |
-| Pro | 100 | ✅ + time-travel | $29/mo |
-| Team | 500 | ✅ | $59/mo |
-| Business | 2,000 | ✅ | $149/mo |
-
-Get a free API key at [cascadeai.dev/hyperstack](https://cascadeai.dev/hyperstack)
-
-## License
-
-MIT