-
Notifications
You must be signed in to change notification settings - Fork 1
Expand file tree
/
Copy pathindex-map-py-agent.txt
More file actions
148 lines (148 loc) · 18.2 KB
/
Copy pathindex-map-py-agent.txt
File metadata and controls
148 lines (148 loc) · 18.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
# CODEBASE INDEX MAP | Generated: 2026-09-10 10:53 | Workspace: py-agent | Path: ~/.config/py-agent
# Active symbols and structural connections mapped in the local index.
# -----------------------------------------------------------------------------------------
# Codebase Modules & Active Architecture:
# ├── .env - ~/.config/py-agent/.env
# ├── .env.example - ==============================================================================
# ├── .gitignore - Secrets & Credentials
# ├── .last_cloud_key.txt - CUSTOM_API_KEY
# ├── .openrouter_cache_v2.json - {
# ├── .request_log - 1788137364|gemini
# ├── .spend_ledger.json - {
# ├── .state.json - {
# ├── CONTRIBUTING.md - Contributing to Py-Agent
# ├── LICENSE - MODIFIED MIT LICENSE (NON-COMMERCIAL / NO BUSINESS USE)
# ├── README.md - <div align="center">
# ├── SECURITY.md - Security Policy
# ├── ai-agent.py - Py Agent [j5onrf] [v0.9.9.22] - Main CLI Runtime, Workspace Agent & Command Dispatcher
# ├── ai-context.md - Py-Agent Plugins
# ├── ai-hook.sh - Production Py-Agent Shell Hook v0.9.9
# ├── custom_spaces.json - {
# ├── logo.svg - <svg xmlns="http://www.w3.org/2000/svg" viewBox="121 101 270 310">
# ├── server.pem - -----BEGIN PRIVATE KEY-----
# ├── modules/Readme.md - Privacy-First
# ├── modules/agent_adapters.py - Tool Format Adapters & Self-Healing Parser for Small-Models
# ├── modules/agent_cloud.py - Dynamic Cloud Cascade Engine - Top-down .env provider API priority with infinite CUSTOM* support.
# ├── modules/agent_context.py - Context Search & Indexing Engine - Jaccard intent matching.
# ├── modules/agent_core.py - Core Module - Streaming SSE, dynamic tool execution, & Rich rendering
# ├── modules/agent_ipython.py - Local-AI Standalone IPython Kernel & RLM Harness Module
# ├── modules/agent_memories.py - SQLite-backed semantic recall and Temporal Personality Memory (TPM) manager [In-Memory Module & CLI]
# ├── modules/agent_sessions.py - SQLite-backed session, checkpoint, and turn logger with sub-agent registry [Self-Healing In-Memory M
# ├── modules/agent_skills.py - Unified library & executable for static, dynamic, universal YAML, and on-demand skills [In-Memory Ed
# ├── modules/agent_tools.py - Native Tool Engine - Handles file editing, search, commands, & graph intelligence
# ├── modules/agent_tts.py - Local-AI Kokoro Text-to-Speech Module [Zero-Lag Edition]
# ├── modules/agent_tui.py - Production Minimal Textual TUI for Py Agent Engine [Compact Edition]
# ├── modules/agent_tui_async.py - Asynchronous uvloop background services for Local-AI Agent TUI
# ├── modules/agent_ui.py - UI Module - Spinners, session boxes, and interactive menus
# ├── modules/agent_usage.py - Token Usage & Spend Ledger Manager
# ├── modules/agent_voice.py - Local-AI Standalone Voice to Text Module
# ├── modules/chat - Unified Agentic Brainstorm, Thinking & Follow-up Recommendation Engine.
# ├── modules/model-select.py - Streamlined TUI Model Selector driven by Local/HF, Generic Custom 2, Google Gemini & OpenRouter
# └── modules/speed_test.py - Precise token generation & TPS speed test statistics tracker
# -----------------------------------------------------------------------------------------
[example:.env.example] sum:==============================================================================
[file:.gitignore] sum:Secrets & Credentials
[markdown:CONTRIBUTING.md] title:Contributing to Py-Agent
[file:LICENSE] sum:MODIFIED MIT LICENSE (NON-COMMERCIAL / NO BUSINESS USE)
[markdown:README.md] title:1. Install system dependencies & clone | links:Readme.md,ai-context.md
[markdown:SECURITY.md] title:Security Policy
[python:ai-agent.py] imp:agent_context,agent_core,agent_ipython,agent_memories,agent_sessions,agent_skills,agent_tts,agent_ui,agent_voice,contextlib,json,os,re,readline,shutil,sqlite3,subprocess,sys,threading,time | fn:load_env_file,workspace_db_counts,ensure_clean_agent_dir,sync_md_to_sqlite,clean_exit,_launch_surface,run_interactive_chat,run_direct_query,run_matching_search,main
[markdown:ai-context.md] title:Py-Agent Plugins | links:-f "$f",-z "$q"
[shell:ai-hook.sh] sum:Production Py-Agent Shell Hook v0.9.9
[image/svg:logo.svg] dim:x | size:1.4KB
[markdown:modules/Readme.md] title:Privacy-First
[python:modules/agent_adapters.py] imp:ast,json,re,time,typing | fn:normalize_params,_extract_balanced_json,heal_tool_call,heal_json_args,_extract_ast_python_calls,extract_fallback_tool_calls
[python:modules/agent_cloud.py] imp:os,re,typing | fn:_is_valid_key,get_active_configs
[python:modules/agent_context.py] imp:os,re,sys,typing | fn:tokenize,load_context_entries,jaccard_search,clean_tool_prefix
[python:modules/agent_core.py] imp:agent_adapters,agent_cloud,agent_ipython,agent_memories,agent_tools,agent_ui,agent_usage,base64,json,os,re,requests,rich,shutil,speed_test,subprocess,sys,time,typing,urllib | cls:RichStreamer | fn:_get_console,_get_img_config,describe_image_gemini,preprocess_multimodal_messages,_heal_tool_args,get_state,save_state,workspace_safe_name,run_mod,background_tpm_update,__init__,_stop_spinner,start,update,stop,_log_turn_usage,_process_stream_chunk,_calc_turn_tokens,_confirm_gate,_print_tool_output,_run_edit_tool,agentic_turn,_calc_msg_tokens,stream_response,get_accurate_token_count,show_memory_status,prune_history
[python:modules/agent_ipython.py] imp:IPython,agent_core,agent_memories,agent_tools,agent_ui,ast,builtins,collections,contextlib,io,os,signal,subprocess,sys,traceback,typing | cls:CellTimeoutError,MemorySDK,GraphSDK | fn:_timeout_handler,is_ipython_enabled,toggle_ipython_mode,bounded_repr,__init__,search,get_facts,add_fact,__init__,snippet,trace,blast_radius,search,architecture,delegate,_final_answer,_init_kernel_sdk,_is_outside,_check_boundary,safe_open,safe_listdir,_read_file,_edit_file,_write_file,_list_dir,_search_code,_run_command,inspect_ast_safety,run_cell,get_active_tools
[python:modules/agent_memories.py] imp:agent_context,contextlib,json,os,re,select,sqlite3,sys,termios,time,tty | fn:tokenize,get_key,connect_db,tpm_get,tpm_reconcile,tpm_clear,get_tpm_count,search_past_context
[python:modules/agent_sessions.py] imp:agent_context,contextlib,glob,json,os,re,select,sqlite3,sys,termios,time,tty,typing | fn:tokenize,get_key,connect_db,get_sub_agent_id,cleanup_sub_agent,init_db,save_checkpoint,rollback_checkpoint,log_turn,get_turns_count,clear_turns
[python:modules/agent_skills.py] imp:agent_context,agent_core,agent_ui,json,os,re,shutil,subprocess,sys,typing | fn:ensure_mysys_exists,parse_frontmatter,find_skill_file,load_skill_content,_exec_tool_cmd,run_local_tool,run_interactive_tool,get_system_context,load_skill_blueprints,run_skill_selector
[python:modules/agent_tools.py] imp:agent_core,agent_ipython,agent_ui,ast,collections,difflib,importlib,json,os,re,rich,shlex,subprocess,sys,time,typing,urllib | fn:get_modified_files,clear_session_tracking,_get_graph_engine,_safe_path,_is_outside_workspace,_check_command_security,_search_codebase,_generate_ast_skeleton,_resilient_replace,run_graph_cmd,run_tool,_in_bounds_gate,_security_gate
[python:modules/agent_tts.py] imp:agent_core,os,re,subprocess,sys,threading | fn:stop_tts,is_tts_enabled,get_tts_speed,set_tts_speed,toggle_tts,clean_text_for_speech,speak_text,_run,speak_response
[python:modules/agent_tui.py] imp:agent_cloud,agent_core,agent_ipython,agent_skills,agent_tools,agent_tts,agent_tui_async,agent_ui,agent_voice,base64,collections,contextlib,json,os,re,requests,rich,sqlite3,subprocess,sys,textual,threading,time,typing,urllib,uvloop | cls:FooterToggle,ImageButton,CloseCardButton,Message,AgentCommandProvider,LocalAITUI | fn:format_dir_path,format_model_name,copy_to_clipboard,_glimmer_tui_text,_format_tui_reasonix_text,on_click,on_click,on_click,__init__,update_content,render,search,command_sources,border_accent,is_dark_theme,watch_theme,__init__,on_unmount,_safe_remove_banner,notify,set_skill,set_mode,set_reasoning,action_prompt_image_url,on_key,refresh_db_counts,ensure_system_context,get_db_status_string,update_welcome_banner,compose,action_close_tips_card,on_mount,action_toggle_plan_build,on_input_changed,update_stats_ui,action_scroll_page_up,action_scroll_page_down,action_scroll_up,action_scroll_down,action_copy_last_response,action_copy_entire_chat,handle_view_file,handle_task_command,_sub,handle_slash_command,prompt_tui_confirm,_show,process_query_worker,on_input_submitted,disable_input,enable_input,action_stop_generation,update_sidebar_visibility,action_toggle_sidebar,update_footer_visibility,action_toggle_footer,action_toggle_compact,action_cycle_theme,action_toggle_reasoning,action_toggle_borders
[python:modules/agent_tui_async.py] imp:asyncio,json,os | fn:run_async_cmd,watch_workspace_changes,start_subagent_ipc_hub,handle_subagent_msg
[python:modules/agent_ui.py] imp:agent_cloud,agent_core,agent_skills,collections,json,os,re,rich,select,sys,termios,threading,time,tty,typing,urllib | cls:InlineSpinner | fn:__init__,_get_theme_color,_glimmer,_spin,update,start,stop,_read_fd,get_key,get_local_model_name,draw_session_box,confirm_tool,run_interactive_selection,show_help,select_workspace_profile
[python:modules/agent_usage.py] imp:json,os,time,typing | fn:record,turn_line
[python:modules/agent_voice.py] imp:agent_core,base64,http,json,os,re,socket,ssl,subprocess,sys,time,urllib | cls:VoiceHandler | fn:is_bridge_running,load_voice_env,transcribe_gemini,get_prompt_input,log_message,do_POST,do_GET,run_server,toggle_voice_bridge
[file:modules/chat] sum:Unified Agentic Brainstorm, Thinking & Follow-up Recommendation Engine.
[python:modules/model-select.py] imp:asyncio,atexit,json,os,re,select,shutil,subprocess,sys,termios,time,tty,urllib | fn:cleanup_terminal,load_json,save_json,ensure_env_exists,load_env_vars,get_active_key_set,update_env_multiple,isolate_active_key,toggle_single_provider,toggle_independent_key,toggle_env_api_keys,parse_endpoint_url,async_fetch_remote,_fetch,async_get_key,_read,prompt_user_input,run_interactive_menu,filter_items,async_main
[python:modules/speed_test.py] imp:sys,time | fn:start,count_token,end
[markdown:plugins/Readme.md] title:Custom Plugins & Tools: `plugins/`
[markdown:plugins/audio/Readme.md] title:Kokoro Neural Text-to-Speech & Selection Speaker Plugin
[shell:plugins/audio/koko-speak.sh] sum:High-Performance Kokoro Selection Speaker (RAM-disk execution)
[python:plugins/pycode/bridge.py] imp:agent_cloud,agent_core,agent_ipython,agent_memories,agent_sessions,agent_skills,agent_tools,agent_tts,json,os,requests,sys,threading,time,typing,uuid | fn:send_rpc_response,send_acp_chunk,detect_workspace_mode,assemble_system_prompt,handle_acp_prompt,main,_voice_watcher
[shell:plugins/pycode/launch.sh] sum:==============================================================================
[shell:plugins/pycode/setup.sh] sum:==============================================================================
[shell:plugins/webui/launch.sh] sum:PORT=3000
[python:plugins/webui/server.py] imp:agent_core,agent_sessions,agent_skills,agent_tools,agent_tts,gzip,http,json,os,requests,socketserver,sys,threading,urllib | cls:OfficialWebUIProxyHandler,ThreadedProxyServer | fn:detect_workspace_mode,assemble_system_prompt,do_GET,do_OPTIONS,do_POST,log_message
[shell:setup/Mini2Bs.sh] sum:==========================================
[markdown:setup/Readme.md] title:Local Server Configuration & Model Selector (Universal CPU & GPU)
[shell:setup/lfm2.sh] sum:Configuration
[python:setup/model-select-local.py] imp:asyncio,os,re,select,shutil,subprocess,sys,tempfile,termios,tty | fn:async_set_cpu_chill,async_set_cpu_balanced,get_current_running_model,async_stop_all_engines,launch_local_server,async_get_key,_read,draw_menu,async_main
[shell:setup/q2bu.sh] sum:==========================================
[shell:setup/q35b.sh] sum:==========================================
[markdown:skills/Readme.md] title:Py-Agent Skills Architecture
[markdown:skills/meta/brainstorm.md] title:[SKILL] brainstorm ---> brainstorm, lateral, creative, perspective, future, trends, macro
[markdown:skills/meta/follow-up.md] title:[SKILL] follow-up ---> follow-up, followup, question, mechanics, practical, compare
[markdown:skills/meta/thinking.md] title:[SKILL] thinking ---> thinking, think, analyze, next-steps, details, critique, risk
[markdown:skills/on-demand/caveman.md] title:[SKILL] Caveman Mode ---> caveman, talk like caveman, caveman-mode, less tokens, be brief
[markdown:skills/on-demand/chat/chat.md] title:[SKILL] chat ---> chat, convo, talk, friendly, chatty, assistant, speak
[markdown:skills/on-demand/hindsight.md] title:[SKILL] hindsight ---> hindsight, lesson, learn, retrospective, postmortem, memory review, remember
[markdown:skills/on-demand/omarchy/capture.md] title:Screen Capture & Sharing Directives
[markdown:skills/on-demand/omarchy/contributing.md] title:Bug Reporting & Upstream Directives
[markdown:skills/on-demand/omarchy/diagnose-crash.md] title:Crash & Core Dump Diagnosis Directives
[markdown:skills/on-demand/omarchy/hooks.md] title:Automation Hooks Directives
[markdown:skills/on-demand/omarchy/hyprland.md] title:Hyprland Config Directives
[markdown:skills/on-demand/omarchy/omarchy.md] title:Omarchy System Directives
[markdown:skills/on-demand/omarchy/plugins.md] title:Shell, Bar & Plugins Directives
[markdown:skills/on-demand/omarchy/reporting.md] title:Reporting a Crash Upstream to Omarchy
[markdown:skills/on-demand/omarchy/theming.md] title:Theming & Appearance Directives
[markdown:skills/on-demand/pirate.md] title:[SKILL] Pirate Talk ---> pirate, talk like a pirate, pirate-talk, nautical, captain
[markdown:skills/on-demand/ponytail-py.md] title:[SKILL] Ponytail-Py ---> ponytail-py, senior python dev, yagni, minimal python, pythonic simplicity
[markdown:skills/on-demand/ponytail.md] title:[SKILL] Ponytail ---> ponytail, lazy senior dev, yagni, minimal code, simplify code
[markdown:skills/profiles/claude/pro.md] title:Official Claude Systems & Python Engineer
[markdown:skills/profiles/custom/base.md] title:Universal Base Developer Agent (Dual-Mode Template)
[markdown:skills/profiles/custom/lfm2.md] title:Liquid Systems & Python Engineer (8B High-Speed Dev)
[markdown:skills/profiles/custom/minicpm.md] title:MiniCPM Systems & Python Engineer (2B Lite Dev)
[markdown:skills/profiles/custom/pysmol.md] title:IDENTITY & ROLE: CODEAGENT (SMOLAGENTS-INSPIRED PYTHON ORCHESTRATOR)
[markdown:skills/profiles/custom/q2b.md] title:Qwen Systems & Python Engineer (2B Lite Dev)
[markdown:skills/profiles/custom/sysadmin.md] title:IDENTITY & ROLE: SENIOR LINUX SYSTEMS ADMINISTRATOR
[markdown:skills/profiles/hermes/pro.md] title:Nous Hermes Autonomous Systems & Python Engineer
[markdown:skills/profiles/pi/pro.md] title:Official Pi Autonomous Coding & Python Specialist
[markdown:skills/system/aur-audit.md] title:AUR PRE-INSTALL SECURITY AUDIT SKILL
[markdown:skills/system/mysys.md] title:SYSTEM ARCHITECTURE BLUEPRINT
[markdown:skills/system/security-audit.md] title:SYSTEM SECURITY AUDIT DIRECTIVES
[markdown:skills/system/system-optimizer.md] title:GENERAL LINUX DESKTOP OPTIMIZATION SKILL
[markdown:skills/system/update-inspector.md] title:ARCH LINUX UPGRADE DIRECTIVES
[file:tools/agentic/identity/business/mybiz] sum:import os
[file:tools/agentic/identity/marketing/marketing] sum:import os
[markdown:tools/agentic/identity/readme.md] title:Identity Layer (`agentic/identity/`)
[file:tools/agentic/identity/workout/routine] sum:import os
[file:tools/agentic/system/ai-commit] sum:ai-commit - Automate Git Commits with AI Context
[file:tools/agentic/system/ai-status] sum:ai-status - Diagnostics for Py-Agent Cloud Models & Quotas v2.3.0
[file:tools/agentic/system/aur-audit] sum:aur-audit - Interactive Zero-Trust AUR Package Auditor v2.1.0
[file:tools/agentic/system/log-checker] sum:AI Log Triage & Diagnostics v2.5.0 (Zero-Config / High-Precision)
[markdown:tools/agentic/system/readme.md] title:Ai-Commit
[file:tools/agentic/system/security-audit] sum:security-audit - Dynamic Security Profile Integrator & System Auditor v2.2.0
[file:tools/agentic/system/syscheck] sum:syscheck - Composite System Triage & Diagnostics Orchestrator
[file:tools/agentic/system/system-health] sum:system-health - Context-Aware Real-time Hardware Inspector
[file:tools/agentic/system/system-optimizer] sum:sysop - Dynamic Optimization & Hardware Profile Integrator v2.0.0
[file:tools/agentic/system/update-inspector] sum:AI Update Inspector - Universal Arch Linux
[markdown:tools/agentic/web/Readme.md] title:Firecrawl Scraper API Configurations
[file:tools/agentic/web/firecrawl] sum:File: ~/.config/local-ai/tools/agentic/web/firecrawl
[file:tools/agentic/web/web-reader] sum:web-reader [Zero-Dependency Web Scraper & YouTube Subtitle Extractor] v1.0.4
[file:tools/cheatsheet] sum:Cheatsheet - High-Speed Markdown-Native Plugin & Shortcut Map Generator
[file:tools/email/.email] sum:--- Global fallback connection details ---
[markdown:tools/email/Readme.md] title:Email TUI Monitor: `email-agent`
[file:tools/email/email-agent] sum:email-agent [Secure Multi-Mailbox Tag-Filter Agent]
[file:tools/generate-profile] sum:sysctl-aware system profiler for Py-Agent
[markdown:tools/index-map/Readme.md] title:Codebase Mapping & Relational Knowledge Graph: `index-map`
[file:tools/index-map/index-map] sum:Graph-Enabled Index-Map Workspace Intelligence Engine [Zero-Config FTS5 Edition]
[python:tools/loop/ralph.py] imp:agent_core,agent_skills,agent_tools,agent_ui,argparse,json,os,re,sys,time,typing | fn:_read_spec_file,_log_task_turn,is_task_complete,run_task_loop,main
[python:tools/subsec/apps/stopwatch/stopwatch.py] imp:math,re,select,shutil,sys,termios,time,tty | fn:strip_ansi,get_key_non_blocking,fmt_time_high_res,get_elapsed,generate_visualizer,draw_row_raw,run_stopwatch_tui
[shell:tools/subsec/apps/stopwatch/stopwatch.sh] sum:Minimalist Pure Bash High-Resolution Stopwatch
[file:tools/subsec/hyprstate/gitcom] sum:Hyprland Workspace State Manager -- GitCom
[file:tools/subsec/hyprstate/work] sum:Hyprland Workspace State Manager -- Work
[file:tools/test-agent] sum:Unified All-in-One Py-Agent Deep Diagnostic & Comprehensive System Test Suite