solana-agent 7.0.0__py3-none-any.whl → 8.0.1__py3-none-any.whl

solana_agent-8.0.1.dist-info/METADATA

@@ -0,0 +1,248 @@
+Metadata-Version: 2.3
+Name: solana-agent
+Version: 8.0.1
+Summary: The first AGI framework
+License: MIT
+Keywords: ai,openai,ai agents,agi
+Author: Bevan Hunt
+Author-email: bevan@bevanhunt.com
+Requires-Python: >=3.9,<4.0
+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: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Dist: ntplib (>=0.4.0,<0.5.0)
+Requires-Dist: openai (>=1.65.3,<2.0.0)
+Requires-Dist: pandas (>=2.2.3,<3.0.0)
+Requires-Dist: pinecone (>=6.0.1,<7.0.0)
+Requires-Dist: pydantic (>=2.10.6,<3.0.0)
+Requires-Dist: pymongo (>=4.11.2,<5.0.0)
+Requires-Dist: requests (>=2.32.3,<3.0.0)
+Requires-Dist: zep-cloud (>=2.5.0,<3.0.0)
+Requires-Dist: zep-python (>=2.0.2,<3.0.0)
+Project-URL: Repository, https://github.com/truemagic-coder/solana-agent
+Description-Content-Type: text/markdown
+
+# Solana Agent
+
+[![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Python 3.9+](https://img.shields.io/badge/python-3.9+-orange.svg)](https://www.python.org/downloads/)
+
+![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
+
+## Why Solana Agent?
+
+Reinventing Organizational Structures Through AI  
+Solana Agent isn't just an AI framework—it's the foundation for reimagining how humans organize, collaborate, and create value together. Build organizations that transcend traditional hierarchies and unlock collective intelligence at scale.
+
+### The Future of Work Starts Here:
+
+- **Decentralized Decision Making:**  
+    Enable distributed expertise through AI-human collaboration, removing bottlenecks and centralizing only the mission, not the authority.
+
+- **Organization as Living Code:**  
+    Define your organization's values, expertise boundaries, and operating principles in code, making structure transparent and adaptable.
+
+- **Fluid Collaboration Networks:**  
+    Replace rigid hierarchies with dynamic agent networks that form, collaborate, and dissolve based on real-time needs.
+
+- **Knowledge as Collective Asset:**  
+    Transform individual expertise into organizational intelligence through autonomous knowledge extraction and distribution.
+
+- **Permissionless Value Creation:**  
+    Let agents (both AI and human) contribute and innovate freely within guardrails defined by mission and values, not management layers.
+
+## The Future of Work
+
+Solana Agent enables a paradigm shift in how work gets done:
+
+- **Beyond Human Resource Constraints:**  
+    Scale knowledge work infinitely by combining specialized AI agents with human experts.
+- **Continuous 24/7 Operations:**  
+    Organizational functions that never sleep, never burn out, and continuously learn.
+- **Task-Agent Fit Optimization:**  
+    Matching work to the ideal agent (human or AI) based on real-time expertise mapping.
+- **Ambient Organizational Intelligence:**  
+    Collective knowledge that grows, refines, and distributes itself autonomously.
+- **From Managers to Facilitators:**  
+    Human roles shift from directing work to defining outcomes and improving agent capabilities.
+- **Permissionless Contribution:**  
+    Anyone can interact with and extend the organization through standardized interfaces.
+
+## Organization as Code
+
+With Solana Agent, your organizational design becomes explicit, observable, and iteratively improvable:
+
+- **Declarative Organizational Structure:**  
+    Define your entire organization's capabilities through agent specializations and interaction patterns.
+- **Version-Controlled Operational Logic:**  
+    Track organizational evolution and performance through code changes.
+- **Mission Function:**  
+    Encode organizational values and goals as executable functions that guide all agent decisions.
+- **Rapid Organizational Experiments:**  
+    Test new structures, policies, and collaborative patterns without disruptive reorganizations.
+- **Transparency by Default:**  
+    Make decision boundaries and expertise domains explicit in code rather than hidden in hierarchy.
+- **Self-Documenting Operations:**  
+    The organization continuously documents its own functions, decisions, and knowledge.
+
+## Decentralized Organization
+
+Solana Agent provides the infrastructure to build truly decentralized organizations:
+
+- **Multi-Node Intelligence:**  
+    Distribute cognitive load across specialized agents with no central controller.
+- **Autonomous Coordination:**  
+    Agents self-organize based on capabilities and availability without central dispatching.
+- **Edge Decision Making:**  
+    Push decisions to the agents closest to the information and expertise needed.
+- **Resilient Architecture:**  
+    No single point of failure in organizational knowledge or operational capacity.
+- **Emergent Problem Solving:**  
+    Solutions emerge from collaborative agent interactions rather than top-down directives.
+- **Fractal Scaling:**  
+    Add new domains of expertise by replicating the agent swarm pattern without hierarchical constraints.
+
+## Complete Flat Organization
+
+Eliminate management hierarchies while maintaining coordination and alignment:
+
+- **Mission-Driven Alignment:**  
+    All agents align through shared values and outcomes defined in the unified mission framework.
+- **Peer-to-Peer Handoffs:**  
+    Both AI and human agents coordinate as equals through standardized interfaces.
+- **Expertise-Based Authority:**  
+    Influence derives from demonstrable expertise rather than position.
+- **Universal Access Protocol:**  
+    Consistent interfaces for interacting with any part of the organization.
+- **Transparent Contribution Tracking:**  
+    Meritocratic recognition of value creation across the network.
+- **Adaptive Resource Allocation:**  
+    Direct resources to high-impact areas without bureaucratic approval chains.
+
+## Technical Features
+
+- **🗣️ Advanced Interaction Layer:**  
+    Streaming text-based conversations with real-time thinking.  
+    Voice-to-voice conversations with natural cadence.  
+    Multi-turn context preservation and reasoning.
+
+- **🤖 Multi-Agent Swarm Architecture:**  
+    Dynamic specialized agent creation and coordination.  
+    Intelligent routing based on query content and agent expertise.  
+    Seamless handoffs with comprehensive context passing.  
+    Shared memory and collective intelligence across the entire swarm.
+
+- **👥 Human-AI Collaboration:**  
+    Hybrid AI-human collaboration system with seamless handoffs.  
+    Ticket management for complex or sensitive inquiries.  
+    Multiple handoff patterns (AI↔human, human↔human).  
+    In-chat command system for human agents to manage tickets.  
+    Availability status management for human operators.
+
+- **🧠 Distributed Intelligence Capabilities:**  
+    Cross-domain knowledge integration from multiple sources.  
+    Self-organizing information architecture.  
+    Autonomous knowledge extraction and refinement.  
+    Time-aware contextual responses.  
+    Self-critical improvement systems.
+
+- **🛡️ Governance Framework:**  
+    Define organization-wide values and operating principles in code.  
+    Consistent decision-making aligned with organizational priorities.  
+    Privacy-preserving knowledge sharing with configurable controls.  
+    Transparent insight extraction with review capabilities.  
+    Performance analytics across the agent network.
+
+## Implementation Technologies
+
+Solana Agent leverages multiple technologies to enable these capabilities:
+
+- **Knowledge Integration:**  
+    Perplexity API, X/Twitter (Grok API), Zep memory, Pinecone vector search.
+- **Collaborative Intelligence:**  
+    Multi-agent swarm architecture with specialized expertise domains.
+- **Human-AI Teaming:**  
+    Integrated ticketing, notification systems, and real-time handoffs.
+- **Organization Alignment:**  
+    Unified mission framework, critic system, and collective memory.
+
+## Installation
+
+You can install Solana Agent using pip:
+
+`pip install solana-agent`
+
+## Documentation
+
+Each public method has a docstring for real-time IDE hinting.
+
+## Production Apps
+
+- **CometHeart:**  
+    AI Companion and Business Coach on mobile using voice-to-voice conversations.
+
+## Example Setup
+
+```python
+# Create a decentralized organizational structure
+from solana_agent import Swarm, AI, MongoDatabase
+
+# Initialize the organizational database
+db = MongoDatabase(db_url="mongodb://localhost:27017", db_name="organization_brain")
+
+# Define the organization's mission and values
+mission = """Our organization maximizes collective intelligence through 
+transparent collaboration between humans and AI. We value truth, 
+clarity, and continuous improvement in all interactions."""
+
+# Create the organizational swarm
+org = Swarm(
+    database=db,
+    directive=mission,
+)
+
+# Register AI expertise domains
+org.register(
+    name="knowledge_worker",
+    agent=AI(
+        openai_api_key="key",
+        instructions="You are an expert in research and knowledge synthesis...",
+        database=db
+    ),
+    specialization="Research, analysis, and knowledge synthesis"
+)
+
+org.register(
+    name="customer_interface",
+    agent=AI(
+        openai_api_key="key",
+        instructions="You handle customer inquiries with empathy and clarity...",
+        database=db
+    ),
+    specialization="Customer interaction and support"
+)
+
+# Register human expertise domains
+org.register_human_agent(
+    agent_id="human_expert_1",
+    name="Technical Specialist",
+    specialization="Advanced technical problem solving requiring human judgment",
+    notification_handler=email_notification
+)
+
+# Process work through the organization
+async for response in org.process("user123", "How can we optimize our supply chain?"):
+    print(response, end="")
+```
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+

solana_agent-8.0.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+solana_agent/__init__.py,sha256=zpfnWqANd3OHGWm7NCF5Y6m01BWG4NkNk8SK9Ex48nA,18
+solana_agent/ai.py,sha256=V-FnRpeelDXWFXtNo-nh2vJmokW-rh8YmMP0-ws5-AE,120530
+solana_agent-8.0.1.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
+solana_agent-8.0.1.dist-info/METADATA,sha256=ZV-kwsYBMRYTD-ijjrKZSs9gsfpubf6kc8iQlaiycck,10280
+solana_agent-8.0.1.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
+solana_agent-8.0.1.dist-info/RECORD,,

solana_agent-7.0.0.dist-info/METADATA

@@ -1,178 +0,0 @@
-Metadata-Version: 2.3
-Name: solana-agent
-Version: 7.0.0
-Summary: The first AGI framework
-License: MIT
-Keywords: ai,openai,ai agents,agi
-Author: Bevan Hunt
-Author-email: bevan@bevanhunt.com
-Requires-Python: >=3.9,<4.0
-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: Programming Language :: Python :: 3.13
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
-Requires-Dist: ntplib (>=0.4.0,<0.5.0)
-Requires-Dist: openai (>=1.65.2,<2.0.0)
-Requires-Dist: pandas (>=2.2.3,<3.0.0)
-Requires-Dist: pinecone (>=6.0.1,<7.0.0)
-Requires-Dist: pydantic (>=2.10.6,<3.0.0)
-Requires-Dist: pymongo (>=4.11.1,<5.0.0)
-Requires-Dist: requests (>=2.32.3,<3.0.0)
-Requires-Dist: zep-cloud (>=2.4.0,<3.0.0)
-Requires-Dist: zep-python (>=2.0.2,<3.0.0)
-Project-URL: Repository, https://github.com/truemagic-coder/solana-agent
-Description-Content-Type: text/markdown
-
-# Solana Agent
-
-[![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
-[![Python 3.9+](https://img.shields.io/badge/python-3.9+-orange.svg)](https://www.python.org/downloads/)
-
-![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
-
-## Why Solana Agent?
-
-### The First AGI Framework
-
-Solana Agent transforms AI from isolated conversations into a continuously evolving intelligence network powered by specialized agents that learn, remember, and grow smarter together.
-
-**Why This Matters for AGI:**
-
-- 🧠 **Emergent Intelligence:** Specialized agents form a neural network-like system where the whole exceeds the sum of its parts
-- 🔄 **Autonomous Self-Improvement:** Critic system analyzes responses, identifies weaknesses, and autonomously researches to fill knowledge gaps
-- 📈 **Exponential Learning:** Each interaction improves future responses through continuous feedback loops and pattern recognition
-- 🌐 **Distributed Cognition:** Problems are decomposed across specialized cognitive modules, mirroring human brain specialization
-- 🧩 **Knowledge Integration:** Synthesizes information across domains to form novel connections and insights
-- 🛠️ **Adaptive Problem-Solving**: Dynamically reconfigures approach based on task complexity and previous solution efficacy
-
-## Features
-
-### 🗣️ **Advanced Interaction Layer**
-- Streaming text-based conversations with real-time thinking
-- Voice-to-voice conversations with natural cadence
-- Multi-turn context preservation and reasoning
-
-### 🤖 **Multi-Agent Swarm Architecture**
-- Dynamic specialized agent creation and coordination
-- Intelligent routing based on query content and agent expertise
-- Seamless handoffs with comprehensive context passing
-- Parallel processing capabilities for complex multi-part questions
-- Shared memory and collective intelligence across the entire swarm
-
-### 🔍 **Multi-Source Knowledge Integration**
-- Real-time internet search via Perplexity API
-- Social media monitoring via X/Twitter (Grok API)
-- Long-term conversational memory with Zep's graph-based storage
-- Structured data analysis with CSV processing and summarization
-- Vector-based knowledge retrieval with semantic search via Pinecone
-- Hybrid search combining vector similarity and text relevance via MongoDB and Pinecone
-
-### 🌐 **Collective Swarm Intelligence**
-- Hybrid semantic-keyword search spanning all user interactions
-- Privacy-preserving knowledge extraction from conversations
-- Self-organizing knowledge base with automatic categorization
-- Cross-domain insight discovery and connection building
-- Autonomous knowledge refinement through verification tasks
-
-### 🕰️ **Time-Aware Intelligence**
-- User-specific timezone handling for personalized time references
-- Chronologically accurate responses across all conversations
-- Default timezone fallbacks at both agent and swarm levels
-- Seamless timezone preservation during agent handoffs
-
-### ⚖️ **Self-Critical System**
-- AI critic that evaluates agent responses for quality and accuracy
-- Autonomous identification of improvement areas across all agents
-- Prioritized feedback based on severity and impact
-- System-wide trend analysis to track collective improvement
-- Integrates feedback automatically to improve future answers
-
-### 🎯 **Unified Mission Framework**
-- Define organization-wide values, goals, and operating principles
-- Automatically applied to all agents in the swarm
-- Visually distinct formatting for clarity and emphasis
-- Consistent decision-making aligned with organizational priorities
-- Individual agent specializations work within the directive framework
-
-## Privacy and Collective Memory
-
-Solana Agent's collective memory system is designed with privacy in mind:
-
-- **Selective Knowledge Extraction**: Only factual, non-personal information is extracted
-- **Privacy Filtering**: The AI is instructed to exclude user-specific details, opinions, and sensitive information
-- **Optional Feature**: Easily disable collective memory with the `enable_collective_memory=False` parameter
-- **Transparency**: Extracted insights are accessible and reviewable
-- **Customizable Thresholds**: Adjust what qualifies as a valuable insight worth sharing
-
-When collective memory is enabled, the system extracts valuable factual knowledge that can benefit all users, while carefully avoiding personal or sensitive information. For environments with stricter privacy requirements, the feature can be completely disabled.
-
-## Time Awareness
-
-Solana Agent's time awareness system ensures your AI assistants always provide chronologically accurate responses based on each user's timezone:
-
-- **User-Based Time Context**: Pass user timezone directly in conversation requests
-- **Global Time Management**: Get precise time in any timezone using NTP synchronization
-- **Timezone Preservation**: Maintains timezone context during agent handoffs
-- **Default Fallbacks**: Configurable defaults at both agent and swarm levels
-- **Contextual Date Awareness**: All agents understand "today," "next week," or "in 3 days" relative to user's timezone
-
-## Why Choose Solana Agent Over LangChain?
-
-### 🎯 Key Differentiators
-
-#### 💡 **AGI-First Architecture**
-- Designed for autonomous intelligence and self-improvement
-- Framework for agents to improve themselves without human intervention
-
-#### 🧠 **Advanced Memory Architecture**
-- Sophisticated episodic and semantic memory vs. basic memory types
-- Cross-session knowledge retention with importance-based storage
-- Autonomous extraction of insights from conversations
-- Collective memory across users and agents
-
-#### 🤝 **True Multi-Agent Orchestration**
-- First-class swarm intelligence with specialized agent teams
-- Dynamic routing based on expertise and query complexity
-- Seamless context preservation during handoffs
-- Single unified interface for the entire agent ecosystem
-- Unified mission framework for consistent decision making
-
-#### 🏢 **Enterprise Production Readiness**
-- Deployment-ready with minimal configuration
-- Comprehensive error handling and recovery mechanisms
-- Scalable architecture supporting high-concurrency environments
-- Privacy-preserving design with configurable controls
-
-#### 🛠️ **Developer Experience**
-- Clean, intuitive API without excessive abstractions
-- Standard Python functions vs complex chaining constructs
-- Minimal boilerplate for common operations
-- ~1500 vs ~500,000 lines of code
-
-## Installation
-
-You can install Solana Agent using pip:
-
-```bash
-pip install solana-agent
-```
-
-## Documentation
-* Each public method has a docstring for real-time IDE hinting
-
-## Production Apps
-* [CometHeart](https://cometheart.com) - AI Companion and Business Coach on mobile using voice-to-voice conversations
-
-## Example Apps
-* [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app) - See as source of documentation
-
-## License
-
-This project is licensed under the MIT License - see the LICENSE file for details.
-

solana_agent-7.0.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-solana_agent/__init__.py,sha256=zpfnWqANd3OHGWm7NCF5Y6m01BWG4NkNk8SK9Ex48nA,18
-solana_agent/ai.py,sha256=dv2dR_nZeK3hyd1wdB9SojCpltGzlihId_-wWxKmz_E,86098
-solana_agent-7.0.0.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
-solana_agent-7.0.0.dist-info/METADATA,sha256=9pT5iO8zKiSR1YPVysanOVOs2mzur-MvqoTVHJ0qXQU,8351
-solana_agent-7.0.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
-solana_agent-7.0.0.dist-info/RECORD,,