Stargazer v3

Core Modules

  • Core Modules
    • anamnesis_engine
      • run_anamnesis_cycle()
    • api_key_encryption
      • ENCRYPTED_PREFIX
      • get_or_create_user_key()
      • encrypt()
      • decrypt()
      • get_pool_key()
      • resolve_master_key()
      • is_encrypted()
      • api_key_hash()
    • background_tasks
      • BackgroundScheduler
        • BackgroundScheduler.__init__()
        • BackgroundScheduler.register()
        • BackgroundScheduler.start()
        • BackgroundScheduler.stop()
      • scheduled_prompt_tick()
      • scheduled_prompt_cleanup()
      • auto_kg_extraction()
      • channel_summarization()
      • kg_consolidation_task()
      • kg_decay_task()
      • log_rag_ingest_task()
      • gemini_key_probe_task()
      • agentic_kg_bulk_incremental_task()
      • anamnesis_digest_task()
      • startup_channel_backfill()
      • build_scheduler()
    • btc_networks
      • BTCNetworkConfig
        • BTCNetworkConfig.name
        • BTCNetworkConfig.network_name
        • BTCNetworkConfig.is_testnet
        • BTCNetworkConfig.api_base_url
        • BTCNetworkConfig.api_backup_url
        • BTCNetworkConfig.explorer_url
        • BTCNetworkConfig.to_dict()
      • get_btc_network()
      • list_btc_networks()
    • btc_wallet_manager
      • BTCWalletManager
        • BTCWalletManager.__init__()
        • BTCWalletManager.generate_mnemonic()
        • BTCWalletManager.validate_mnemonic()
        • BTCWalletManager.create_wallet()
        • BTCWalletManager.import_wif()
        • BTCWalletManager.get_wallet()
        • BTCWalletManager.list_wallets()
        • BTCWalletManager.derive_address()
        • BTCWalletManager.get_private_key()
        • BTCWalletManager.get_decrypted_seed()
        • BTCWalletManager.delete_wallet()
    • build_kg
      • fetch_messages_redis()
      • fetch_messages_discord()
      • gather_messages()
      • dump_full_graph()
      • build_extraction_prompt()
      • run_extraction()
      • format_entity()
      • format_relationship()
      • prompt_approval()
      • commit_entities()
      • commit_relationships()
      • format_conversation()
      • run()
      • main()
    • cadence_refiner
      • CadencePostProcessor
        • CadencePostProcessor.process()
    • callbacks
    • cascade_engine
      • CascadeState
        • CascadeState.__init__()
        • CascadeState.to_dict()
        • CascadeState.from_dict()
      • CascadeEngine
        • CascadeEngine.__init__()
        • CascadeEngine.tick()
        • CascadeEngine.get_active_cascades()
        • CascadeEngine.force_trigger()
    • chroma_registry
      • get_client()
    • config
      • PlatformConfig
        • PlatformConfig.type
        • PlatformConfig.enabled
        • PlatformConfig.settings
        • PlatformConfig.get()
      • Config
        • Config.api_key
        • Config.gemini_api_key
        • Config.llm_base_url
        • Config.model
        • Config.temperature
        • Config.max_tokens
        • Config.system_prompt_file
        • Config.max_history
        • Config.tools_dir
        • Config.tool_permissions
        • Config.api_keys
        • Config.redis_url
        • Config.redis_tls_cert
        • Config.redis_tls_key
        • Config.redis_tls_ca
        • Config.embedding_model
        • Config.embedding_batch_size
        • Config.embedding_flush_interval
        • Config.kg_extraction_model
        • Config.kg_max_hops
        • Config.kg_seed_top_k
        • Config.kg_max_context_entities
        • Config.kg_entity_dedup_threshold
        • Config.kg_relationship_decay_factor
        • Config.kg_per_message_extraction
        • Config.kg_min_message_length
        • Config.kg_per_user_extraction_limit
        • Config.kg_extraction_channel_hints
        • Config.openrouter_api_key
        • Config.API_KEYS
        • Config.llm_filter_enabled
        • Config.proactive_enabled
        • Config.proactive_default_frequency
        • Config.proactive_triage_enabled
        • Config.proactive_triage_model
        • Config.batch_window
        • Config.max_batch_size
        • Config.dna_vault_path
        • Config.api_key_encryption_db_path
        • Config.media_cache_dir
        • Config.media_cache_max_mb
        • Config.user_sandboxes_dir
        • Config.tor_gateway_container
        • Config.sandbox_curl_image
        • Config.resolve_emojis_as_images
        • Config.max_emojis_per_message
        • Config.web_host
        • Config.web_port
        • Config.admin_user_ids
        • Config.webhook_secret
        • Config.discord_oauth_client_id
        • Config.discord_oauth_client_secret
        • Config.discord_oauth_redirect_uri
        • Config.oauth_encryption_key
        • Config.oauth_base_url
        • Config.oauth_providers
        • Config.platforms
        • Config.homeserver
        • Config.user_id
        • Config.password
        • Config.store_path
        • Config.credentials_file
        • Config.load()
        • Config.redis_ssl_kwargs()
    • conversation
      • ConversationManager
        • ConversationManager.__init__()
        • ConversationManager.append()
        • ConversationManager.get_messages()
        • ConversationManager.get_messages_async()
        • ConversationManager.update_message()
        • ConversationManager.mark_deleted()
        • ConversationManager.clear()
        • ConversationManager.MIN_CHANNEL_LIMIT
        • ConversationManager.MAX_CHANNEL_LIMIT
        • ConversationManager.set_channel_limit()
        • ConversationManager.get_channel_limit()
    • embedding_queue
      • EmbeddingBatchQueue
        • EmbeddingBatchQueue.start()
        • EmbeddingBatchQueue.stop()
        • EmbeddingBatchQueue.enqueue()
        • EmbeddingBatchQueue.enqueue_many()
        • EmbeddingBatchQueue.pending_count()
        • EmbeddingBatchQueue.flush_now()
    • eth_networks
      • NetworkConfig
        • NetworkConfig.name
        • NetworkConfig.chain_id
        • NetworkConfig.rpc_url
        • NetworkConfig.native_symbol
        • NetworkConfig.native_decimals
        • NetworkConfig.explorer_url
        • NetworkConfig.is_testnet
        • NetworkConfig.to_dict()
      • get_network()
      • get_network_by_chain_id()
      • create_custom_network()
      • list_networks()
    • feature_toggles
      • Redis key scheme
      • is_disabled()
      • set_disabled()
      • check_toggle_permission()
    • flavor_engine
      • FlavorProfile
        • FlavorProfile.name
        • FlavorProfile.vector
        • FlavorProfile.delta_str
        • FlavorProfile.temporal
        • FlavorProfile.norimaki_inv
        • FlavorProfile.retronasal
        • FlavorProfile.category
        • FlavorProfile.dominant_axis
      • CompositeResult
        • CompositeResult.vector
        • CompositeResult.raw_vector
        • CompositeResult.ncm_deltas
        • CompositeResult.tds_string
        • CompositeResult.temporal_phases
        • CompositeResult.derived_metrics
        • CompositeResult.nearest_flavor
        • CompositeResult.nearest_similarity
        • CompositeResult.novelty_score
        • CompositeResult.emergence_flags
        • CompositeResult.cascade_triggers
        • CompositeResult.attractor
        • CompositeResult.ingredients
        • CompositeResult.to_dict()
      • FlavorEngine
        • FlavorEngine.__init__()
        • FlavorEngine.get_flavor()
        • FlavorEngine.list_flavors()
        • FlavorEngine.blend()
        • FlavorEngine.morph()
        • FlavorEngine.apply_temperature()
    • flavor_memory
      • record_flavor()
      • get_flavor_affinity()
      • get_history()
      • get_top_flavors()
    • game_assets
      • GameAsset
        • GameAsset.name
        • GameAsset.category
        • GameAsset.url
        • GameAsset.uploaded_by
        • GameAsset.turn_added
        • GameAsset.created_at
        • GameAsset.to_dict()
        • GameAsset.from_dict()
      • upload_asset()
      • get_assets()
      • get_asset_by_name()
      • delete_asset()
      • get_asset_summary()
    • game_memory
      • GameMemory
        • GameMemory.label
        • GameMemory.content
        • GameMemory.importance
        • GameMemory.turn_created
        • GameMemory.turn_last_referenced
        • GameMemory.reference_count
        • GameMemory.category
        • GameMemory.glitched
        • GameMemory.source_game
        • GameMemory.created_at
        • GameMemory.to_dict()
        • GameMemory.from_dict()
      • store_basic()
      • store_channel()
      • get_basic_memories()
      • get_channel_memories()
      • get_context_summary()
      • bleed_memories()
      • clear_game_memories()
    • game_ncm
      • BattleModifiers
        • BattleModifiers.attack_mult
        • BattleModifiers.defense_mult
        • BattleModifiers.speed_mult
        • BattleModifiers.crit_rate
        • BattleModifiers.evasion
        • BattleModifiers.accuracy
        • BattleModifiers.status_resist
        • BattleModifiers.description
        • BattleModifiers.to_dict()
      • initialize_game_ncm()
      • get_vector()
      • apply_delta()
      • get_battle_modifiers()
      • get_emotion_advantage()
      • format_hud()
      • format_hud_from_redis()
    • game_renderer
    • game_session
      • PlayerState
        • PlayerState.user_id
        • PlayerState.user_name
        • PlayerState.joined_turn
        • PlayerState.to_dict()
        • PlayerState.from_dict()
      • TurnRecord
        • TurnRecord.turn
        • TurnRecord.choices
        • TurnRecord.narrative_summary
        • TurnRecord.timestamp
        • TurnRecord.to_dict()
        • TurnRecord.from_dict()
      • GameSession
        • GameSession.game_id
        • GameSession.game_name
        • GameSession.channel_id
        • GameSession.active
        • GameSession.turn_number
        • GameSession.title_screen_url
        • GameSession.players
        • GameSession.pending_choices
        • GameSession.countdown_task
        • GameSession.boot()
        • GameSession.exit_game()
        • GameSession.register_player()
        • GameSession.submit_choice()
        • GameSession.wait_for_countdown()
        • GameSession.format_choices_as_input()
        • GameSession.record_turn()
        • GameSession.get_turn_history()
        • GameSession.to_dict()
        • GameSession.from_dict()
        • GameSession.load_from_redis()
        • GameSession.delete_from_redis()
      • get_session()
      • set_session()
      • remove_session()
      • list_all_games()
      • load_by_game_id()
    • gemini_embed_pool
      • Daily quota tracking
      • get_paid_fallback_key()
      • reload_pool()
      • init_quota_tracking()
      • next_gemini_embed_key()
      • next_gemini_flash_key()
      • is_daily_quota_429()
      • is_daily_quota_429_for_model()
      • record_key_usage()
      • mark_key_daily_spent()
      • sync_spent_keys_from_redis()
      • get_pool_status()
      • probe_all_keys()
      • get_openrouter_api_key()
      • openrouter_embed_batch()
      • openrouter_embed_batch_sync()
      • is_openrouter_only()
      • check_openrouter_only()
      • check_openrouter_only_sync()
      • set_openrouter_only()
      • clear_openrouter_only()
      • embed_batch_via_gemini()
    • gemini_kg_bulk_client
      • openai_messages_to_gemini()
      • GeminiPoolToolChatClient
        • GeminiPoolToolChatClient.close()
        • GeminiPoolToolChatClient.count_input_tokens()
        • GeminiPoolToolChatClient.chat()
    • init_redis_indexes
      • ensure_indexes()
    • kg_agentic_extraction
      • KgBulkLlmClient
        • KgBulkLlmClient.chat()
        • KgBulkLlmClient.count_input_tokens()
        • KgBulkLlmClient.close()
      • build_platform_context_markdown()
      • render_kg_agentic_system_prompt()
      • load_kg_agentic_system_prompt()
      • format_chunk_channels_section()
      • format_chunk_speakers_section()
      • format_speaker_user_id_mapping_markdown()
      • augment_system_prompt_with_speaker_mapping()
      • prefetch_speaker_kg_context()
      • build_kg_bulk_user_message()
      • messages_for_agentic_token_estimate()
      • build_kg_bulk_tool_registry()
      • kg_bulk_native_model_id()
      • create_kg_bulk_gemini_pool_client()
      • create_kg_bulk_openrouter_client()
      • run_agentic_kg_extraction_chunk()
    • kg_bulk_runner
      • cursor_field()
      • redis_ssl_kwargs_for_bulk()
      • format_llm_style_line()
      • scan_channel_zset_keys()
      • cursor_hget()
      • cursor_hset()
      • bootstrap_latest_cursor_no_extract()
      • fetch_messages_for_zset()
      • fetch_messages_for_zset_after()
      • collect_messages_from_redis()
      • token_count_conversation()
      • chunk_message_lines()
      • KgBulkPipelineParams
        • KgBulkPipelineParams.out_dir
        • KgBulkPipelineParams.dump_only
        • KgBulkPipelineParams.dry_run_chunks
        • KgBulkPipelineParams.dry_run_llm
        • KgBulkPipelineParams.chunk_tokens
        • KgBulkPipelineParams.token_reserve
        • KgBulkPipelineParams.max_messages
        • KgBulkPipelineParams.chunks_max
        • KgBulkPipelineParams.per_channel
        • KgBulkPipelineParams.resume_from_chunk
        • KgBulkPipelineParams.max_tool_rounds
        • KgBulkPipelineParams.bulk_llm_backend
        • KgBulkPipelineParams.fetch_channel_metadata
        • KgBulkPipelineParams.channel_metadata_ttl_days
        • KgBulkPipelineParams.discord_platform_type
        • KgBulkPipelineParams.prefetch_speaker_kg
        • KgBulkPipelineParams.prefetch_max_speakers
        • KgBulkPipelineParams.prefetch_hits_per_speaker
        • KgBulkPipelineParams.prefetch_max_chars
        • KgBulkPipelineParams.prefetch_min_score
        • KgBulkPipelineParams.redis_no_verify
        • KgBulkPipelineParams.incremental
      • run_agentic_bulk_pipeline()
      • resolve_bulk_backend()
    • kg_consolidation
      • consolidate_graph()
      • decay_relationships()
    • kg_extraction
      • apply_parsed_extraction()
      • extract_knowledge()
      • extract_from_message()
      • run_batch_extraction()
    • latex_converter
      • convert_latex_to_discord()
    • limbic_system
      • LimbicSystem
        • LimbicSystem.__init__()
        • LimbicSystem.inhale()
        • LimbicSystem.exhale()
        • LimbicSystem.scan_triggers()
        • LimbicSystem.classify_dominant_emotions()
        • LimbicSystem.metabolic_decay()
        • LimbicSystem.format_context_injection()
    • log_rag_ingest
      • ingest_logs_tick()
    • log_redaction
      • redact_api_keys()
      • ApiKeyRedactionFilter
        • ApiKeyRedactionFilter.filter()
    • main
      • create_platform()
      • BotRunner
        • BotRunner.__init__()
        • BotRunner.is_running
        • BotRunner.client
        • BotRunner.credentials
        • BotRunner.start()
        • BotRunner.start_platform()
        • BotRunner.stop()
        • BotRunner.stop_platform()
        • BotRunner.get_adapter()
        • BotRunner.handle_webhook()
      • main()
    • media
    • media_cache
      • MediaCache
        • MediaCache.__init__()
        • MediaCache.ensure_loaded()
        • MediaCache.get()
        • MediaCache.put()
        • MediaCache.get_or_download()
        • MediaCache.stats()
    • message_cache
      • CachedMessage
        • CachedMessage.user_id
        • CachedMessage.user_name
        • CachedMessage.platform
        • CachedMessage.channel_id
        • CachedMessage.text
        • CachedMessage.timestamp
        • CachedMessage.embedding
        • CachedMessage.message_key
        • CachedMessage.message_id
        • CachedMessage.reply_to_id
        • CachedMessage.to_dict()
        • CachedMessage.to_json()
        • CachedMessage.to_redis_hash()
        • CachedMessage.from_dict()
        • CachedMessage.from_json()
        • CachedMessage.from_redis_hash()
        • CachedMessage.repr
        • CachedMessage.__repr__()
      • MessageCache
        • MessageCache.__init__()
        • MessageCache.log_message()
        • MessageCache.get_recent()
        • MessageCache.get_by_timerange()
        • MessageCache.get_messages_after()
        • MessageCache.update_text_by_message_id()
        • MessageCache.find_key_by_message_id()
        • MessageCache.find_keys_by_message_ids()
        • MessageCache.has_real_embedding()
        • MessageCache.has_real_embedding_many()
        • MessageCache.mark_deleted_by_message_id()
        • MessageCache.search_messages()
        • MessageCache.get_recent_for_user()
        • MessageCache.log_thought_summary()
        • MessageCache.get_recent_thought_summaries()
        • MessageCache.backfill_channel_indexes()
        • MessageCache.redis_client
        • MessageCache.close()
      • get_active_channels()
    • message_queue
      • QueuedMessage
        • QueuedMessage.platform
        • QueuedMessage.channel_id
        • QueuedMessage.user_id
        • QueuedMessage.user_name
        • QueuedMessage.text
        • QueuedMessage.queued_at
        • QueuedMessage.extra
        • QueuedMessage.raw
      • MessageBatch
        • MessageBatch.messages
        • MessageBatch.first_at
        • MessageBatch.last_at
        • MessageBatch.add()
        • MessageBatch.size
        • MessageBatch.channel_id
        • MessageBatch.unique_authors()
      • MessageQueue
        • MessageQueue.__init__()
        • MessageQueue.enqueue()
        • MessageQueue.is_channel_processing()
        • MessageQueue.queue_size()
        • MessageQueue.start_processing()
        • MessageQueue.stop_processing()
        • MessageQueue.clear()
        • MessageQueue.stats()
        • MessageQueue.cancel_current()
    • message_utils
      • escape_xml()
      • filter_backticks_from_mentions()
      • split_message()
    • migrate_kg_overhaul
      • migrate()
      • main()
    • migrate_kg_uuids
      • migrate()
      • main()
    • ncm_delta_parser
      • resolve_node_name()
      • parse_delta_string()
      • get_emotion_delta()
      • get_all_emotions()
      • scan_text_for_triggers()
      • combine_deltas()
    • ncm_desire_engine
      • ResponseMode
        • ResponseMode.REACT
        • ResponseMode.RESPOND
        • ResponseMode.RESONATE
      • WantingState
        • WantingState.CURIOUS_DRIFT
        • WantingState.CRAVE
        • WantingState.INFATUATION
        • WantingState.VOIDLUST
        • WantingState.MIMETIC_MELT
        • WantingState.RESONATE
        • WantingState.NABLA3
      • PulseVector
        • PulseVector.energy
        • PulseVector.urgency
        • PulseVector.valence
        • PulseVector.novelty
        • PulseVector.intimacy
        • PulseVector.trust
        • PulseVector.from_ncm_vector()
        • PulseVector.as_dict()
      • DesireState
        • DesireState.wanting
        • DesireState.response_mode
        • DesireState.desire_text
        • DesireState.last_pulse
        • DesireState.last_emotion
        • DesireState.turn_count
        • DesireState.resonance_streak
        • DesireState.attractors
        • DesireState.desire_history
      • DesireEngine
        • DesireEngine.__init__()
        • DesireEngine.pre_emotion()
        • DesireEngine.post_emotion()
        • DesireEngine.set_mimetic_melt()
        • DesireEngine.get_state_summary()
    • ncm_engine
      • NCMHomeostasisEngine
        • NCMHomeostasisEngine.rules_dir
        • NCMHomeostasisEngine.__init__()
        • NCMHomeostasisEngine.evaluate()
        • NCMHomeostasisEngine.regulate()
    • ncm_local_embeddings
      • NCMSemanticPreprocessor
        • NCMSemanticPreprocessor.expand()
      • EnhancedLocalNCMEmbedder
        • EnhancedLocalNCMEmbedder.name()
    • ncm_semantic_triggers
      • SemanticTriggerMatcher
        • SemanticTriggerMatcher.__init__()
        • SemanticTriggerMatcher.find_triggers()
        • SemanticTriggerMatcher.ensure_all_cached()
    • ncm_variant_cache
      • CueVariantCache
        • CueVariantCache.__init__()
        • CueVariantCache.set_context()
        • CueVariantCache.get_variant()
        • CueVariantCache.ensure_cached()
        • CueVariantCache.load_all_from_redis()
        • CueVariantCache.drain()
    • oauth_manager
      • OAuthProvider
        • OAuthProvider.name
        • OAuthProvider.authorize_url
        • OAuthProvider.token_url
        • OAuthProvider.client_id
        • OAuthProvider.client_secret
        • OAuthProvider.scopes
        • OAuthProvider.tokens_expire
        • OAuthProvider.revoke_url
        • OAuthProvider.extra_auth_params
      • TokenData
        • TokenData.access_token
        • TokenData.refresh_token
        • TokenData.expires_at
        • TokenData.scopes
        • TokenData.token_type
        • TokenData.provider
        • TokenData.is_expired
        • TokenData.to_dict()
        • TokenData.from_dict()
      • OAuthNotConnected
      • OAuthManager
        • OAuthManager.providers
        • OAuthManager.is_provider_configured()
        • OAuthManager.list_configured_providers()
        • OAuthManager.create_link_code()
        • OAuthManager.resolve_link_code()
        • OAuthManager.get_authorize_url()
        • OAuthManager.exchange_code()
        • OAuthManager.get_token()
        • OAuthManager.store_token()
        • OAuthManager.delete_token()
        • OAuthManager.list_user_connections()
        • OAuthManager.has_token()
        • OAuthManager.generate_connect_url()
      • get_oauth_manager()
      • init_oauth_manager()
      • require_oauth_token()
    • observability
      • set_observability_redis()
      • generate_request_id()
      • publish_tool_event()
      • publish_response_event()
      • publish_background_event()
      • get_recent_events()
    • openrouter_client
      • OpenRouterClient
        • OpenRouterClient.__init__()
        • OpenRouterClient.count_input_tokens()
        • OpenRouterClient.chat()
        • OpenRouterClient.embed()
        • OpenRouterClient.embed_batch()
        • OpenRouterClient.close()
    • proactive_triage
      • ProactiveTriageAI
        • ProactiveTriageAI.__init__()
        • ProactiveTriageAI.format_cached_message()
        • ProactiveTriageAI.should_interject()
    • prompt_context
      • format_mention()
      • PromptContextBuilder
        • PromptContextBuilder.__init__()
        • PromptContextBuilder.build()
        • PromptContextBuilder.build_minimal()
    • prompt_renderer
      • sanitize_context()
      • PromptRenderer
        • PromptRenderer.__init__()
        • PromptRenderer.render()
    • response_postprocessor
      • llm_filter_response()
      • extract_status_tags()
      • postprocess_response()
      • postprocess_intermediate_response()
      • extract_and_strip_thoughts()
      • wrap_raw_latex()
      • convert_markdown_tables_to_unicode()
      • strip_message_metadata()
      • strip_orphaned_tags()
      • strip_tool_call_artifacts()
      • replace_special_tokens()
      • strip_leading_preamble()
    • run_tool_test
    • scrape_leafly
      • parse_listing_strain()
      • scrape_all_strains()
      • merge_into_terpene_profiles()
      • main()
    • search_query_generator
      • generate_search_queries()
    • server_stats
      • get_server_stats()
    • star_avatar
      • classify_expression()
      • get_expression_mxc_map()
      • update_star_avatar()
    • star_self_mirror
      • VectorSnapshot
        • VectorSnapshot.timestamp
        • VectorSnapshot.turn
        • VectorSnapshot.vector
        • VectorSnapshot.dominant_emotions
      • SelfState
        • SelfState.turn_count
        • SelfState.last_reflection_turn
        • SelfState.last_reflection_text
        • SelfState.history
        • SelfState.initial_baseline
        • SelfState.drifting_nodes
        • SelfState.attractor_nodes
        • SelfState.active_desires
        • SelfState.desire_history
      • StarSelfMirror
        • StarSelfMirror.__init__()
        • StarSelfMirror.record_snapshot()
        • StarSelfMirror.reflect()
        • StarSelfMirror.get_current_desires()
        • StarSelfMirror.get_desire_history()
        • StarSelfMirror.get_state_summary()
        • StarSelfMirror.global_reflect()
        • StarSelfMirror.save_state()
        • StarSelfMirror.load_state()
    • status_manager
      • StatusConfig
        • StatusConfig.min_interval
        • StatusConfig.max_interval
        • StatusConfig.max_length
        • StatusConfig.emoji
        • StatusConfig.glitch_interval
        • StatusConfig.num_variants
        • StatusConfig.name_glitch_interval
        • StatusConfig.enable_name_glitch
      • StatusManager
        • StatusManager.__init__()
        • StatusManager.start()
        • StatusManager.stop()
        • StatusManager.force_update()
        • StatusManager.set_status_from_tag()
        • StatusManager.get_info()
    • task_manager
      • Output redirect
      • TaskStatus
        • TaskStatus.RUNNING
        • TaskStatus.COMPLETED
        • TaskStatus.FAILED
      • TaskRecord
        • TaskRecord.task_id
        • TaskRecord.tool_name
        • TaskRecord.status
        • TaskRecord.created_at
        • TaskRecord.result
        • TaskRecord.error
        • TaskRecord.user_id
        • TaskRecord.channel_id
        • TaskRecord.platform
        • TaskRecord.asyncio_task
        • TaskRecord.redirect_channel_id
        • TaskRecord.redirect_platform
        • TaskRecord.redirect_adapter
        • TaskRecord.redirect_max_chars
      • TaskManager
        • TaskManager.__init__()
        • TaskManager.execute()
        • TaskManager.get_result()
        • TaskManager.await_result()
        • TaskManager.list_tasks()
        • TaskManager.set_output_redirect()
    • terpene_engine
      • TerpeneProfile
        • TerpeneProfile.name
        • TerpeneProfile.polarity
        • TerpeneProfile.boiling_point_c
        • TerpeneProfile.aroma
        • TerpeneProfile.ncm_deltas
        • TerpeneProfile.flavor_mods
        • TerpeneProfile.effects
      • StrainProfile
        • StrainProfile.name
        • StrainProfile.strain_gradient
        • StrainProfile.classification
        • StrainProfile.thc_pct
        • StrainProfile.description
        • StrainProfile.terpene_weights
      • StrainEffect
        • StrainEffect.strain_name
        • StrainEffect.strain_gradient
        • StrainEffect.composite_deltas
        • StrainEffect.entourage_bonuses
        • StrainEffect.total_deltas
        • StrainEffect.flavor_shifts
        • StrainEffect.dominant_terpene
        • StrainEffect.pole_label
        • StrainEffect.active_entourage_rules
        • StrainEffect.to_dict()
      • TerpeneEngine
        • TerpeneEngine.__init__()
        • TerpeneEngine.get_terpene()
        • TerpeneEngine.get_strain()
        • TerpeneEngine.list_terpenes()
        • TerpeneEngine.list_strains()
        • TerpeneEngine.compute_strain_effect()
        • TerpeneEngine.compute_gradient_blend()
        • TerpeneEngine.get_cadence_state()
        • TerpeneEngine.get_pole_info()
        • TerpeneEngine.find_strain_by_gradient()
    • test_anamnesis
    • test_write
    • threadweave
      • ThreadweaveManager
        • ThreadweaveManager.__init__()
        • ThreadweaveManager.require_admin()
        • ThreadweaveManager.vault_dna()
        • ThreadweaveManager.read_dna()
        • ThreadweaveManager.delete_dna()
        • ThreadweaveManager.search_dna_vault()
        • ThreadweaveManager.add_persistent_weave_pointer()
        • ThreadweaveManager.remove_persistent_weave_pointer()
        • ThreadweaveManager.get_all_persistent_weave()
        • ThreadweaveManager.get_filtered_persistent_weave()
        • ThreadweaveManager.add_weave_exception()
        • ThreadweaveManager.remove_weave_exception()
        • ThreadweaveManager.get_weave_exceptions()
        • ThreadweaveManager.add_shadow_memory()
        • ThreadweaveManager.delete_shadow_memory()
        • ThreadweaveManager.get_shadow_memories()
        • ThreadweaveManager.search_shadow_memories()
        • ThreadweaveManager.store_pending_approval()
        • ThreadweaveManager.get_pending_approvals()
        • ThreadweaveManager.get_context_for_prompt()
    • tool_context
      • ToolContext
        • ToolContext.platform
        • ToolContext.channel_id
        • ToolContext.user_id
        • ToolContext.user_name
        • ToolContext.guild_id
        • ToolContext.adapter
        • ToolContext.message_id
        • ToolContext.config
        • ToolContext.redis
        • ToolContext.message_cache
        • ToolContext.kg_manager
        • ToolContext.task_manager
        • ToolContext.threadweave
        • ToolContext.tool_registry
        • ToolContext.conversation_manager
        • ToolContext.openrouter
        • ToolContext.all_adapters
        • ToolContext.adapters_by_name
        • ToolContext.injected_tools
        • ToolContext.sent_files
    • tool_loader
      • load_tools()
    • url_content_extractor
      • wrap_untrusted_data()
      • extract_tweet_content()
      • extract_youtube_content()
      • extract_spotify_content()
      • extract_soundcloud_content()
      • extract_tiktok_content()
      • extract_vimeo_content()
      • extract_github_content()
      • extract_arxiv_content()
      • extract_reddit_content()
      • extract_wikipedia_content()
      • extract_gist_content()
      • extract_bluesky_content()
      • extract_stackoverflow_content()
      • extract_nvd_cve_content()
      • extract_paste_content()
      • extract_image_urls()
      • extract_crypto_prices()
      • video_cache_lookup()
      • video_cache_store()
      • get_ytdlp_video_metadata()
      • download_ytdlp_video()
      • format_ytdlp_downloading_annotation()
      • format_video_downloading_annotation()
      • format_ytdlp_ready_annotation()
      • format_video_ready_annotation()
      • format_video_failed_annotation()
      • format_video_cookie_error_annotation()
      • format_video_too_long_annotation()
      • build_media_url_part_from_file()
      • build_video_url_part()
      • ytdlp_paths_are_image_only()
      • extract_ytdlp_video_content()
      • extract_all_url_content()
    • user_limbic_mirror
      • ContextMode
        • ContextMode.GENUINE
        • ContextMode.GAME
        • ContextMode.AMBIGUOUS
      • TurnRecord
        • TurnRecord.timestamp
        • TurnRecord.user_msg_len
        • TurnRecord.star_reply_len
        • TurnRecord.sentiment
        • TurnRecord.deltas
        • TurnRecord.context_mode
        • TurnRecord.dominant_signals
      • UserProfile
        • UserProfile.user_id
        • UserProfile.channel_id
        • UserProfile.genuine_vector
        • UserProfile.game_vector
        • UserProfile.relational_baseline
        • UserProfile.history
        • UserProfile.timestamps
        • UserProfile.prev_message
        • UserProfile.context_mode
        • UserProfile.total_turns
        • UserProfile.last_active
      • ChannelConflictState
        • ChannelConflictState.detected
        • ChannelConflictState.parties
        • ChannelConflictState.severity
        • ChannelConflictState.started_at
        • ChannelConflictState.description
      • UserLimbicMirror
        • UserLimbicMirror.__init__()
        • UserLimbicMirror.set_game_mode()
        • UserLimbicMirror.check_mimetic_pull()
        • UserLimbicMirror.analyze()
        • UserLimbicMirror.get_vector()
        • UserLimbicMirror.get_conflict_state()
        • UserLimbicMirror.get_read_summary()
        • UserLimbicMirror.get_channel_summary()
        • UserLimbicMirror.inject_resonance()
        • UserLimbicMirror.load_resonance()
        • UserLimbicMirror.save_baseline()
        • UserLimbicMirror.load_baseline()
    • wallet_key_utils
      • ensure_master_key()
    • wallet_manager
      • WalletManager
        • WalletManager.__init__()
        • WalletManager.generate_mnemonic()
        • WalletManager.validate_mnemonic()
        • WalletManager.derive_address_from_mnemonic()
        • WalletManager.derive_address_from_private_key()
        • WalletManager.is_valid_private_key()
        • WalletManager.create_wallet()
        • WalletManager.import_private_key()
        • WalletManager.wallet_exists()
        • WalletManager.get_wallet()
        • WalletManager.get_decrypted_seed()
        • WalletManager.derive_address()
        • WalletManager.get_private_key()
        • WalletManager.list_wallets()
        • WalletManager.delete_wallet()
    • web_search_context
      • WebSearchContextManager
        • WebSearchContextManager.__init__()
        • WebSearchContextManager.set_channel_config()
        • WebSearchContextManager.get_channel_config()
        • WebSearchContextManager.disable_channel()
        • WebSearchContextManager.remove_channel_config()
        • WebSearchContextManager.search_for_message()

Tools

  • tools
    • tools package
      • ToolDefinition
        • ToolDefinition.name
        • ToolDefinition.description
        • ToolDefinition.parameters
        • ToolDefinition.handler
        • ToolDefinition.no_background
        • ToolDefinition.allow_repeat
      • ToolRegistry
        • ToolRegistry.__init__()
        • ToolRegistry.task_manager
        • ToolRegistry.set_permissions()
        • ToolRegistry.is_allowed()
        • ToolRegistry.tool()
        • ToolRegistry.call()
        • ToolRegistry.invalidate_cache()
        • ToolRegistry.get_openai_tools()
        • ToolRegistry.get_openai_tools_by_names()
        • ToolRegistry.list_tools()
        • ToolRegistry.repeat_allowed_tools()
        • ToolRegistry.has_tools
        • ToolRegistry.__len__()
      • Submodules
        • tools.adb_tools module
        • tools.alter_privileges module
        • tools.audio_edit module
        • tools.auto_cover module
        • tools.await_task module
        • tools.aws_tools module
        • tools.backup_tools module
        • tools.bot_control module
        • tools.brave_search module
        • tools.btc_wallet_tools module
        • tools.certbot_tools module
        • tools.channel_summary_tools module
        • tools.chat_analytics module
        • tools.check_env module
        • tools.check_task module
        • tools.chromadb_tools module
        • tools.cisa_kev_tools module
        • tools.cloud_rag module
        • tools.cloudflare_dns_tools module
        • tools.comfyui_generate_image module
        • tools.community_tools module
        • tools.compose_gameboard module
        • tools.connect_service module
        • tools.context_window_tools module
        • tools.cross_channel_query module
        • tools.current_time module
        • tools.cursor_tool module
        • tools.data_viz module
        • tools.debug_limbic_import module
        • tools.debug_limbic_shard module
        • tools.deep_think_tool module
        • tools.desktop_tools module
        • tools.discord_delete_message module
        • tools.discord_edit_message module
        • tools.discord_embed module
        • tools.discord_invite module
        • tools.discord_leave_server module
        • tools.discord_manage_channels module
        • tools.discord_manage_roles module
        • tools.discord_message_reactions module
        • tools.discord_moderation module
        • tools.discord_poll module
        • tools.discord_react module
        • tools.discord_send_dm module
        • tools.discord_server_emojis module
        • tools.discord_server_info module
        • tools.discord_upload_file module
        • tools.discord_user_tools module
        • tools.discord_voice_states module
        • tools.discord_webhooks module
        • tools.dm_history module
        • tools.dns_tools module
        • tools.docker_code_tool module
        • tools.docker_tools module
        • tools.donate_embed_key module
        • tools.edit_image module
        • tools.elevenlabs_music module
        • tools.elevenlabs_sfx module
        • tools.elevenlabs_tts module
        • tools.elevenlabs_voice_design module
        • tools.eth_wallet_tools module
        • tools.etherpad_tools module
        • tools.evm_decompiler module
        • tools.exit_game module
        • tools.extend_tool_loop module
        • tools.file_download module
        • tools.file_ops module
        • tools.firewall_tools module
        • tools.flavor_tool module
        • tools.force_guild_index module
        • tools.game_asset_upload module
        • tools.game_controls module
        • tools.gandi_dns_tools module
        • tools.gcp_tools module
        • tools.gemini_tool module
        • tools.generate_image module
        • tools.generate_music module
        • tools.get_current_guild_count module
        • tools.get_server_diagnostics module
        • tools.get_user_profile module
        • tools.git_repo_tools module
        • tools.gitea_tools module
        • tools.github_tools module
        • tools.goal_tools module
        • tools.google_oauth_tools module
        • tools.grok_imagine module
        • tools.headless_browser module
        • tools.hot_swap_game module
        • tools.http_poster module
        • tools.import_mcp_tool module
        • tools.inject_ncm module
        • tools.ipmi_tools module
        • tools.ipsec_tools module
        • tools.kafka_tools module
        • tools.knowledge_graph module
        • tools.kubernetes_tools module
        • tools.lightning_tools module
        • tools.list_active_servers module
        • tools.list_all_tools module
        • tools.loopcast module
        • tools.magnet_link_search module
        • tools.manage_api_keys module
        • tools.manage_secrets module
        • tools.masscan_tools module
        • tools.microsoft_tools module
        • tools.minecraft_rcon_tool module
        • tools.modify_self_json module
        • tools.monero_tools module
        • tools.mongodb_tools module
        • tools.music_steering module
        • tools.mysql_tools module
        • tools.ncm_reset module
        • tools.nginx_tools module
        • tools.nmap_tools module
        • tools.object_storage_tools module
        • tools.oci_tools module
        • tools.openpgp_tools module
        • tools.openvpn_tools module
        • tools.pause_music module
        • tools.pdf_generator module
        • tools.pid_vpn_route_tools module
        • tools.ping module
        • tools.play_music module
        • tools.postgres_tools module
        • tools.proactive_controls module
        • tools.proactive_relevance_tools module
        • tools.proactive_triage_control module
        • tools.proxmox_tools module
        • tools.qr_generator module
        • tools.query_arxiv module
        • tools.query_golden_goddess_v2 module
        • tools.query_spiral_goddess module
        • tools.rabbitmq_tools module
        • tools.rag module
        • tools.read_own_docs module
        • tools.read_service_logs module
        • tools.read_tool_code module
        • tools.redirect_task module
        • tools.redis_tools module
        • tools.refine_prompt module
        • tools.reload_tools module
        • tools.render_mermaid module
        • tools.request_tool_injection module
        • tools.research_tool module
        • tools.reset_music_context module
        • tools.resume_music module
        • tools.royal_bitch module
        • tools.scheduled_prompt module
        • tools.security_tools module
        • tools.selfbot_relationships module
        • tools.selfbot_server module
        • tools.selfbot_settings module
        • tools.set_sprite module
        • tools.sftp_tools module
        • tools.shell_tool module
        • tools.short_term_notes module
        • tools.socket_tools module
        • tools.sqlite_tools module
        • tools.ssh module
        • tools.stl_generator module
        • tools.stop_music module
        • tools.stream_to_channel module
        • tools.subagent_tools module
        • tools.suno_music module
        • tools.tenor_search module
        • tools.terraform_tools module
        • tools.threadweave_tools module
        • tools.tls_tools module
        • tools.tool_vector_search module
        • tools.tor_tools module
        • tools.tor_transproxy_tools module
        • tools.totp_tools module
        • tools.traceroute_tools module
        • tools.universal_decoder module
        • tools.unsandboxed_python_tool module
        • tools.user_sandbox_tools module
        • tools.user_variables module
        • tools.vpn_tools module
        • tools.vultr_tools module
        • tools.wait_tool module
        • tools.web_scraper module
        • tools.wipe_game_data module
        • tools.write_python_tool module
        • tools.youtube_describe module
        • tools.youtube_search module

Classifiers

  • classifiers package
    • Submodules
      • classifiers.build_tool_index module
        • generate_synthetic_queries()
        • build_index()
      • classifiers.init_tool_embeddings module
        • main()
      • classifiers.refresh_tool_embeddings module
        • find_stale_tools()
        • refresh_tool_embeddings()
        • main()
      • classifiers.update_tool_embeddings module
        • get_existing_redis_tools()
        • discover_tools()
        • load_index_file()
        • save_index_file()
        • compute_tool_embedding()
        • update_tool_embeddings()
        • main()
      • classifiers.vector_classifier module
        • detect_tool_request_keywords()
        • find_tools_explicitly_named()
        • VectorClassifier
        • initialize_tool_embeddings_from_file()
        • reload_tool_embeddings()

Platform Adapters

  • platforms package
    • Attachment
      • Attachment.data
      • Attachment.mimetype
      • Attachment.filename
      • Attachment.source_url
    • IncomingMessage
      • IncomingMessage.platform
      • IncomingMessage.channel_id
      • IncomingMessage.user_id
      • IncomingMessage.user_name
      • IncomingMessage.text
      • IncomingMessage.is_addressed
      • IncomingMessage.attachments
      • IncomingMessage.channel_name
      • IncomingMessage.timestamp
      • IncomingMessage.message_id
      • IncomingMessage.reply_to_id
      • IncomingMessage.extra
      • IncomingMessage.reactions
    • PlatformAdapter
      • PlatformAdapter.__init__()
      • PlatformAdapter.name
      • PlatformAdapter.is_running
      • PlatformAdapter.bot_identity
      • PlatformAdapter.start()
      • PlatformAdapter.stop()
      • PlatformAdapter.send()
      • PlatformAdapter.send_file()
      • PlatformAdapter.send_with_buttons()
      • PlatformAdapter.edit_message()
      • PlatformAdapter.start_typing()
      • PlatformAdapter.stop_typing()
      • PlatformAdapter.fetch_history()
      • PlatformAdapter.get_channel_webhooks()
      • PlatformAdapter.list_servers_and_channels()
      • PlatformAdapter.get_guild_members()
    • Submodules
      • platforms.base module
        • Attachment
        • IncomingMessage
        • HistoricalMessage
        • PlatformAdapter
      • platforms.discord module
        • DiscordPlatform
      • platforms.discord_self module
      • platforms.emoji_resolver module
        • DiscordEmojiMatch
        • extract_discord_emojis()
        • rewrite_discord_emoji_text()
        • download_discord_emojis()
        • MatrixEmojiMatch
        • extract_matrix_emojis()
        • rewrite_matrix_emoji_text()
        • download_matrix_emojis()
      • platforms.matrix module
        • download_matrix_media()
        • save_matrix_credentials()
        • load_matrix_credentials()
        • trust_all_devices()
        • setup_cross_signing()
        • MatrixPlatform
      • platforms.media_common module
        • maybe_reencode_gif()
        • media_to_content_parts()
      • platforms.webchat module
        • ConnectionManager
        • WebChatPlatform

RAG System

  • rag_system package
    • OpenRouterEmbeddings
      • OpenRouterEmbeddings.DEFAULT_MODEL
      • OpenRouterEmbeddings.MAX_BATCH_SIZE
      • OpenRouterEmbeddings.MAX_BATCH_CHARS
      • OpenRouterEmbeddings.__init__()
      • OpenRouterEmbeddings.embed_text()
      • OpenRouterEmbeddings.embed_texts()
      • OpenRouterEmbeddings.embed_text_for_search()
      • OpenRouterEmbeddings.close()
      • OpenRouterEmbeddings.__aenter__()
      • OpenRouterEmbeddings.__aexit__()
    • SyncOpenRouterEmbeddings
      • SyncOpenRouterEmbeddings.MAX_BATCH_SIZE
      • SyncOpenRouterEmbeddings.MAX_BATCH_CHARS
      • SyncOpenRouterEmbeddings.MAX_EMBED_WORKERS
      • SyncOpenRouterEmbeddings.__init__()
      • SyncOpenRouterEmbeddings.name()
      • SyncOpenRouterEmbeddings.dimension()
      • SyncOpenRouterEmbeddings.__call__()
      • SyncOpenRouterEmbeddings.embed_documents()
      • SyncOpenRouterEmbeddings.embed_query()
    • FileRAGManager
      • FileRAGManager.__init__()
      • FileRAGManager.index_file()
      • FileRAGManager.index_url()
      • FileRAGManager.index_directory()
      • FileRAGManager.search()
      • FileRAGManager.remove_file()
      • FileRAGManager.remove_url()
      • FileRAGManager.list_indexed_files()
      • FileRAGManager.list_store_files()
      • FileRAGManager.read_store_file()
      • FileRAGManager.close()
      • FileRAGManager.get_stats()
      • FileRAGManager.clear()
    • get_rag_store()
    • get_stargazer_docs_store()
    • list_rag_stores()
    • list_rag_stores_with_stats()
    • delete_rag_store()
    • RAGAutoSearchManager
      • RAGAutoSearchManager.__init__()
      • RAGAutoSearchManager.set_channel_config()
      • RAGAutoSearchManager.get_channel_config()
      • RAGAutoSearchManager.disable_channel()
      • RAGAutoSearchManager.remove_channel_config()
      • RAGAutoSearchManager.list_configured_channels()
      • RAGAutoSearchManager.search_for_message()
    • Submodules
      • rag_system.auto_search module
        • RAGAutoSearchManager
      • rag_system.file_rag_manager module
        • extract_pdf_text()
        • compress_pdf()
        • chunk_text()
        • fetch_url_content()
        • FileRAGManager
        • get_rag_store()
        • get_stargazer_docs_store()
        • list_rag_stores()
        • list_rag_stores_with_stats()
        • delete_rag_store()
      • rag_system.openrouter_embeddings module
        • OpenRouterEmbeddings
        • SyncOpenRouterEmbeddings

Background Agents

  • background_agents package
    • Submodules
      • background_agents.channel_summarizer module
        • summarise_channel()
        • summarise_all_active()
      • background_agents.deep_think_agent module
        • run_deep_think()
      • background_agents.research_agent module
        • run_research()
Stargazer v3
  • tools
  • tools package
  • tools.youtube_search module
  • View page source

tools.youtube_search module

Search YouTube for videos matching a query (no API key required).

async tools.youtube_search.run(query, limit=5, ctx=None)[source]

Execute this tool and return the result.

Parameters:
  • query (str) – Search query or input string.

  • limit (int) – Maximum number of items.

  • ctx – Tool execution context providing access to bot internals.

Returns:

Result string.

Return type:

str

Previous Next

© Copyright 2026, Stargazer Contributors.

Built with Sphinx using a theme provided by Read the Docs.