netra-zen 1.0.0__py3-none-any.whl → 1.0.1__py3-none-any.whl

{netra_zen-1.0.0.dist-info → netra_zen-1.0.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: netra-zen
-Version: 1.0.0
+Version: 1.0.1
 Summary: Multi-instance Claude orchestrator for parallel task execution
 Home-page: https://github.com/netra-systems/zen
 Author:  Systems
@@ -79,10 +79,210 @@ Example portion of status report:
 ║  ⏳        quality-synthesizer    queued    0K
 ╚════════════════════════════════════════════╝
 ```
-Here you can see we are running 5 instances of claude.
-- 2 have completed
-- 2 are running
-- 1 is scheduled
+
+## Example Start
+```
+zen
+```
+
+```
++=== STATUS REPORT [14:47:39] ===+
+| Total: 2 instances
+| Running: 2, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 0 total, 0 cached | Median: 0 | Tools: 0
+| 💰 Cost: $0.0000 total, $0.0000 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [--------------------] 0% 0/10.0K
+| Command Budgets:
+|                        /analyze-repository  [--------------------] 0% 0/5.0K
+|                        /README              [--------------------] 0% 0/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repo                   opus4      5.1s       0        0        0        0        0      0/5.0K
+|  🏃        help-overview                  sonnet4    0.0s       0        0        0        0        0      0/1.0K
++================================+
+```
+
+## Budget Warning Only
+```
+zen --overall-token-budget 10000
+```
+```
++=== STATUS REPORT [14:47:44] ===+
+| Total: 2 instances
+| Running: 2, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 32.2K total, 32.2K cached | Median: 32.2K | Tools: 1
+| 💰 Cost: $0.0818 total, $0.0409 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [####################] 100% 32.2K/10.0K
+| Command Budgets:
+|                        /analyze-repository  [####################] 100% 32.2K/5.0K
+|                        /README              [--------------------] 0% 0/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repo                   35sonnet   10.1s      32.2K    5        20.9K    11.4K    1      32.2K/5.0K
+|  🏃        help-overview                  opus4      5.0s       0        0        0        0        0      0/1.0K
++================================+
+
++=== TOOL USAGE DETAILS ===+
+| Tool Name            Uses     Tokens     Cost ($)   Used By
+| -------------------- -------- ---------- ---------- -----------------------------------
+| Bash                 1        33         0.0001     analyze-repo(1 uses, 33 tok)
+| -------------------- -------- ---------- ---------- -----------------------------------
+| TOTAL                1        33         0.0001
++===============================================================================================+
+```
+
+## Budget Block
+```
+zen --overall-token-budget 10000 --budget-enforcement-mode block
+```
+```
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - 💰 BUDGET UPDATE [analyze-repo]: Recording 32240 tokens for command '/analyze-repository'
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - 📊 BUDGET STATE [analyze-repo]: /analyze-repository now at 32240/5000 tokens (644.8%)
+2025-09-18 14:50:42,050 - zen_orchestrator - ERROR - 🚫 🔴 RUNTIME TERMINATION: Runtime budget violation for analyze-repo: Overall budget exceeded: 32240/10000 tokens
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - Terminating instance analyze-repo (PID: 88916): Terminated due to budget violation - Overall budget exceeded: 32240/10000 tokens
+2025-09-18 14:50:42,050 - zen_orchestrator - INFO - Sent SIGTERM to analyze-repo (PID: 88916)
+```
+
+```
++=== FINAL STATUS [14:50:57] ===+
+| Total: 2 instances
+| Running: 0, Completed: 0, Failed: 2, Pending: 0
+| Tokens: 85.6K total, 85.2K cached | Median: 42.8K | Tools: 1
+| 💰 Cost: $0.0889 total, $0.0444 avg/instance | Pricing: Claude compliant
+|
+| TOKEN BUDGET STATUS |
+| Overall: [####################] 100% 85.6K/10.0K
+| Command Budgets:
+|                        /analyze-repository  [####################] 100% 48.4K/5.0K
+|                        /README              [####################] 100% 37.2K/1.0K
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  ❌        analyze-repo                   sonnet4    22.5s      48.4K    31       16.1K    32.2K    1      48.4K/5.0K
+|  ❌        help-overview                  35sonnet   16.2s      37.2K    422      0        36.8K    0      37.2K/1.0K
++===============================+
+
++=== TOOL USAGE DETAILS ===+
+| Tool Name            Uses     Tokens     Cost ($)   Used By
+| -------------------- -------- ---------- ---------- -----------------------------------
+| Task                 1        348        0.0010     analyze-repo(1 uses, 348 tok)
+| -------------------- -------- ---------- ---------- -----------------------------------
+| TOTAL                1        348        0.0010
++===============================================================================================+
+```
+
+# Example Start At
+```
+zen --start-at "2am"
+```
+
+```
+...
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Added instance: analyze-repo - Analyze the repository structure and codebase
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Added instance: help-overview - Show project README and overview information
+
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Orchestration scheduled to start at: 2025-09-19 02:00:00
+2025-09-18 14:54:29,863 - zen_orchestrator - INFO - Waiting 39930.1 seconds (11.1 hours) until start time...
+```
+
+# Example Command
+** Assumes you have a claude command \runtests **
+```
+zen "/runtests"
+```
+```
+...
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Added instance: direct-runtests-3337c2c5 - Direct execution of /runtests
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Starting Claude Code instance orchestration
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Starting 1 instances with 5.0s delay between launches (timeout: 10000s each)
+2025-09-18 14:56:18,478 - zen_orchestrator - INFO - Now starting instance 'direct-runtests-3337c2c5' (after 0.0s delay)
+
+```
+# Example Config (Recommended Usage)
+
+Your JSON file as `path\my_config.json`
+```JSON
+{
+  "instances": [
+    {
+      "name": "analyze-repository",
+      "command": "/analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing.",
+      "description": "Reads and understands the required portion of the repository",
+      "permission_mode": "bypassPermissions",
+      "output_format": "stream-json",
+      "max_tokens_per_command": 5000
+    }
+  ]
+}
+```
+```
+zen --config path\my_config.json
+```
+
+```
+...
+
+2025-09-18 15:00:09,645 - zen_orchestrator - INFO - Loading config from config_example.json
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - 🎯 Token transparency pricing engine enabled - Claude pricing compliance active
+
+2025-09-18 15:00:09,657 - zen_orchestrator - WARNING - Command '/analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing.' not found in available commands
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Available commands: /clear, /compact, /help
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Added instance: analyze-repository - Reads and understands the required portion of the repository
+
+2025-09-18 15:00:09,657 - zen_orchestrator - INFO - Starting Claude Code instance orchestration
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Starting 1 instances with 5.0s delay between launches (timeout: 10000s each)
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Now starting instance 'analyze-repository' (after 0.0s delay)
+
+2025-09-18 15:00:09,659 - zen_orchestrator - INFO - Starting instance: analyze-repository
+
+2025-09-18 15:00:09,665 - zen_orchestrator - INFO - Command: claude.CMD -p /analyze-repository; Spawn three subagents to understand how the information at this website is used in the zen directory. https://docs.claude.com/en/docs/about-claude/pricing#tool-use-pricing. --output-format=stream-json --permission-mode=bypassPermissions --verbose
+
+2025-09-18 15:00:09,738 - zen_orchestrator - INFO - Permission mode: bypassPermissions (Platform: Windows)
+2025-09-18 15:00:09,746 - zen_orchestrator - INFO - Instance analyze-repository started with PID 672
+
++=== STATUS REPORT [15:00:14] ===+
+| Total: 1 instances
+| Running: 1, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 0 total, 0 cached | Median: 0 | Tools: 0
+| 💰 Cost: $0.0000 total, $0.0000 avg/instance | Pricing: Claude compliant
+|
+|  📝 Model shows actual Claude model used (critical for accurate cost tracking)
+|  💡 Tip: Model may differ from your config - Claude routes requests intelligently
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repository             opus4      5.1s       0        0        0        0        0      -
++================================+
+
+
++=== STATUS REPORT [15:00:19] ===+
+| Total: 1 instances
+| Running: 1, Completed: 0, Failed: 0, Pending: 0
+| Tokens: 14.7K total, 14.7K cached | Median: 14.7K | Tools: 0
+| 💰 Cost: $0.0798 total, $0.0798 avg/instance | Pricing: Claude compliant
+|  Status   Name                           Model      Duration   Overall  Tokens   Cache Cr Cache Rd Tools  Budget
+|  -------- ------------------------------ ---------- ---------- -------- -------- -------- -------- ------ ----------
+|  🏃        analyze-repository             opus4      10.1s      14.7K    6        3.3K     11.4K    0      -
++================================+
+
+```
+
 
 ## Inspiration and background
 While developing Netra Apex (commercial product)
@@ -304,7 +504,7 @@ yields:
 usage: zen [-h] [--workspace WORKSPACE] [--config CONFIG] [--dry-run] [--list-commands] [--inspect-command INSPECT_COMMAND]
            [--output-format {json,stream-json}] [--timeout TIMEOUT] [--max-console-lines MAX_CONSOLE_LINES] [--quiet]
            [--startup-delay STARTUP_DELAY] [--max-line-length MAX_LINE_LENGTH] [--status-report-interval STATUS_REPORT_INTERVAL]
-           [--start-at START_AT] [--use-cloud-sql] [--overall-token-budget OVERALL_TOKEN_BUDGET] [--command-budget COMMAND_BUDGET]
+           [--start-at START_AT] [--overall-token-budget OVERALL_TOKEN_BUDGET] [--command-budget COMMAND_BUDGET]
            [--budget-enforcement-mode {warn,block}] [--disable-budget-visuals]
 
 Claude Code Instance Orchestrator

{netra_zen-1.0.0.dist-info → netra_zen-1.0.1.dist-info}/RECORD

@@ -1,15 +1,15 @@
-zen_orchestrator.py,sha256=RxOvJPO8gBNRMXj_hOnoiys3G9XVThGDECtvKishBe8,145729
+zen_orchestrator.py,sha256=QApF_yEo7C8CUq_p8GGYJT2gPwMCLIMLSNIdFZFuxcI,144907
 agent_interface/__init__.py,sha256=OsbOKzElHsxhVgak87oOx_u46QNgKmz-Reis-plAMwk,525
 agent_interface/base_agent.py,sha256=GNskG9VaZgno7X24lQTpFdxUoQE0yJHLh0UPFJvOPn4,11098
-netra_zen-1.0.0.dist-info/licenses/LICENSE.md,sha256=PZrP0UDn58i4LjV4zijIQTnsQPvWm4zq9Fet9i7qgwI,80
+netra_zen-1.0.1.dist-info/licenses/LICENSE.md,sha256=PZrP0UDn58i4LjV4zijIQTnsQPvWm4zq9Fet9i7qgwI,80
 token_budget/__init__.py,sha256=_2tmi72DGNtbYcZ-rGIxVKMytdkHFjzJaWz8bDhYACc,33
 token_budget/budget_manager.py,sha256=VRWxKcGDtgJfIRh-ztYQ4-wuhBvddVJJnyoGfxCBlv0,9567
 token_budget/models.py,sha256=14xFTk2-R1Ql0F9WLDof7vADrKC_5Fj7EE7UmZdoG00,2384
 token_budget/visualization.py,sha256=SaNnZ15edHXtjDCA5Yfu7w3AztCZRYsYCPGBqzapupY,719
 token_transparency/__init__.py,sha256=go86Rg4_VYAPLw3myVpLe1s1PbMu1llDTw1wfomP1lA,453
 token_transparency/claude_pricing_engine.py,sha256=9zWQJS3HJEs_lljil-xT1cUvG-Jf3ykNAninJFyfNSM,12630
-netra_zen-1.0.0.dist-info/METADATA,sha256=V27iuL9RYqydQRDutVEU4D_VeJyQS8iXi1Kx7dGMiT8,19727
-netra_zen-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-netra_zen-1.0.0.dist-info/entry_points.txt,sha256=oDehCnPGZezG0m9ZWspxjHLHyQ3eERX87eojR4ljaRo,45
-netra_zen-1.0.0.dist-info/top_level.txt,sha256=dHz-hgh_dfiiOUrPf8wW80fA31rfEYDFmA6fpu67Yjk,65
-netra_zen-1.0.0.dist-info/RECORD,,
+netra_zen-1.0.1.dist-info/METADATA,sha256=ixxjb8v_zQKUIIoMXOPhfSXdrawdMMPWsOxAUBu_xCE,30220
+netra_zen-1.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+netra_zen-1.0.1.dist-info/entry_points.txt,sha256=oDehCnPGZezG0m9ZWspxjHLHyQ3eERX87eojR4ljaRo,45
+netra_zen-1.0.1.dist-info/top_level.txt,sha256=dHz-hgh_dfiiOUrPf8wW80fA31rfEYDFmA6fpu67Yjk,65
+netra_zen-1.0.1.dist-info/RECORD,,

zen_orchestrator.py

@@ -180,7 +180,7 @@ class ClaudeInstanceOrchestrator:
 
     def __init__(self, workspace_dir: Path, max_console_lines: int = 5, startup_delay: float = 1.0,
                  max_line_length: int = 500, status_report_interval: int = 30,
-                 use_cloud_sql: bool = False, quiet: bool = False,
+                 quiet: bool = False,
                  overall_token_budget: Optional[int] = None,
                  overall_cost_budget: Optional[float] = None,
                  budget_type: str = "tokens",
@@ -199,7 +199,6 @@ class ClaudeInstanceOrchestrator:
         self.status_report_interval = status_report_interval  # Seconds between status reports
         self.last_status_report = time.time()
         self.status_report_task = None  # For the rolling status report task
-        self.use_cloud_sql = use_cloud_sql
         self.quiet = quiet
         self.log_level = log_level
         self.batch_id = str(uuid4())  # Generate batch ID for this orchestration run
@@ -243,11 +242,6 @@ class ClaudeInstanceOrchestrator:
         else:
             logger.debug("Token budget tracking disabled (no budget specified)")
 
-        # Configure CloudSQL if requested
-        # CloudSQL functionality available with Netra Apex
-        if use_cloud_sql:
-            logger.warning("CloudSQL functionality has been disabled. Token metrics will be displayed locally only.")
-            logger.info("For data persistence, consider upgrading to Netra Apex.")
 
     def log_at_level(self, level: LogLevel, message: str, log_func=None):
         """Log message only if current log level permits."""
@@ -2498,7 +2492,6 @@ async def main():
         startup_delay=args.startup_delay,
         max_line_length=args.max_line_length,
         status_report_interval=args.status_report_interval,
-        use_cloud_sql=args.use_cloud_sql,
         quiet=args.quiet,
         overall_token_budget=final_overall_budget,
         overall_cost_budget=final_overall_cost_budget,
@@ -2726,9 +2719,6 @@ async def main():
 
     # Run all instances
     logger.info("Starting Claude Code instance orchestration")
-    if args.use_cloud_sql:
-        logger.info(f"Batch ID: {orchestrator.batch_id}")
-        logger.info("Metrics will be saved to CloudSQL")
     start_time = time.time()
 
     results = await orchestrator.run_all_instances(args.timeout)
@@ -2867,12 +2857,6 @@ async def main():
     print("🌐 Learn more: https://netrasystems.ai/")
     print("="*80)
 
-    # Show CloudSQL info if enabled
-    if args.use_cloud_sql:
-        print(f"\n📊 Local metrics displayed above")
-        print(f"   Batch ID: {orchestrator.batch_id}")
-        print(f"   Database persistence disabled for security")
-
     # Exit with appropriate code
     sys.exit(0 if summary['failed'] == 0 else 1)