solana-agent 8.1.0__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,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: solana-agent
3
- Version: 8.1.0
3
+ Version: 10.0.0
4
4
  Summary: The Future of Work
5
5
  License: MIT
6
6
  Keywords: ai,openai,ai agents,agi
@@ -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.
@@ -178,7 +185,25 @@ Solana Agent transforms organizations into living systems that continuously lear
178
185
  Automatic ticket lifecycle management with AI-driven resolution.
179
186
  Intelligent handoffs maintaining ticket context across agents.
180
187
  Command-line interface for human ticket management.
181
- Metrics and analytics on resolution quality and time.
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.
182
207
 
183
208
  - **🛡️ Governance Framework:**
184
209
  Define organization-wide values and operating principles in code.
@@ -187,18 +212,64 @@ Solana Agent transforms organizations into living systems that continuously lear
187
212
  Transparent insight extraction with review capabilities.
188
213
  Performance analytics across the agent network.
189
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
+
190
259
  ## Implementation Technologies
191
260
 
192
261
  Solana Agent leverages multiple technologies to enable these capabilities:
193
262
 
194
263
  - **Knowledge Integration:**
195
- Perplexity API, X/Twitter (Grok API), Zep memory, Pinecone vector search.
264
+ Zep memory and Pinecone or Qdrant vector search.
196
265
  - **Collaborative Intelligence:**
197
266
  Multi-agent swarm architecture with specialized expertise domains.
198
267
  - **Human-AI Teaming:**
199
268
  Integrated ticketing, notification systems, and real-time handoffs.
200
269
  - **Organization Alignment:**
201
270
  Unified mission framework, critic system, and collective memory.
271
+ - **External Integration:**
272
+ Plugin system for extensible tool capabilities and API connections.
202
273
 
203
274
  ## Installation
204
275
 
@@ -210,65 +281,85 @@ You can install Solana Agent using pip:
210
281
 
211
282
  Each public method has a docstring for real-time IDE hinting.
212
283
 
213
- ## Production Apps
214
-
215
- - **CometHeart:**
216
- AI Companion and Business Coach on mobile using voice-to-voice conversations.
217
-
218
284
  ## Example Setup
219
285
 
220
286
  ```python
221
- # Create a decentralized organizational structure
222
- from solana_agent import Swarm, AI, MongoDatabase
223
-
224
- # Initialize the organizational database
225
- db = MongoDatabase(db_url="mongodb://localhost:27017", db_name="organization_brain")
226
-
227
- # Define the organization's mission and values
228
- mission = """Our organization maximizes collective intelligence through
229
- transparent collaboration between humans and AI. We value truth,
230
- clarity, and continuous improvement in all interactions."""
231
-
232
- # Create the organizational swarm
233
- org = Swarm(
234
- database=db,
235
- directive=mission,
236
- )
237
-
238
- # Register AI expertise domains
239
- org.register(
240
- name="knowledge_worker",
241
- agent=AI(
242
- openai_api_key="key",
243
- instructions="You are an expert in research and knowledge synthesis...",
244
- database=db
245
- ),
246
- specialization="Research, analysis, and knowledge synthesis"
247
- )
248
-
249
- org.register(
250
- name="customer_interface",
251
- agent=AI(
252
- openai_api_key="key",
253
- instructions="You handle customer inquiries with empathy and clarity...",
254
- database=db
255
- ),
256
- specialization="Customer interaction and support"
257
- )
258
-
259
- # Register human expertise domains
260
- org.register_human_agent(
261
- agent_id="human_expert_1",
262
- name="Technical Specialist",
263
- specialization="Advanced technical problem solving requiring human judgment",
264
- notification_handler=email_notification
265
- )
266
-
267
- # Process work through the organization
268
- 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?"):
269
356
  print(response, end="")
270
357
  ```
271
358
 
359
+ ## Example App
360
+
361
+ [Solana Agent Example App](https://github.com/truemagic-coder/solana-agent-app)
362
+
272
363
  ## License
273
364
 
274
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=wgNWzJU0AJf8ZL71D-phXau7jz7DIhJjSErEQ39_QyE,129937
3
- solana_agent-8.1.0.dist-info/LICENSE,sha256=BnSRc-NSFuyF2s496l_4EyrwAP6YimvxWcjPiJ0J7g4,1057
4
- solana_agent-8.1.0.dist-info/METADATA,sha256=QrXQirdpnwlihF4CUqvESiAQIVkcrKqRkEUqJm6VFX0,11701
5
- solana_agent-8.1.0.dist-info/WHEEL,sha256=XbeZDeTWKc1w7CSIyre5aMDU_-PohRwTQceYnisIYYY,88
6
- solana_agent-8.1.0.dist-info/RECORD,,