solana-agent 8.0.3__py3-none-any.whl → 10.0.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: solana-agent
3
- Version: 8.0.3
4
- Summary: The first AGI framework
3
+ Version: 10.0.0
4
+ Summary: The Future of Work
5
5
  License: MIT
6
6
  Keywords: ai,openai,ai agents,agi
7
7
  Author: Bevan Hunt
@@ -17,11 +17,12 @@ Classifier: Programming Language :: Python :: 3.13
17
17
  Classifier: Programming Language :: Python :: 3 :: Only
18
18
  Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
19
19
  Requires-Dist: ntplib (>=0.4.0,<0.5.0)
20
- Requires-Dist: openai (>=1.65.3,<2.0.0)
20
+ Requires-Dist: openai (>=1.65.5,<2.0.0)
21
21
  Requires-Dist: pandas (>=2.2.3,<3.0.0)
22
22
  Requires-Dist: pinecone (>=6.0.1,<7.0.0)
23
23
  Requires-Dist: pydantic (>=2.10.6,<3.0.0)
24
24
  Requires-Dist: pymongo (>=4.11.2,<5.0.0)
25
+ Requires-Dist: qdrant-client (>=1.13.3,<2.0.0)
25
26
  Requires-Dist: requests (>=2.32.3,<3.0.0)
26
27
  Requires-Dist: zep-cloud (>=2.5.0,<3.0.0)
27
28
  Requires-Dist: zep-python (>=2.0.2,<3.0.0)
@@ -33,6 +34,8 @@ Description-Content-Type: text/markdown
33
34
  [![PyPI - Version](https://img.shields.io/pypi/v/solana-agent)](https://pypi.org/project/solana-agent/)
34
35
  [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
35
36
  [![Python 3.9+](https://img.shields.io/badge/python-3.9+-orange.svg)](https://www.python.org/downloads/)
37
+ [![codecov](https://img.shields.io/codecov/c/github/truemagic-coder/solana-agent/main.svg)](https://codecov.io/gh/truemagic-coder/solana-agent)
38
+ [![Build Status](https://img.shields.io/github/actions/workflow/status/truemagic-coder/solana-agent/test.yml?branch=main)](https://github.com/truemagic-coder/solana-agent/actions/workflows/test.yml)
36
39
 
37
40
  ![Solana Agent Logo](https://dl.walletbubbles.com/solana-agent-logo.png?width=200)
38
41
 
@@ -144,17 +147,20 @@ Solana Agent transforms organizations into living systems that continuously lear
144
147
  Identify trends invisible to individual actors through network-wide analysis.
145
148
  - **Failure-Embracing Architecture:**
146
149
  Convert mistakes into learning opportunities through systematic analysis.
150
+ - **Performance-Based Optimization:**
151
+ Route tasks to agents with highest satisfaction scores through NPS feedback integration.
152
+ - **Continuous Quality Assessment:**
153
+ Monitor interaction quality through automated satisfaction surveys and impact metrics.
147
154
 
148
155
  ## Technical Features
149
156
 
150
157
  - **🗣️ Advanced Interaction Layer:**
151
158
  Streaming text-based conversations with real-time thinking.
152
- Voice-to-voice conversations with natural cadence.
153
159
  Multi-turn context preservation and reasoning.
154
160
 
155
161
  - **🤖 Multi-Agent Swarm Architecture:**
156
162
  Dynamic specialized agent creation and coordination.
157
- Intelligent routing based on query content and agent expertise.
163
+ Intelligent routing based on query content, agent expertise, and performance metrics.
158
164
  Seamless handoffs with comprehensive context passing.
159
165
  Shared memory and collective intelligence across the entire swarm.
160
166
 
@@ -163,7 +169,8 @@ Solana Agent transforms organizations into living systems that continuously lear
163
169
  Ticket management for complex or sensitive inquiries.
164
170
  Multiple handoff patterns (AI↔human, human↔human).
165
171
  In-chat command system for human agents to manage tickets.
166
- Availability status management for human operators.
172
+ Availability status management with automatic timeout detection.
173
+ Direct agent-to-agent communication for real-time consultation.
167
174
 
168
175
  - **🧠 Distributed Intelligence Capabilities:**
169
176
  Cross-domain knowledge integration from multiple sources.
@@ -172,6 +179,32 @@ Solana Agent transforms organizations into living systems that continuously lear
172
179
  Time-aware contextual responses.
173
180
  Self-critical improvement systems.
174
181
 
182
+ - **🎫 Comprehensive Ticket System:**
183
+ Universal ticket tracking for all interactions (AI-to-AI and AI-to-human).
184
+ Structured resolution assessment with confidence scoring.
185
+ Automatic ticket lifecycle management with AI-driven resolution.
186
+ Intelligent handoffs maintaining ticket context across agents.
187
+ Command-line interface for human ticket management.
188
+ Metrics and analytics on resolution quality and time.
189
+ Proactive reminders for pending human-assigned tickets.
190
+ Auto-reassignment system for stalled tickets.
191
+ Human agent activity tracking and status management.
192
+
193
+ - **📊 Performance Optimization Framework:**
194
+ Integrated Net Promoter Score (NPS) system for interaction quality measurement.
195
+ Automatic satisfaction surveys after ticket resolution.
196
+ Performance-weighted agent routing based on satisfaction scores.
197
+ Continuous quality monitoring and feedback loops.
198
+ Simple rating submission for users with optional feedback.
199
+ Agent performance analytics and trend identification.
200
+
201
+ - **📋 Task Planning System:**
202
+ Automated complexity assessment for incoming tasks.
203
+ Task decomposition into subtasks with dependencies.
204
+ Intelligent workload distribution based on agent capacity.
205
+ Visual progress tracking with completion estimates.
206
+ Prioritization based on urgency, importance, and dependencies.
207
+
175
208
  - **🛡️ Governance Framework:**
176
209
  Define organization-wide values and operating principles in code.
177
210
  Consistent decision-making aligned with organizational priorities.
@@ -179,18 +212,64 @@ Solana Agent transforms organizations into living systems that continuously lear
179
212
  Transparent insight extraction with review capabilities.
180
213
  Performance analytics across the agent network.
181
214
 
215
+ - **🔍 Project Simulation Framework:**
216
+ Data-driven project feasibility assessment using historical performance.
217
+ Intelligent timeline estimation based on similar past projects.
218
+ Risk analysis with probability and impact scoring.
219
+ Resource requirement prediction and availability matching.
220
+ System load analysis to prevent overcommitment.
221
+ Comprehensive recommendation engine with contextual insights.
222
+ Historical satisfaction trend analysis for similar work.
223
+
224
+ - **✅ Human Approval Workflow:**
225
+ Configurable approval requirements for complex projects.
226
+ Simple queries bypass approval for efficient handling.
227
+ Data-driven approval process with simulation results.
228
+ Multi-approver support with role-based authorization.
229
+ Project lifecycle tracking from submission to approval/rejection.
230
+ Transparent decision documentation with comments and rationale.
231
+
232
+ - **🔔 Notification System:**
233
+ Multi-channel notifications for human agents.
234
+ Approval request routing to authorized approvers.
235
+ Configurable notification handlers for different channels.
236
+ Real-time and asynchronous communication support.
237
+ Status tracking for notification delivery and response.
238
+
239
+ - **🏢 Multi-tenant Platform Architecture:**
240
+ Complete tenant isolation with separate databases and storage.
241
+ Tenant-specific configuration overrides with inheritance from global defaults.
242
+ Support for both Qdrant and Pinecone vector databases.
243
+ Per-tenant agent specialization and customization.
244
+ Centralized management through tenant registry.
245
+ Resource sharing with tenant-level permissions.
246
+ Standardized interfaces across all tenants.
247
+ Efficient multi-tenant scaling with shared infrastructure.
248
+
249
+ - **🔌 Plugin System:**
250
+ Extensible architecture with dynamic tool loading capabilities.
251
+ Isolated plugin environments with dependency management.
252
+ Tool registry for AI agent capability extension.
253
+ Permission-based tool access for security and control.
254
+ Standard interface for third-party integrations.
255
+ Built-in internet search capabilities via Perplexity API.
256
+ Seamless AI agent interaction with external services.
257
+ Runtime tool discovery without code modification.
258
+
182
259
  ## Implementation Technologies
183
260
 
184
261
  Solana Agent leverages multiple technologies to enable these capabilities:
185
262
 
186
263
  - **Knowledge Integration:**
187
- Perplexity API, X/Twitter (Grok API), Zep memory, Pinecone vector search.
264
+ Zep memory and Pinecone or Qdrant vector search.
188
265
  - **Collaborative Intelligence:**
189
266
  Multi-agent swarm architecture with specialized expertise domains.
190
267
  - **Human-AI Teaming:**
191
268
  Integrated ticketing, notification systems, and real-time handoffs.
192
269
  - **Organization Alignment:**
193
270
  Unified mission framework, critic system, and collective memory.
271
+ - **External Integration:**
272
+ Plugin system for extensible tool capabilities and API connections.
194
273
 
195
274
  ## Installation
196
275
 
@@ -202,65 +281,85 @@ You can install Solana Agent using pip:
202
281
 
203
282
  Each public method has a docstring for real-time IDE hinting.
204
283
 
205
- ## Production Apps
206
-
207
- - **CometHeart:**
208
- AI Companion and Business Coach on mobile using voice-to-voice conversations.
209
-
210
284
  ## Example Setup
211
285
 
212
286
  ```python
213
- # Create a decentralized organizational structure
214
- from solana_agent import Swarm, AI, MongoDatabase
215
-
216
- # Initialize the organizational database
217
- db = MongoDatabase(db_url="mongodb://localhost:27017", db_name="organization_brain")
218
-
219
- # Define the organization's mission and values
220
- mission = """Our organization maximizes collective intelligence through
221
- transparent collaboration between humans and AI. We value truth,
222
- clarity, and continuous improvement in all interactions."""
223
-
224
- # Create the organizational swarm
225
- org = Swarm(
226
- database=db,
227
- directive=mission,
228
- )
229
-
230
- # Register AI expertise domains
231
- org.register(
232
- name="knowledge_worker",
233
- agent=AI(
234
- openai_api_key="key",
235
- instructions="You are an expert in research and knowledge synthesis...",
236
- database=db
237
- ),
238
- specialization="Research, analysis, and knowledge synthesis"
239
- )
240
-
241
- org.register(
242
- name="customer_interface",
243
- agent=AI(
244
- openai_api_key="key",
245
- instructions="You handle customer inquiries with empathy and clarity...",
246
- database=db
247
- ),
248
- specialization="Customer interaction and support"
249
- )
250
-
251
- # Register human expertise domains
252
- org.register_human_agent(
253
- agent_id="human_expert_1",
254
- name="Technical Specialist",
255
- specialization="Advanced technical problem solving requiring human judgment",
256
- notification_handler=email_notification
257
- )
258
-
259
- # Process work through the organization
260
- async for response in org.process("user123", "How can we optimize our supply chain?"):
287
+ from solana_agent import SolanaAgent
288
+
289
+ # Define configuration with plugins
290
+ config = {
291
+ "organization": {
292
+ "mission_statement": "To revolutionize knowledge work through AI-human collaboration that puts people first.",
293
+ "values": {
294
+ "Human-Centered": "Always prioritize human well-being and augmentation over replacement.",
295
+ "Transparency": "Provide clear explanations for decisions and never hide information.",
296
+ "Collective Intelligence": "Value diverse perspectives and combine human and AI strengths.",
297
+ "Continuous Learning": "Embrace feedback and continuously improve based on experience."
298
+ },
299
+ "goals": [
300
+ "Enable human experts to focus on high-value creative work",
301
+ "Reduce administrative overhead through intelligent automation",
302
+ "Create seamless knowledge flow across the organization"
303
+ ],
304
+ "guidance": "When making decisions, prioritize long-term user success over short-term efficiency."
305
+ },
306
+ "mongo": {
307
+ "connection_string": "mongodb://localhost:27017",
308
+ "database": "solana_agent"
309
+ },
310
+ "openai": {
311
+ "api_key": "your-openai-key",
312
+ "default_model": "gpt-4o-mini"
313
+ },
314
+ "pinecone": {
315
+ "api_key": "your-pinecone-key",
316
+ "index": "your-index"
317
+ },
318
+ "plugins_dir": "plugins",
319
+ "ai_agents": [
320
+ {
321
+ "name": "research_specialist",
322
+ "instructions": "You are an expert researcher who synthesizes complex information clearly.",
323
+ "specialization": "Research and knowledge synthesis",
324
+ "model": "o3-mini",
325
+ "tools": ["search_internet"]
326
+ },
327
+ {
328
+ "name": "customer_support",
329
+ "instructions": "You provide friendly, helpful customer support responses.",
330
+ "specialization": "Customer inquiries",
331
+ "model": "gpt-4o-mini"
332
+ }
333
+ ],
334
+ "human_agents": [
335
+ {
336
+ "agent_id": "expert_dev",
337
+ "name": "Senior Developer",
338
+ "specialization": "Complex technical issues"
339
+ },
340
+ {
341
+ "agent_id": "support_lead",
342
+ "name": "Support Team Lead",
343
+ "specialization": "Escalated customer issues"
344
+ }
345
+ ],
346
+ "api_keys": {
347
+ "perplexity": "your-perplexity-key" # For internet search plugin
348
+ }
349
+ }
350
+
351
+ # Create agent with configuration
352
+ solana_agent = SolanaAgent(config=config)
353
+
354
+ # Process a query that can use tools
355
+ async for response in solana_agent.process("user123", "What are the latest AI developments?"):
261
356
  print(response, end="")
262
357
  ```
263
358
 
359
+ ## Example App
360
+
361
+ [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)
362
+
264
363
  ## License
265
364
 
266
365
  This project is licensed under the MIT License - see the LICENSE file for details.
@@ -0,0 +1,6 @@
1
+ solana_agent/__init__.py,sha256=zpfnWqANd3OHGWm7NCF5Y6m01BWG4NkNk8SK9Ex48nA,18
2
+ solana_agent/ai.py,sha256=434Wvowzpw48_fGlMWsBUo9oZswwK7DCcsmI_e9bcyI,193201
3
+ solana_agent-10.0.0.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
4
+ solana_agent-10.0.0.dist-info/METADATA,sha256=q1dcqNEPYC3wX8dcSoe08z5SWnKkO2qvAIeK1EQC-4E,16816
5
+ solana_agent-10.0.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
6
+ solana_agent-10.0.0.dist-info/RECORD,,
@@ -1,6 +0,0 @@
1
- solana_agent/__init__.py,sha256=zpfnWqANd3OHGWm7NCF5Y6m01BWG4NkNk8SK9Ex48nA,18
2
- solana_agent/ai.py,sha256=V-FnRpeelDXWFXtNo-nh2vJmokW-rh8YmMP0-ws5-AE,120530
3
- solana_agent-8.0.3.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
4
- solana_agent-8.0.3.dist-info/METADATA,sha256=zhEs9vEWGjVKuh0urelGJe9CcDVcVdjADQA6xAdj0YQ,11262
5
- solana_agent-8.0.3.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
6
- solana_agent-8.0.3.dist-info/RECORD,,