#
tokens: 44058/50000 2/1784 files (page 101/145)
lines: on (toggle) GitHub
raw markdown copy reset
This is page 101 of 145. Use http://codebase.md/microsoft/semanticworkbench?lines=true&page={x} to view the full context.

# Directory Structure

```
├── .devcontainer
│   ├── .vscode
│   │   └── settings.json
│   ├── devcontainer.json
│   ├── OPTIMIZING_FOR_CODESPACES.md
│   ├── POST_SETUP_README.md
│   └── README.md
├── .dockerignore
├── .gitattributes
├── .github
│   ├── policheck.yml
│   └── workflows
│       ├── assistants-codespace-assistant.yml
│       ├── assistants-document-assistant.yml
│       ├── assistants-explorer-assistant.yml
│       ├── assistants-guided-conversation-assistant.yml
│       ├── assistants-knowledge-transfer-assistant.yml
│       ├── assistants-navigator-assistant.yml
│       ├── assistants-project-assistant.yml
│       ├── assistants-prospector-assistant.yml
│       ├── assistants-skill-assistant.yml
│       ├── libraries.yml
│       ├── mcp-server-giphy.yml
│       ├── mcp-server-memory-filesystem-edit.yml
│       ├── mcp-server-memory-user-bio.yml
│       ├── mcp-server-memory-whiteboard.yml
│       ├── mcp-server-open-deep-research-clone.yml
│       ├── mcp-server-web-research.yml
│       ├── workbench-app.yml
│       └── workbench-service.yml
├── .gitignore
├── .multi-root-tools
│   ├── Makefile
│   └── README.md
├── .vscode
│   ├── extensions.json
│   ├── launch.json
│   └── settings.json
├── ai_context
│   └── generated
│       ├── ASPIRE_ORCHESTRATOR.md
│       ├── ASSISTANT_CODESPACE.md
│       ├── ASSISTANT_DOCUMENT.md
│       ├── ASSISTANT_NAVIGATOR.md
│       ├── ASSISTANT_PROJECT.md
│       ├── ASSISTANT_PROSPECTOR.md
│       ├── ASSISTANTS_OTHER.md
│       ├── ASSISTANTS_OVERVIEW.md
│       ├── CONFIGURATION.md
│       ├── DOTNET_LIBRARIES.md
│       ├── EXAMPLES.md
│       ├── MCP_SERVERS.md
│       ├── PYTHON_LIBRARIES_AI_CLIENTS.md
│       ├── PYTHON_LIBRARIES_CORE.md
│       ├── PYTHON_LIBRARIES_EXTENSIONS.md
│       ├── PYTHON_LIBRARIES_SKILLS.md
│       ├── PYTHON_LIBRARIES_SPECIALIZED.md
│       ├── TOOLS.md
│       ├── WORKBENCH_FRONTEND.md
│       └── WORKBENCH_SERVICE.md
├── aspire-orchestrator
│   ├── .editorconfig
│   ├── Aspire.AppHost
│   │   ├── .gitignore
│   │   ├── appsettings.json
│   │   ├── Aspire.AppHost.csproj
│   │   ├── Program.cs
│   │   └── Properties
│   │       └── launchSettings.json
│   ├── Aspire.Extensions
│   │   ├── Aspire.Extensions.csproj
│   │   ├── Dashboard.cs
│   │   ├── DockerFileExtensions.cs
│   │   ├── PathNormalizer.cs
│   │   ├── UvAppHostingExtensions.cs
│   │   ├── UvAppResource.cs
│   │   ├── VirtualEnvironment.cs
│   │   └── WorkbenchServiceHostingExtensions.cs
│   ├── Aspire.ServiceDefaults
│   │   ├── Aspire.ServiceDefaults.csproj
│   │   └── Extensions.cs
│   ├── README.md
│   ├── run.sh
│   ├── SemanticWorkbench.Aspire.sln
│   └── SemanticWorkbench.Aspire.sln.DotSettings
├── assistants
│   ├── codespace-assistant
│   │   ├── .claude
│   │   │   └── settings.local.json
│   │   ├── .env.example
│   │   ├── .vscode
│   │   │   ├── extensions.json
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── assistant
│   │   │   ├── __init__.py
│   │   │   ├── assets
│   │   │   │   ├── icon_context_transfer.svg
│   │   │   │   └── icon.svg
│   │   │   ├── chat.py
│   │   │   ├── config.py
│   │   │   ├── helpers.py
│   │   │   ├── response
│   │   │   │   ├── __init__.py
│   │   │   │   ├── completion_handler.py
│   │   │   │   ├── models.py
│   │   │   │   ├── request_builder.py
│   │   │   │   ├── response.py
│   │   │   │   ├── step_handler.py
│   │   │   │   └── utils
│   │   │   │       ├── __init__.py
│   │   │   │       ├── abbreviations.py
│   │   │   │       ├── formatting_utils.py
│   │   │   │       ├── message_utils.py
│   │   │   │       └── openai_utils.py
│   │   │   ├── text_includes
│   │   │   │   ├── card_content_context_transfer.md
│   │   │   │   ├── card_content.md
│   │   │   │   ├── codespace_assistant_info.md
│   │   │   │   ├── context_transfer_assistant_info.md
│   │   │   │   ├── guardrails_prompt.txt
│   │   │   │   ├── guidance_prompt_context_transfer.txt
│   │   │   │   ├── guidance_prompt.txt
│   │   │   │   ├── instruction_prompt_context_transfer.txt
│   │   │   │   └── instruction_prompt.txt
│   │   │   └── whiteboard
│   │   │       ├── __init__.py
│   │   │       ├── _inspector.py
│   │   │       └── _whiteboard.py
│   │   ├── assistant.code-workspace
│   │   ├── Makefile
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   └── uv.lock
│   ├── document-assistant
│   │   ├── .env.example
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── assistant
│   │   │   ├── __init__.py
│   │   │   ├── assets
│   │   │   │   └── icon.svg
│   │   │   ├── chat.py
│   │   │   ├── config.py
│   │   │   ├── context_management
│   │   │   │   ├── __init__.py
│   │   │   │   └── inspector.py
│   │   │   ├── filesystem
│   │   │   │   ├── __init__.py
│   │   │   │   ├── _convert.py
│   │   │   │   ├── _file_sources.py
│   │   │   │   ├── _filesystem.py
│   │   │   │   ├── _inspector.py
│   │   │   │   ├── _model.py
│   │   │   │   ├── _prompts.py
│   │   │   │   └── _tasks.py
│   │   │   ├── guidance
│   │   │   │   ├── __init__.py
│   │   │   │   ├── dynamic_ui_inspector.py
│   │   │   │   ├── guidance_config.py
│   │   │   │   ├── guidance_prompts.py
│   │   │   │   └── README.md
│   │   │   ├── response
│   │   │   │   ├── __init__.py
│   │   │   │   ├── completion_handler.py
│   │   │   │   ├── models.py
│   │   │   │   ├── prompts.py
│   │   │   │   ├── responder.py
│   │   │   │   └── utils
│   │   │   │       ├── __init__.py
│   │   │   │       ├── formatting_utils.py
│   │   │   │       ├── message_utils.py
│   │   │   │       ├── openai_utils.py
│   │   │   │       ├── tokens_tiktoken.py
│   │   │   │       └── workbench_messages.py
│   │   │   ├── text_includes
│   │   │   │   └── document_assistant_info.md
│   │   │   ├── types.py
│   │   │   └── whiteboard
│   │   │       ├── __init__.py
│   │   │       ├── _inspector.py
│   │   │       └── _whiteboard.py
│   │   ├── assistant.code-workspace
│   │   ├── CLAUDE.md
│   │   ├── Makefile
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   ├── tests
│   │   │   ├── __init__.py
│   │   │   ├── test_convert.py
│   │   │   └── test_data
│   │   │       ├── blank_image.png
│   │   │       ├── Formatting Test.docx
│   │   │       ├── sample_data.csv
│   │   │       ├── sample_data.xlsx
│   │   │       ├── sample_page.html
│   │   │       ├── sample_presentation.pptx
│   │   │       └── simple_pdf.pdf
│   │   └── uv.lock
│   ├── explorer-assistant
│   │   ├── .env.example
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── assistant
│   │   │   ├── __init__.py
│   │   │   ├── chat.py
│   │   │   ├── config.py
│   │   │   ├── helpers.py
│   │   │   ├── response
│   │   │   │   ├── __init__.py
│   │   │   │   ├── model.py
│   │   │   │   ├── response_anthropic.py
│   │   │   │   ├── response_openai.py
│   │   │   │   └── response.py
│   │   │   └── text_includes
│   │   │       └── guardrails_prompt.txt
│   │   ├── assistant.code-workspace
│   │   ├── Makefile
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   └── uv.lock
│   ├── guided-conversation-assistant
│   │   ├── .env.example
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── assistant
│   │   │   ├── __init__.py
│   │   │   ├── agents
│   │   │   │   ├── guided_conversation
│   │   │   │   │   ├── config.py
│   │   │   │   │   ├── definition.py
│   │   │   │   │   └── definitions
│   │   │   │   │       ├── er_triage.py
│   │   │   │   │       ├── interview.py
│   │   │   │   │       ├── patient_intake.py
│   │   │   │   │       └── poem_feedback.py
│   │   │   │   └── guided_conversation_agent.py
│   │   │   ├── chat.py
│   │   │   ├── config.py
│   │   │   └── text_includes
│   │   │       └── guardrails_prompt.txt
│   │   ├── assistant.code-workspace
│   │   ├── Makefile
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   └── uv.lock
│   ├── knowledge-transfer-assistant
│   │   ├── .claude
│   │   │   └── settings.local.json
│   │   ├── .env.example
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── assistant
│   │   │   ├── __init__.py
│   │   │   ├── agentic
│   │   │   │   ├── __init__.py
│   │   │   │   ├── analysis.py
│   │   │   │   ├── coordinator_support.py
│   │   │   │   └── team_welcome.py
│   │   │   ├── assets
│   │   │   │   ├── icon-knowledge-transfer.svg
│   │   │   │   └── icon.svg
│   │   │   ├── assistant.py
│   │   │   ├── common.py
│   │   │   ├── config.py
│   │   │   ├── conversation_clients.py
│   │   │   ├── conversation_share_link.py
│   │   │   ├── data.py
│   │   │   ├── domain
│   │   │   │   ├── __init__.py
│   │   │   │   ├── audience_manager.py
│   │   │   │   ├── information_request_manager.py
│   │   │   │   ├── knowledge_brief_manager.py
│   │   │   │   ├── knowledge_digest_manager.py
│   │   │   │   ├── learning_objectives_manager.py
│   │   │   │   └── share_manager.py
│   │   │   ├── files.py
│   │   │   ├── logging.py
│   │   │   ├── notifications.py
│   │   │   ├── respond.py
│   │   │   ├── storage_models.py
│   │   │   ├── storage.py
│   │   │   ├── string_utils.py
│   │   │   ├── text_includes
│   │   │   │   ├── assistant_info.md
│   │   │   │   ├── card_content.md
│   │   │   │   ├── coordinator_instructions.txt
│   │   │   │   ├── coordinator_role.txt
│   │   │   │   ├── knowledge_digest_instructions.txt
│   │   │   │   ├── knowledge_digest_prompt.txt
│   │   │   │   ├── share_information_request_detection.txt
│   │   │   │   ├── team_instructions.txt
│   │   │   │   ├── team_role.txt
│   │   │   │   └── welcome_message_generation.txt
│   │   │   ├── tools
│   │   │   │   ├── __init__.py
│   │   │   │   ├── base.py
│   │   │   │   ├── information_requests.py
│   │   │   │   ├── learning_objectives.py
│   │   │   │   ├── learning_outcomes.py
│   │   │   │   ├── progress_tracking.py
│   │   │   │   └── share_setup.py
│   │   │   ├── ui_tabs
│   │   │   │   ├── __init__.py
│   │   │   │   ├── brief.py
│   │   │   │   ├── common.py
│   │   │   │   ├── debug.py
│   │   │   │   ├── learning.py
│   │   │   │   └── sharing.py
│   │   │   └── utils.py
│   │   ├── CLAUDE.md
│   │   ├── docs
│   │   │   ├── design
│   │   │   │   ├── actions.md
│   │   │   │   └── inference.md
│   │   │   ├── DEV_GUIDE.md
│   │   │   ├── how-kta-works.md
│   │   │   ├── JTBD.md
│   │   │   ├── knowledge-transfer-goals.md
│   │   │   ├── learning_assistance.md
│   │   │   ├── notable_claude_conversations
│   │   │   │   ├── clarifying_quad_modal_design.md
│   │   │   │   ├── CLAUDE_PROMPTS.md
│   │   │   │   ├── transfer_state.md
│   │   │   │   └── trying_the_context_agent.md
│   │   │   └── opportunities-of-knowledge-transfer.md
│   │   ├── knowledge-transfer-assistant.code-workspace
│   │   ├── Makefile
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   ├── tests
│   │   │   ├── __init__.py
│   │   │   ├── test_artifact_loading.py
│   │   │   ├── test_inspector.py
│   │   │   ├── test_share_manager.py
│   │   │   ├── test_share_storage.py
│   │   │   ├── test_share_tools.py
│   │   │   └── test_team_mode.py
│   │   └── uv.lock
│   ├── Makefile
│   ├── navigator-assistant
│   │   ├── .env.example
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── assistant
│   │   │   ├── __init__.py
│   │   │   ├── assets
│   │   │   │   ├── card_content.md
│   │   │   │   └── icon.svg
│   │   │   ├── chat.py
│   │   │   ├── config.py
│   │   │   ├── helpers.py
│   │   │   ├── response
│   │   │   │   ├── __init__.py
│   │   │   │   ├── completion_handler.py
│   │   │   │   ├── completion_requestor.py
│   │   │   │   ├── local_tool
│   │   │   │   │   ├── __init__.py
│   │   │   │   │   ├── add_assistant_to_conversation.py
│   │   │   │   │   ├── list_assistant_services.py
│   │   │   │   │   └── model.py
│   │   │   │   ├── models.py
│   │   │   │   ├── prompt.py
│   │   │   │   ├── request_builder.py
│   │   │   │   ├── response.py
│   │   │   │   ├── step_handler.py
│   │   │   │   └── utils
│   │   │   │       ├── __init__.py
│   │   │   │       ├── formatting_utils.py
│   │   │   │       ├── message_utils.py
│   │   │   │       ├── openai_utils.py
│   │   │   │       └── tools.py
│   │   │   ├── text_includes
│   │   │   │   ├── guardrails_prompt.md
│   │   │   │   ├── guidance_prompt.md
│   │   │   │   ├── instruction_prompt.md
│   │   │   │   ├── navigator_assistant_info.md
│   │   │   │   └── semantic_workbench_features.md
│   │   │   └── whiteboard
│   │   │       ├── __init__.py
│   │   │       ├── _inspector.py
│   │   │       └── _whiteboard.py
│   │   ├── Makefile
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   └── uv.lock
│   ├── project-assistant
│   │   ├── .cspell
│   │   │   └── custom-dictionary-workspace.txt
│   │   ├── .env.example
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── assistant
│   │   │   ├── __init__.py
│   │   │   ├── agentic
│   │   │   │   ├── __init__.py
│   │   │   │   ├── act.py
│   │   │   │   ├── coordinator_next_action.py
│   │   │   │   ├── create_invitation.py
│   │   │   │   ├── detect_audience_and_takeaways.py
│   │   │   │   ├── detect_coordinator_actions.py
│   │   │   │   ├── detect_information_request_needs.py
│   │   │   │   ├── detect_knowledge_package_gaps.py
│   │   │   │   ├── focus.py
│   │   │   │   ├── respond.py
│   │   │   │   ├── team_welcome.py
│   │   │   │   └── update_digest.py
│   │   │   ├── assets
│   │   │   │   ├── icon-knowledge-transfer.svg
│   │   │   │   └── icon.svg
│   │   │   ├── assistant.py
│   │   │   ├── common.py
│   │   │   ├── config.py
│   │   │   ├── conversation_clients.py
│   │   │   ├── data.py
│   │   │   ├── domain
│   │   │   │   ├── __init__.py
│   │   │   │   ├── audience_manager.py
│   │   │   │   ├── conversation_preferences_manager.py
│   │   │   │   ├── information_request_manager.py
│   │   │   │   ├── knowledge_brief_manager.py
│   │   │   │   ├── knowledge_digest_manager.py
│   │   │   │   ├── learning_objectives_manager.py
│   │   │   │   ├── share_manager.py
│   │   │   │   ├── tasks_manager.py
│   │   │   │   └── transfer_manager.py
│   │   │   ├── errors.py
│   │   │   ├── files.py
│   │   │   ├── logging.py
│   │   │   ├── notifications.py
│   │   │   ├── prompt_utils.py
│   │   │   ├── storage.py
│   │   │   ├── string_utils.py
│   │   │   ├── text_includes
│   │   │   │   ├── actor_instructions.md
│   │   │   │   ├── assistant_info.md
│   │   │   │   ├── card_content.md
│   │   │   │   ├── coordinator_instructions copy.md
│   │   │   │   ├── coordinator_instructions.md
│   │   │   │   ├── create_invitation.md
│   │   │   │   ├── detect_audience.md
│   │   │   │   ├── detect_coordinator_actions.md
│   │   │   │   ├── detect_information_request_needs.md
│   │   │   │   ├── detect_knowledge_package_gaps.md
│   │   │   │   ├── focus.md
│   │   │   │   ├── knowledge_digest_instructions.txt
│   │   │   │   ├── team_instructions.txt
│   │   │   │   ├── to_do.md
│   │   │   │   ├── update_knowledge_brief.md
│   │   │   │   ├── update_knowledge_digest.md
│   │   │   │   └── welcome_message_generation.txt
│   │   │   ├── tools
│   │   │   │   ├── __init__.py
│   │   │   │   ├── base.py
│   │   │   │   ├── conversation_preferences.py
│   │   │   │   ├── information_requests.py
│   │   │   │   ├── learning_objectives.py
│   │   │   │   ├── learning_outcomes.py
│   │   │   │   ├── progress_tracking.py
│   │   │   │   ├── share_setup.py
│   │   │   │   ├── system_reminders.py
│   │   │   │   ├── tasks.py
│   │   │   │   └── todo.py
│   │   │   ├── ui_tabs
│   │   │   │   ├── __init__.py
│   │   │   │   ├── brief.py
│   │   │   │   ├── common.py
│   │   │   │   ├── debug.py
│   │   │   │   ├── learning.py
│   │   │   │   └── sharing.py
│   │   │   └── utils.py
│   │   ├── CLAUDE.md
│   │   ├── docs
│   │   │   ├── design
│   │   │   │   ├── actions.md
│   │   │   │   ├── control_options.md
│   │   │   │   ├── design.md
│   │   │   │   ├── inference.md
│   │   │   │   └── PXL_20250814_190140267.jpg
│   │   │   ├── DEV_GUIDE.md
│   │   │   ├── how-kta-works.md
│   │   │   ├── JTBD.md
│   │   │   ├── knowledge-transfer-goals.md
│   │   │   ├── learning_assistance.md
│   │   │   ├── notable_claude_conversations
│   │   │   │   ├── clarifying_quad_modal_design.md
│   │   │   │   ├── CLAUDE_PROMPTS.md
│   │   │   │   ├── transfer_state.md
│   │   │   │   └── trying_the_context_agent.md
│   │   │   └── opportunities-of-knowledge-transfer.md
│   │   ├── knowledge-transfer-assistant.code-workspace
│   │   ├── Makefile
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   ├── tests
│   │   │   ├── __init__.py
│   │   │   ├── test_artifact_loading.py
│   │   │   ├── test_inspector.py
│   │   │   ├── test_share_manager.py
│   │   │   ├── test_share_storage.py
│   │   │   └── test_team_mode.py
│   │   └── uv.lock
│   ├── prospector-assistant
│   │   ├── .env.example
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── assistant
│   │   │   ├── __init__.py
│   │   │   ├── agents
│   │   │   │   ├── artifact_agent.py
│   │   │   │   ├── document
│   │   │   │   │   ├── config.py
│   │   │   │   │   ├── gc_draft_content_feedback_config.py
│   │   │   │   │   ├── gc_draft_outline_feedback_config.py
│   │   │   │   │   ├── guided_conversation.py
│   │   │   │   │   └── state.py
│   │   │   │   └── document_agent.py
│   │   │   ├── artifact_creation_extension
│   │   │   │   ├── __init__.py
│   │   │   │   ├── _llm.py
│   │   │   │   ├── config.py
│   │   │   │   ├── document.py
│   │   │   │   ├── extension.py
│   │   │   │   ├── store.py
│   │   │   │   ├── test
│   │   │   │   │   ├── conftest.py
│   │   │   │   │   ├── evaluation.py
│   │   │   │   │   ├── test_completion_with_tools.py
│   │   │   │   │   └── test_extension.py
│   │   │   │   └── tools.py
│   │   │   ├── chat.py
│   │   │   ├── config.py
│   │   │   ├── form_fill_extension
│   │   │   │   ├── __init__.py
│   │   │   │   ├── config.py
│   │   │   │   ├── extension.py
│   │   │   │   ├── inspector.py
│   │   │   │   ├── state.py
│   │   │   │   └── steps
│   │   │   │       ├── __init__.py
│   │   │   │       ├── _guided_conversation.py
│   │   │   │       ├── _llm.py
│   │   │   │       ├── acquire_form_step.py
│   │   │   │       ├── extract_form_fields_step.py
│   │   │   │       ├── fill_form_step.py
│   │   │   │       └── types.py
│   │   │   ├── helpers.py
│   │   │   ├── legacy.py
│   │   │   └── text_includes
│   │   │       ├── artifact_agent_enabled.md
│   │   │       ├── guardrails_prompt.txt
│   │   │       ├── guided_conversation_agent_enabled.md
│   │   │       └── skills_agent_enabled.md
│   │   ├── assistant.code-workspace
│   │   ├── gc_learnings
│   │   │   ├── gc_learnings.md
│   │   │   └── images
│   │   │       ├── gc_conversation_plan_fcn.png
│   │   │       ├── gc_conversation_plan_template.png
│   │   │       ├── gc_execute_plan_callstack.png
│   │   │       ├── gc_functions.png
│   │   │       ├── gc_generate_plan_callstack.png
│   │   │       ├── gc_get_resource_instructions.png
│   │   │       ├── gc_get_termination_instructions.png
│   │   │       ├── gc_kernel_arguments.png
│   │   │       ├── gc_plan_calls.png
│   │   │       ├── gc_termination_instructions.png
│   │   │       ├── sk_get_chat_message_contents.png
│   │   │       ├── sk_inner_get_chat_message_contents.png
│   │   │       ├── sk_send_request_prep.png
│   │   │       └── sk_send_request.png
│   │   ├── Makefile
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   └── uv.lock
│   └── skill-assistant
│       ├── .env.example
│       ├── .vscode
│       │   ├── launch.json
│       │   └── settings.json
│       ├── assistant
│       │   ├── __init__.py
│       │   ├── config.py
│       │   ├── logging.py
│       │   ├── skill_assistant.py
│       │   ├── skill_engine_registry.py
│       │   ├── skill_event_mapper.py
│       │   ├── text_includes
│       │   │   └── guardrails_prompt.txt
│       │   └── workbench_helpers.py
│       ├── assistant.code-workspace
│       ├── Makefile
│       ├── pyproject.toml
│       ├── README.md
│       ├── tests
│       │   └── test_setup.py
│       └── uv.lock
├── CLAUDE.md
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── docs
│   ├── .vscode
│   │   └── settings.json
│   ├── ASSISTANT_CONFIG.md
│   ├── ASSISTANT_DEVELOPMENT_GUIDE.md
│   ├── CUSTOM_APP_REGISTRATION.md
│   ├── HOSTED_ASSISTANT_WITH_LOCAL_MCP_SERVERS.md
│   ├── images
│   │   ├── architecture-animation.gif
│   │   ├── configure_assistant.png
│   │   ├── conversation_canvas_open.png
│   │   ├── conversation_duplicate.png
│   │   ├── conversation_export.png
│   │   ├── conversation_share_dialog.png
│   │   ├── conversation_share_link.png
│   │   ├── dashboard_configured_view.png
│   │   ├── dashboard_view.png
│   │   ├── license_agreement.png
│   │   ├── message_bar.png
│   │   ├── message_inspection.png
│   │   ├── message_link.png
│   │   ├── new_prospector_assistant_dialog.png
│   │   ├── open_conversation_canvas.png
│   │   ├── prospector_example.png
│   │   ├── readme1.png
│   │   ├── readme2.png
│   │   ├── readme3.png
│   │   ├── rewind.png
│   │   ├── signin_page.png
│   │   └── splash_screen.png
│   ├── LOCAL_ASSISTANT_WITH_REMOTE_WORKBENCH.md
│   ├── SETUP_DEV_ENVIRONMENT.md
│   └── WORKBENCH_APP.md
├── examples
│   ├── dotnet
│   │   ├── .editorconfig
│   │   ├── dotnet-01-echo-bot
│   │   │   ├── appsettings.json
│   │   │   ├── dotnet-01-echo-bot.csproj
│   │   │   ├── MyAgent.cs
│   │   │   ├── MyAgentConfig.cs
│   │   │   ├── MyWorkbenchConnector.cs
│   │   │   ├── Program.cs
│   │   │   └── README.md
│   │   ├── dotnet-02-message-types-demo
│   │   │   ├── appsettings.json
│   │   │   ├── ConnectorExtensions.cs
│   │   │   ├── docs
│   │   │   │   ├── abc.png
│   │   │   │   ├── code.png
│   │   │   │   ├── config.png
│   │   │   │   ├── echo.png
│   │   │   │   ├── markdown.png
│   │   │   │   ├── mermaid.png
│   │   │   │   ├── reverse.png
│   │   │   │   └── safety-check.png
│   │   │   ├── dotnet-02-message-types-demo.csproj
│   │   │   ├── MyAgent.cs
│   │   │   ├── MyAgentConfig.cs
│   │   │   ├── MyWorkbenchConnector.cs
│   │   │   ├── Program.cs
│   │   │   └── README.md
│   │   └── dotnet-03-simple-chatbot
│   │       ├── appsettings.json
│   │       ├── ConnectorExtensions.cs
│   │       ├── dotnet-03-simple-chatbot.csproj
│   │       ├── MyAgent.cs
│   │       ├── MyAgentConfig.cs
│   │       ├── MyWorkbenchConnector.cs
│   │       ├── Program.cs
│   │       └── README.md
│   ├── Makefile
│   └── python
│       ├── python-01-echo-bot
│       │   ├── .env.example
│       │   ├── .vscode
│       │   │   ├── launch.json
│       │   │   └── settings.json
│       │   ├── assistant
│       │   │   ├── __init__.py
│       │   │   ├── chat.py
│       │   │   └── config.py
│       │   ├── assistant.code-workspace
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   └── uv.lock
│       ├── python-02-simple-chatbot
│       │   ├── .env.example
│       │   ├── .vscode
│       │   │   ├── launch.json
│       │   │   └── settings.json
│       │   ├── assistant
│       │   │   ├── __init__.py
│       │   │   ├── chat.py
│       │   │   ├── config.py
│       │   │   └── text_includes
│       │   │       └── guardrails_prompt.txt
│       │   ├── assistant.code-workspace
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   └── uv.lock
│       └── python-03-multimodel-chatbot
│           ├── .env.example
│           ├── .vscode
│           │   ├── launch.json
│           │   └── settings.json
│           ├── assistant
│           │   ├── __init__.py
│           │   ├── chat.py
│           │   ├── config.py
│           │   ├── model_adapters.py
│           │   └── text_includes
│           │       └── guardrails_prompt.txt
│           ├── assistant.code-workspace
│           ├── Makefile
│           ├── pyproject.toml
│           ├── README.md
│           └── uv.lock
├── KNOWN_ISSUES.md
├── libraries
│   ├── dotnet
│   │   ├── .editorconfig
│   │   ├── pack.sh
│   │   ├── README.md
│   │   ├── SemanticWorkbench.sln
│   │   ├── SemanticWorkbench.sln.DotSettings
│   │   └── WorkbenchConnector
│   │       ├── AgentBase.cs
│   │       ├── AgentConfig
│   │       │   ├── AgentConfigBase.cs
│   │       │   ├── AgentConfigPropertyAttribute.cs
│   │       │   └── ConfigUtils.cs
│   │       ├── Constants.cs
│   │       ├── IAgentBase.cs
│   │       ├── icon.png
│   │       ├── Models
│   │       │   ├── Command.cs
│   │       │   ├── Conversation.cs
│   │       │   ├── ConversationEvent.cs
│   │       │   ├── DebugInfo.cs
│   │       │   ├── Insight.cs
│   │       │   ├── Message.cs
│   │       │   ├── MessageMetadata.cs
│   │       │   ├── Participant.cs
│   │       │   ├── Sender.cs
│   │       │   └── ServiceInfo.cs
│   │       ├── Storage
│   │       │   ├── AgentInfo.cs
│   │       │   ├── AgentServiceStorage.cs
│   │       │   └── IAgentServiceStorage.cs
│   │       ├── StringLoggingExtensions.cs
│   │       ├── Webservice.cs
│   │       ├── WorkbenchConfig.cs
│   │       ├── WorkbenchConnector.cs
│   │       └── WorkbenchConnector.csproj
│   ├── Makefile
│   └── python
│       ├── anthropic-client
│       │   ├── .vscode
│       │   │   └── settings.json
│       │   ├── anthropic_client
│       │   │   ├── __init__.py
│       │   │   ├── client.py
│       │   │   ├── config.py
│       │   │   └── messages.py
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   └── uv.lock
│       ├── assistant-data-gen
│       │   ├── .vscode
│       │   │   ├── launch.json
│       │   │   └── settings.json
│       │   ├── assistant_data_gen
│       │   │   ├── __init__.py
│       │   │   ├── assistant_api.py
│       │   │   ├── config.py
│       │   │   ├── gce
│       │   │   │   ├── __init__.py
│       │   │   │   ├── gce_agent.py
│       │   │   │   └── prompts.py
│       │   │   └── pydantic_ai_utils.py
│       │   ├── configs
│       │   │   └── document_assistant_example_config.yaml
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   ├── scripts
│       │   │   ├── gce_simulation.py
│       │   │   └── generate_scenario.py
│       │   └── uv.lock
│       ├── assistant-drive
│       │   ├── .gitignore
│       │   ├── .vscode
│       │   │   ├── extensions.json
│       │   │   └── settings.json
│       │   ├── assistant_drive
│       │   │   ├── __init__.py
│       │   │   ├── drive.py
│       │   │   └── tests
│       │   │       └── test_basic.py
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── pytest.ini
│       │   ├── README.md
│       │   ├── usage.ipynb
│       │   └── uv.lock
│       ├── assistant-extensions
│       │   ├── .vscode
│       │   │   └── settings.json
│       │   ├── assistant_extensions
│       │   │   ├── __init__.py
│       │   │   ├── ai_clients
│       │   │   │   └── config.py
│       │   │   ├── artifacts
│       │   │   │   ├── __init__.py
│       │   │   │   ├── _artifacts.py
│       │   │   │   ├── _inspector.py
│       │   │   │   └── _model.py
│       │   │   ├── attachments
│       │   │   │   ├── __init__.py
│       │   │   │   ├── _attachments.py
│       │   │   │   ├── _convert.py
│       │   │   │   ├── _model.py
│       │   │   │   ├── _shared.py
│       │   │   │   └── _summarizer.py
│       │   │   ├── chat_context_toolkit
│       │   │   │   ├── __init__.py
│       │   │   │   ├── _config.py
│       │   │   │   ├── archive
│       │   │   │   │   ├── __init__.py
│       │   │   │   │   ├── _archive.py
│       │   │   │   │   └── _summarizer.py
│       │   │   │   ├── message_history
│       │   │   │   │   ├── __init__.py
│       │   │   │   │   ├── _history.py
│       │   │   │   │   └── _message.py
│       │   │   │   └── virtual_filesystem
│       │   │   │       ├── __init__.py
│       │   │   │       ├── _archive_file_source.py
│       │   │   │       └── _attachments_file_source.py
│       │   │   ├── dashboard_card
│       │   │   │   ├── __init__.py
│       │   │   │   └── _dashboard_card.py
│       │   │   ├── document_editor
│       │   │   │   ├── __init__.py
│       │   │   │   ├── _extension.py
│       │   │   │   ├── _inspector.py
│       │   │   │   └── _model.py
│       │   │   ├── mcp
│       │   │   │   ├── __init__.py
│       │   │   │   ├── _assistant_file_resource_handler.py
│       │   │   │   ├── _client_utils.py
│       │   │   │   ├── _devtunnel.py
│       │   │   │   ├── _model.py
│       │   │   │   ├── _openai_utils.py
│       │   │   │   ├── _sampling_handler.py
│       │   │   │   ├── _tool_utils.py
│       │   │   │   └── _workbench_file_resource_handler.py
│       │   │   ├── navigator
│       │   │   │   ├── __init__.py
│       │   │   │   └── _navigator.py
│       │   │   └── workflows
│       │   │       ├── __init__.py
│       │   │       ├── _model.py
│       │   │       ├── _workflows.py
│       │   │       └── runners
│       │   │           └── _user_proxy.py
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   ├── test
│       │   │   └── attachments
│       │   │       └── test_attachments.py
│       │   └── uv.lock
│       ├── chat-context-toolkit
│       │   ├── .claude
│       │   │   └── settings.local.json
│       │   ├── .env.sample
│       │   ├── .vscode
│       │   │   └── settings.json
│       │   ├── assets
│       │   │   ├── archive_v1.png
│       │   │   ├── history_v1.png
│       │   │   └── vfs_v1.png
│       │   ├── chat_context_toolkit
│       │   │   ├── __init__.py
│       │   │   ├── archive
│       │   │   │   ├── __init__.py
│       │   │   │   ├── _archive_reader.py
│       │   │   │   ├── _archive_task_queue.py
│       │   │   │   ├── _state.py
│       │   │   │   ├── _types.py
│       │   │   │   └── summarization
│       │   │   │       ├── __init__.py
│       │   │   │       └── _summarizer.py
│       │   │   ├── history
│       │   │   │   ├── __init__.py
│       │   │   │   ├── _budget.py
│       │   │   │   ├── _decorators.py
│       │   │   │   ├── _history.py
│       │   │   │   ├── _prioritize.py
│       │   │   │   ├── _types.py
│       │   │   │   └── tool_abbreviations
│       │   │   │       ├── __init__.py
│       │   │   │       └── _tool_abbreviations.py
│       │   │   └── virtual_filesystem
│       │   │       ├── __init__.py
│       │   │       ├── _types.py
│       │   │       ├── _virtual_filesystem.py
│       │   │       ├── README.md
│       │   │       └── tools
│       │   │           ├── __init__.py
│       │   │           ├── _ls_tool.py
│       │   │           ├── _tools.py
│       │   │           └── _view_tool.py
│       │   ├── CLAUDE.md
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   ├── test
│       │   │   ├── archive
│       │   │   │   └── test_archive_reader.py
│       │   │   ├── history
│       │   │   │   ├── test_abbreviate_messages.py
│       │   │   │   ├── test_history.py
│       │   │   │   ├── test_pair_and_order_tool_messages.py
│       │   │   │   ├── test_prioritize.py
│       │   │   │   └── test_truncate_messages.py
│       │   │   └── virtual_filesystem
│       │   │       ├── test_virtual_filesystem.py
│       │   │       └── tools
│       │   │           ├── test_ls_tool.py
│       │   │           ├── test_tools.py
│       │   │           └── test_view_tool.py
│       │   └── uv.lock
│       ├── content-safety
│       │   ├── .vscode
│       │   │   └── settings.json
│       │   ├── content_safety
│       │   │   ├── __init__.py
│       │   │   ├── evaluators
│       │   │   │   ├── __init__.py
│       │   │   │   ├── azure_content_safety
│       │   │   │   │   ├── __init__.py
│       │   │   │   │   ├── config.py
│       │   │   │   │   └── evaluator.py
│       │   │   │   ├── config.py
│       │   │   │   ├── evaluator.py
│       │   │   │   └── openai_moderations
│       │   │   │       ├── __init__.py
│       │   │   │       ├── config.py
│       │   │   │       └── evaluator.py
│       │   │   └── README.md
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   └── uv.lock
│       ├── events
│       │   ├── .vscode
│       │   │   └── settings.json
│       │   ├── events
│       │   │   ├── __init__.py
│       │   │   └── events.py
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   └── uv.lock
│       ├── guided-conversation
│       │   ├── .vscode
│       │   │   └── settings.json
│       │   ├── guided_conversation
│       │   │   ├── __init__.py
│       │   │   ├── functions
│       │   │   │   ├── __init__.py
│       │   │   │   ├── conversation_plan.py
│       │   │   │   ├── execution.py
│       │   │   │   └── final_update_plan.py
│       │   │   ├── guided_conversation_agent.py
│       │   │   ├── plugins
│       │   │   │   ├── __init__.py
│       │   │   │   ├── agenda.py
│       │   │   │   └── artifact.py
│       │   │   └── utils
│       │   │       ├── __init__.py
│       │   │       ├── base_model_llm.py
│       │   │       ├── conversation_helpers.py
│       │   │       ├── openai_tool_calling.py
│       │   │       ├── plugin_helpers.py
│       │   │       └── resources.py
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   └── uv.lock
│       ├── llm-client
│       │   ├── .vscode
│       │   │   └── settings.json
│       │   ├── llm_client
│       │   │   ├── __init__.py
│       │   │   └── model.py
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   └── uv.lock
│       ├── Makefile
│       ├── mcp-extensions
│       │   ├── .vscode
│       │   │   └── settings.json
│       │   ├── Makefile
│       │   ├── mcp_extensions
│       │   │   ├── __init__.py
│       │   │   ├── _client_session.py
│       │   │   ├── _model.py
│       │   │   ├── _sampling.py
│       │   │   ├── _server_extensions.py
│       │   │   ├── _tool_utils.py
│       │   │   ├── llm
│       │   │   │   ├── __init__.py
│       │   │   │   ├── chat_completion.py
│       │   │   │   ├── helpers.py
│       │   │   │   ├── llm_types.py
│       │   │   │   ├── mcp_chat_completion.py
│       │   │   │   └── openai_chat_completion.py
│       │   │   └── server
│       │   │       ├── __init__.py
│       │   │       └── storage.py
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   ├── tests
│       │   │   └── test_tool_utils.py
│       │   └── uv.lock
│       ├── mcp-tunnel
│       │   ├── .vscode
│       │   │   └── settings.json
│       │   ├── Makefile
│       │   ├── mcp_tunnel
│       │   │   ├── __init__.py
│       │   │   ├── _devtunnel.py
│       │   │   ├── _dir.py
│       │   │   └── _main.py
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   └── uv.lock
│       ├── openai-client
│       │   ├── .vscode
│       │   │   └── settings.json
│       │   ├── Makefile
│       │   ├── openai_client
│       │   │   ├── __init__.py
│       │   │   ├── chat_driver
│       │   │   │   ├── __init__.py
│       │   │   │   ├── chat_driver.ipynb
│       │   │   │   ├── chat_driver.py
│       │   │   │   ├── message_history_providers
│       │   │   │   │   ├── __init__.py
│       │   │   │   │   ├── in_memory_message_history_provider.py
│       │   │   │   │   ├── local_message_history_provider.py
│       │   │   │   │   ├── message_history_provider.py
│       │   │   │   │   └── tests
│       │   │   │   │       └── formatted_instructions_test.py
│       │   │   │   └── README.md
│       │   │   ├── client.py
│       │   │   ├── completion.py
│       │   │   ├── config.py
│       │   │   ├── errors.py
│       │   │   ├── logging.py
│       │   │   ├── messages.py
│       │   │   ├── tokens.py
│       │   │   └── tools.py
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   ├── tests
│       │   │   ├── test_command_parsing.py
│       │   │   ├── test_formatted_messages.py
│       │   │   ├── test_messages.py
│       │   │   └── test_tokens.py
│       │   └── uv.lock
│       ├── semantic-workbench-api-model
│       │   ├── .vscode
│       │   │   └── settings.json
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   ├── semantic_workbench_api_model
│       │   │   ├── __init__.py
│       │   │   ├── assistant_model.py
│       │   │   ├── assistant_service_client.py
│       │   │   ├── workbench_model.py
│       │   │   └── workbench_service_client.py
│       │   └── uv.lock
│       ├── semantic-workbench-assistant
│       │   ├── .vscode
│       │   │   ├── launch.json
│       │   │   └── settings.json
│       │   ├── Makefile
│       │   ├── pyproject.toml
│       │   ├── README.md
│       │   ├── semantic_workbench_assistant
│       │   │   ├── __init__.py
│       │   │   ├── assistant_app
│       │   │   │   ├── __init__.py
│       │   │   │   ├── assistant.py
│       │   │   │   ├── config.py
│       │   │   │   ├── content_safety.py
│       │   │   │   ├── context.py
│       │   │   │   ├── error.py
│       │   │   │   ├── export_import.py
│       │   │   │   ├── protocol.py
│       │   │   │   └── service.py
│       │   │   ├── assistant_service.py
│       │   │   ├── auth.py
│       │   │   ├── canonical.py
│       │   │   ├── command.py
│       │   │   ├── config.py
│       │   │   ├── logging_config.py
│       │   │   ├── settings.py
│       │   │   ├── start.py
│       │   │   └── storage.py
│       │   ├── tests
│       │   │   ├── conftest.py
│       │   │   ├── test_assistant_app.py
│       │   │   ├── test_canonical.py
│       │   │   ├── test_config.py
│       │   │   └── test_storage.py
│       │   └── uv.lock
│       └── skills
│           ├── .vscode
│           │   └── settings.json
│           ├── Makefile
│           ├── README.md
│           └── skill-library
│               ├── .vscode
│               │   └── settings.json
│               ├── docs
│               │   └── vs-recipe-tool.md
│               ├── Makefile
│               ├── pyproject.toml
│               ├── README.md
│               ├── skill_library
│               │   ├── __init__.py
│               │   ├── chat_driver_helpers.py
│               │   ├── cli
│               │   │   ├── azure_openai.py
│               │   │   ├── conversation_history.py
│               │   │   ├── README.md
│               │   │   ├── run_routine.py
│               │   │   ├── settings.py
│               │   │   └── skill_logger.py
│               │   ├── engine.py
│               │   ├── llm_info.txt
│               │   ├── logging.py
│               │   ├── README.md
│               │   ├── routine_stack.py
│               │   ├── skill.py
│               │   ├── skills
│               │   │   ├── common
│               │   │   │   ├── __init__.py
│               │   │   │   ├── common_skill.py
│               │   │   │   └── routines
│               │   │   │       ├── bing_search.py
│               │   │   │       ├── consolidate.py
│               │   │   │       ├── echo.py
│               │   │   │       ├── gather_context.py
│               │   │   │       ├── get_content_from_url.py
│               │   │   │       ├── gpt_complete.py
│               │   │   │       ├── select_user_intent.py
│               │   │   │       └── summarize.py
│               │   │   ├── eval
│               │   │   │   ├── __init__.py
│               │   │   │   ├── eval_skill.py
│               │   │   │   └── routines
│               │   │   │       └── eval.py
│               │   │   ├── fabric
│               │   │   │   ├── __init__.py
│               │   │   │   ├── fabric_skill.py
│               │   │   │   ├── patterns
│               │   │   │   │   ├── agility_story
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── ai
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_answers
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_candidates
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── analyze_cfp_submission
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_claims
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── analyze_comments
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_debate
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_email_headers
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── analyze_incident
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── analyze_interviewer_techniques
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_logs
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_malware
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_military_strategy
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_mistakes
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_paper
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── analyze_patent
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_personality
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_presentation
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_product_feedback
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_proposition
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── analyze_prose
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── analyze_prose_json
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── analyze_prose_pinker
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_risk
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_sales_call
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_spiritual_text
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── analyze_tech_impact
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── analyze_threat_report
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── analyze_threat_report_cmds
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── analyze_threat_report_trends
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── answer_interview_question
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── ask_secure_by_design_questions
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── ask_uncle_duke
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── capture_thinkers_work
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── check_agreement
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── clean_text
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── coding_master
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── compare_and_contrast
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── convert_to_markdown
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_5_sentence_summary
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_academic_paper
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_ai_jobs_analysis
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_aphorisms
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── create_art_prompt
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_better_frame
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── create_coding_project
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_command
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── create_cyber_summary
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_design_document
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_diy
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_formal_email
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_git_diff_commit
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_graph_from_input
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_hormozi_offer
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_idea_compass
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_investigation_visualization
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_keynote
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_logo
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── create_markmap_visualization
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_mermaid_visualization
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_mermaid_visualization_for_github
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_micro_summary
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_network_threat_landscape
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── create_newsletter_entry
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── create_npc
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── create_pattern
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_prd
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_prediction_block
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_quiz
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_reading_plan
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_recursive_outline
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_report_finding
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── create_rpg_summary
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_security_update
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── create_show_intro
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_sigma_rules
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_story_explanation
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_stride_threat_model
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_summary
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_tags
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_threat_scenarios
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_ttrc_graph
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_ttrc_narrative
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_upgrade_pack
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_user_story
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── create_video_chapters
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── create_visualization
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── dialog_with_socrates
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── enrich_blog_post
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── explain_code
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── explain_docs
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── explain_math
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── explain_project
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── explain_terms
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── export_data_as_csv
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_algorithm_update_recommendations
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── extract_article_wisdom
│               │   │   │   │   │   ├── dmiessler
│               │   │   │   │   │   │   └── extract_wisdom-1.0.0
│               │   │   │   │   │   │       ├── system.md
│               │   │   │   │   │   │       └── user.md
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── extract_book_ideas
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_book_recommendations
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_business_ideas
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_controversial_ideas
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_core_message
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_ctf_writeup
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_domains
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_extraordinary_claims
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_ideas
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_insights
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_insights_dm
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_instructions
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_jokes
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_latest_video
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_main_idea
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_most_redeeming_thing
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_patterns
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_poc
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── extract_predictions
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_primary_problem
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_primary_solution
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_product_features
│               │   │   │   │   │   ├── dmiessler
│               │   │   │   │   │   │   └── extract_wisdom-1.0.0
│               │   │   │   │   │   │       ├── system.md
│               │   │   │   │   │   │       └── user.md
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_questions
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_recipe
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_recommendations
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── extract_references
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── extract_skills
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_song_meaning
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_sponsors
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_videoid
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── extract_wisdom
│               │   │   │   │   │   ├── dmiessler
│               │   │   │   │   │   │   └── extract_wisdom-1.0.0
│               │   │   │   │   │   │       ├── system.md
│               │   │   │   │   │   │       └── user.md
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_wisdom_agents
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_wisdom_dm
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── extract_wisdom_nometa
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── find_hidden_message
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── find_logical_fallacies
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── get_wow_per_minute
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── get_youtube_rss
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── humanize
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── identify_dsrp_distinctions
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── identify_dsrp_perspectives
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── identify_dsrp_relationships
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── identify_dsrp_systems
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── identify_job_stories
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── improve_academic_writing
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── improve_prompt
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── improve_report_finding
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── improve_writing
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── judge_output
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── label_and_rate
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── loaded
│               │   │   │   │   ├── md_callout
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── official_pattern_template
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── pattern_explanations.md
│               │   │   │   │   ├── prepare_7s_strategy
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── provide_guidance
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── rate_ai_response
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── rate_ai_result
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── rate_content
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── rate_value
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── raw_query
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── raycast
│               │   │   │   │   │   ├── capture_thinkers_work
│               │   │   │   │   │   ├── create_story_explanation
│               │   │   │   │   │   ├── extract_primary_problem
│               │   │   │   │   │   ├── extract_wisdom
│               │   │   │   │   │   └── yt
│               │   │   │   │   ├── recommend_artists
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── recommend_pipeline_upgrades
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── recommend_talkpanel_topics
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── refine_design_document
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── review_design
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── sanitize_broken_html_to_markdown
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── show_fabric_options_markmap
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── solve_with_cot
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── stringify
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── suggest_pattern
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── summarize
│               │   │   │   │   │   ├── dmiessler
│               │   │   │   │   │   │   └── summarize
│               │   │   │   │   │   │       ├── system.md
│               │   │   │   │   │   │       └── user.md
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── summarize_debate
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── summarize_git_changes
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── summarize_git_diff
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── summarize_lecture
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── summarize_legislation
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── summarize_meeting
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── summarize_micro
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── summarize_newsletter
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── summarize_paper
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── summarize_prompt
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── summarize_pull-requests
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── summarize_rpg_session
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_analyze_challenge_handling
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_check_metrics
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_create_h3_career
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_create_opening_sentences
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_describe_life_outlook
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_extract_intro_sentences
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_extract_panel_topics
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_find_blindspots
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_find_negative_thinking
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_find_neglected_goals
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_give_encouragement
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_red_team_thinking
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_threat_model_plans
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_visualize_mission_goals_projects
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── t_year_in_review
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── to_flashcards
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── transcribe_minutes
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── translate
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── tweet
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── write_essay
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── write_hackerone_report
│               │   │   │   │   │   ├── README.md
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── write_latex
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── write_micro_essay
│               │   │   │   │   │   └── system.md
│               │   │   │   │   ├── write_nuclei_template_rule
│               │   │   │   │   │   ├── system.md
│               │   │   │   │   │   └── user.md
│               │   │   │   │   ├── write_pull-request
│               │   │   │   │   │   └── system.md
│               │   │   │   │   └── write_semgrep_rule
│               │   │   │   │       ├── system.md
│               │   │   │   │       └── user.md
│               │   │   │   └── routines
│               │   │   │       ├── list.py
│               │   │   │       ├── run.py
│               │   │   │       └── show.py
│               │   │   ├── guided_conversation
│               │   │   │   ├── __init__.py
│               │   │   │   ├── agenda.py
│               │   │   │   ├── artifact_helpers.py
│               │   │   │   ├── chat_completions
│               │   │   │   │   ├── fix_agenda_error.py
│               │   │   │   │   ├── fix_artifact_error.py
│               │   │   │   │   ├── generate_agenda.py
│               │   │   │   │   ├── generate_artifact_updates.py
│               │   │   │   │   ├── generate_final_artifact.py
│               │   │   │   │   └── generate_message.py
│               │   │   │   ├── conversation_guides
│               │   │   │   │   ├── __init__.py
│               │   │   │   │   ├── acrostic_poem.py
│               │   │   │   │   ├── er_triage.py
│               │   │   │   │   ├── interview.py
│               │   │   │   │   └── patient_intake.py
│               │   │   │   ├── guide.py
│               │   │   │   ├── guided_conversation_skill.py
│               │   │   │   ├── logging.py
│               │   │   │   ├── message.py
│               │   │   │   ├── resources.py
│               │   │   │   ├── routines
│               │   │   │   │   └── guided_conversation.py
│               │   │   │   └── tests
│               │   │   │       ├── conftest.py
│               │   │   │       ├── test_artifact_helpers.py
│               │   │   │       ├── test_generate_agenda.py
│               │   │   │       ├── test_generate_artifact_updates.py
│               │   │   │       ├── test_generate_final_artifact.py
│               │   │   │       └── test_resource.py
│               │   │   ├── meta
│               │   │   │   ├── __init__.py
│               │   │   │   ├── meta_skill.py
│               │   │   │   ├── README.md
│               │   │   │   └── routines
│               │   │   │       └── generate_routine.py
│               │   │   ├── posix
│               │   │   │   ├── __init__.py
│               │   │   │   ├── posix_skill.py
│               │   │   │   ├── routines
│               │   │   │   │   ├── append_file.py
│               │   │   │   │   ├── cd.py
│               │   │   │   │   ├── ls.py
│               │   │   │   │   ├── make_home_dir.py
│               │   │   │   │   ├── mkdir.py
│               │   │   │   │   ├── mv.py
│               │   │   │   │   ├── pwd.py
│               │   │   │   │   ├── read_file.py
│               │   │   │   │   ├── rm.py
│               │   │   │   │   ├── touch.py
│               │   │   │   │   └── write_file.py
│               │   │   │   └── sandbox_shell.py
│               │   │   ├── README.md
│               │   │   ├── research
│               │   │   │   ├── __init__.py
│               │   │   │   ├── README.md
│               │   │   │   ├── research_skill.py
│               │   │   │   └── routines
│               │   │   │       ├── answer_question_about_content.py
│               │   │   │       ├── evaluate_answer.py
│               │   │   │       ├── generate_research_plan.py
│               │   │   │       ├── generate_search_query.py
│               │   │   │       ├── update_research_plan.py
│               │   │   │       ├── web_research.py
│               │   │   │       └── web_search.py
│               │   │   ├── research2
│               │   │   │   ├── __init__.py
│               │   │   │   ├── README.md
│               │   │   │   ├── research_skill.py
│               │   │   │   └── routines
│               │   │   │       ├── facts.py
│               │   │   │       ├── make_final_report.py
│               │   │   │       ├── research.py
│               │   │   │       ├── search_plan.py
│               │   │   │       ├── search.py
│               │   │   │       └── visit_pages.py
│               │   │   └── web_research
│               │   │       ├── __init__.py
│               │   │       ├── README.md
│               │   │       ├── research_skill.py
│               │   │       └── routines
│               │   │           ├── facts.py
│               │   │           ├── make_final_report.py
│               │   │           ├── research.py
│               │   │           ├── search_plan.py
│               │   │           ├── search.py
│               │   │           └── visit_pages.py
│               │   ├── tests
│               │   │   ├── test_common_skill.py
│               │   │   ├── test_integration.py
│               │   │   ├── test_routine_stack.py
│               │   │   ├── tst_skill
│               │   │   │   ├── __init__.py
│               │   │   │   └── routines
│               │   │   │       ├── __init__.py
│               │   │   │       └── a_routine.py
│               │   │   └── utilities
│               │   │       ├── test_find_template_vars.py
│               │   │       ├── test_make_arg_set.py
│               │   │       ├── test_paramspec.py
│               │   │       ├── test_parse_command_string.py
│               │   │       └── test_to_string.py
│               │   ├── types.py
│               │   ├── usage.py
│               │   └── utilities.py
│               └── uv.lock
├── LICENSE
├── Makefile
├── mcp-servers
│   ├── ai-assist-content
│   │   ├── .vscode
│   │   │   └── settings.json
│   │   ├── mcp-example-brave-search.md
│   │   ├── mcp-fastmcp-typescript-README.md
│   │   ├── mcp-llms-full.txt
│   │   ├── mcp-metadata-tips.md
│   │   ├── mcp-python-sdk-README.md
│   │   ├── mcp-typescript-sdk-README.md
│   │   ├── pydanticai-documentation.md
│   │   ├── pydanticai-example-question-graph.md
│   │   ├── pydanticai-example-weather.md
│   │   ├── pydanticai-tutorial.md
│   │   └── README.md
│   ├── Makefile
│   ├── mcp-server-bing-search
│   │   ├── .env.example
│   │   ├── .gitignore
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── Makefile
│   │   ├── mcp_server_bing_search
│   │   │   ├── __init__.py
│   │   │   ├── config.py
│   │   │   ├── prompts
│   │   │   │   ├── __init__.py
│   │   │   │   ├── clean_website.py
│   │   │   │   └── filter_links.py
│   │   │   ├── server.py
│   │   │   ├── start.py
│   │   │   ├── tools.py
│   │   │   ├── types.py
│   │   │   ├── utils.py
│   │   │   └── web
│   │   │       ├── __init__.py
│   │   │       ├── get_content.py
│   │   │       ├── llm_processing.py
│   │   │       ├── process_website.py
│   │   │       └── search_bing.py
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   ├── tests
│   │   │   └── test_tools.py
│   │   └── uv.lock
│   ├── mcp-server-bundle
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── Makefile
│   │   ├── mcp_server_bundle
│   │   │   ├── __init__.py
│   │   │   └── main.py
│   │   ├── pyinstaller.spec
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   └── uv.lock
│   ├── mcp-server-filesystem
│   │   ├── .env.example
│   │   ├── .github
│   │   │   └── workflows
│   │   │       └── ci.yml
│   │   ├── .gitignore
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── Makefile
│   │   ├── mcp_server_filesystem
│   │   │   ├── __init__.py
│   │   │   ├── config.py
│   │   │   ├── server.py
│   │   │   └── start.py
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   ├── tests
│   │   │   └── test_filesystem.py
│   │   └── uv.lock
│   ├── mcp-server-filesystem-edit
│   │   ├── .env.example
│   │   ├── .gitignore
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── data
│   │   │   ├── attachments
│   │   │   │   ├── Daily Game Ideas.txt
│   │   │   │   ├── Frontend Framework Proposal.txt
│   │   │   │   ├── ReDoodle.txt
│   │   │   │   └── Research Template.tex
│   │   │   ├── test_cases.yaml
│   │   │   └── transcripts
│   │   │       ├── transcript_research_simple.md
│   │   │       ├── transcript_Startup_Idea_1_202503031513.md
│   │   │       ├── transcript_Startup_Idea_2_202503031659.md
│   │   │       └── transcript_Web_Frontends_202502281551.md
│   │   ├── Makefile
│   │   ├── mcp_server_filesystem_edit
│   │   │   ├── __init__.py
│   │   │   ├── app_handling
│   │   │   │   ├── __init__.py
│   │   │   │   ├── excel.py
│   │   │   │   ├── miktex.py
│   │   │   │   ├── office_common.py
│   │   │   │   ├── powerpoint.py
│   │   │   │   └── word.py
│   │   │   ├── config.py
│   │   │   ├── evals
│   │   │   │   ├── __init__.py
│   │   │   │   ├── common.py
│   │   │   │   ├── run_comments.py
│   │   │   │   ├── run_edit.py
│   │   │   │   └── run_ppt_edit.py
│   │   │   ├── prompts
│   │   │   │   ├── __init__.py
│   │   │   │   ├── add_comments.py
│   │   │   │   ├── analyze_comments.py
│   │   │   │   ├── latex_edit.py
│   │   │   │   ├── markdown_draft.py
│   │   │   │   ├── markdown_edit.py
│   │   │   │   └── powerpoint_edit.py
│   │   │   ├── server.py
│   │   │   ├── start.py
│   │   │   ├── tools
│   │   │   │   ├── __init__.py
│   │   │   │   ├── add_comments.py
│   │   │   │   ├── edit_adapters
│   │   │   │   │   ├── __init__.py
│   │   │   │   │   ├── common.py
│   │   │   │   │   ├── latex.py
│   │   │   │   │   └── markdown.py
│   │   │   │   ├── edit.py
│   │   │   │   └── helpers.py
│   │   │   └── types.py
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   ├── tests
│   │   │   ├── app_handling
│   │   │   │   ├── test_excel.py
│   │   │   │   ├── test_miktext.py
│   │   │   │   ├── test_office_common.py
│   │   │   │   ├── test_powerpoint.py
│   │   │   │   └── test_word.py
│   │   │   ├── conftest.py
│   │   │   └── tools
│   │   │       └── edit_adapters
│   │   │           ├── test_latex.py
│   │   │           └── test_markdown.py
│   │   └── uv.lock
│   ├── mcp-server-fusion
│   │   ├── .gitignore
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── AddInIcon.svg
│   │   ├── config.py
│   │   ├── FusionMCPServerAddIn.manifest
│   │   ├── FusionMCPServerAddIn.py
│   │   ├── mcp_server_fusion
│   │   │   ├── __init__.py
│   │   │   ├── fusion_mcp_server.py
│   │   │   ├── fusion_utils
│   │   │   │   ├── __init__.py
│   │   │   │   ├── event_utils.py
│   │   │   │   ├── general_utils.py
│   │   │   │   └── tool_utils.py
│   │   │   ├── mcp_tools
│   │   │   │   ├── __init__.py
│   │   │   │   ├── fusion_3d_operation.py
│   │   │   │   ├── fusion_geometry.py
│   │   │   │   ├── fusion_pattern.py
│   │   │   │   └── fusion_sketch.py
│   │   │   └── vendor
│   │   │       └── README.md
│   │   ├── README.md
│   │   └── requirements.txt
│   ├── mcp-server-giphy
│   │   ├── .env.example
│   │   ├── .gitignore
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── Makefile
│   │   ├── mcp_server
│   │   │   ├── __init__.py
│   │   │   ├── config.py
│   │   │   ├── giphy_search.py
│   │   │   ├── sampling.py
│   │   │   ├── server.py
│   │   │   ├── start.py
│   │   │   └── utils.py
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   └── uv.lock
│   ├── mcp-server-memory-user-bio
│   │   ├── .env.example
│   │   ├── .gitignore
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── Makefile
│   │   ├── mcp_server_memory_user_bio
│   │   │   ├── __init__.py
│   │   │   ├── config.py
│   │   │   ├── server.py
│   │   │   └── start.py
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   └── uv.lock
│   ├── mcp-server-memory-whiteboard
│   │   ├── .env.example
│   │   ├── .gitignore
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── Makefile
│   │   ├── mcp_server_memory_whiteboard
│   │   │   ├── __init__.py
│   │   │   ├── config.py
│   │   │   ├── server.py
│   │   │   └── start.py
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   └── uv.lock
│   ├── mcp-server-office
│   │   ├── .env.example
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── build.sh
│   │   ├── data
│   │   │   ├── attachments
│   │   │   │   ├── Daily Game Ideas.txt
│   │   │   │   ├── Frontend Framework Proposal.txt
│   │   │   │   └── ReDoodle.txt
│   │   │   └── word
│   │   │       ├── test_cases.yaml
│   │   │       └── transcripts
│   │   │           ├── transcript_Startup_Idea_1_202503031513.md
│   │   │           ├── transcript_Startup_Idea_2_202503031659.md
│   │   │           └── transcript_Web_Frontends_202502281551.md
│   │   ├── Makefile
│   │   ├── mcp_server
│   │   │   ├── __init__.py
│   │   │   ├── app_interaction
│   │   │   │   ├── __init__.py
│   │   │   │   ├── excel_editor.py
│   │   │   │   ├── powerpoint_editor.py
│   │   │   │   └── word_editor.py
│   │   │   ├── config.py
│   │   │   ├── constants.py
│   │   │   ├── evals
│   │   │   │   ├── __init__.py
│   │   │   │   ├── common.py
│   │   │   │   ├── run_comment_analysis.py
│   │   │   │   ├── run_feedback.py
│   │   │   │   └── run_markdown_edit.py
│   │   │   ├── helpers.py
│   │   │   ├── markdown_edit
│   │   │   │   ├── __init__.py
│   │   │   │   ├── comment_analysis.py
│   │   │   │   ├── feedback_step.py
│   │   │   │   ├── markdown_edit.py
│   │   │   │   └── utils.py
│   │   │   ├── prompts
│   │   │   │   ├── __init__.py
│   │   │   │   ├── comment_analysis.py
│   │   │   │   ├── feedback.py
│   │   │   │   ├── markdown_draft.py
│   │   │   │   └── markdown_edit.py
│   │   │   ├── server.py
│   │   │   ├── start.py
│   │   │   └── types.py
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   ├── tests
│   │   │   └── test_word_editor.py
│   │   └── uv.lock
│   ├── mcp-server-open-deep-research
│   │   ├── .env.example
│   │   ├── .gitignore
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── Makefile
│   │   ├── mcp_server
│   │   │   ├── __init__.py
│   │   │   ├── config.py
│   │   │   ├── libs
│   │   │   │   └── open_deep_research
│   │   │   │       ├── cookies.py
│   │   │   │       ├── mdconvert.py
│   │   │   │       ├── run_agents.py
│   │   │   │       ├── text_inspector_tool.py
│   │   │   │       ├── text_web_browser.py
│   │   │   │       └── visual_qa.py
│   │   │   ├── open_deep_research.py
│   │   │   ├── server.py
│   │   │   └── start.py
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   └── uv.lock
│   ├── mcp-server-open-deep-research-clone
│   │   ├── .env.example
│   │   ├── .gitignore
│   │   ├── .vscode
│   │   │   ├── launch.json
│   │   │   └── settings.json
│   │   ├── Makefile
│   │   ├── mcp_server_open_deep_research_clone
│   │   │   ├── __init__.py
│   │   │   ├── azure_openai.py
│   │   │   ├── config.py
│   │   │   ├── logging.py
│   │   │   ├── sampling.py
│   │   │   ├── server.py
│   │   │   ├── start.py
│   │   │   ├── utils.py
│   │   │   └── web_research.py
│   │   ├── pyproject.toml
│   │   ├── README.md
│   │   ├── test
│   │   │   └── test_open_deep_research_clone.py
│   │   └── uv.lock
│   ├── mcp-server-template
│   │   ├── .taplo.toml
│   │   ├── .vscode
│   │   │   └── settings.json
│   │   ├── copier.yml
│   │   ├── README.md
│   │   └── template
│   │       └── {{ project_slug }}
│   │           ├── .env.example.jinja
│   │           ├── .gitignore
│   │           ├── .vscode
│   │           │   ├── launch.json.jinja
│   │           │   └── settings.json
│   │           ├── {{ module_name }}
│   │           │   ├── __init__.py
│   │           │   ├── config.py.jinja
│   │           │   ├── server.py.jinja
│   │           │   └── start.py.jinja
│   │           ├── Makefile.jinja
│   │           ├── pyproject.toml.jinja
│   │           └── README.md.jinja
│   ├── mcp-server-vscode
│   │   ├── .eslintrc.cjs
│   │   ├── .gitignore
│   │   ├── .npmrc
│   │   ├── .vscode
│   │   │   ├── extensions.json
│   │   │   ├── launch.json
│   │   │   ├── settings.json
│   │   │   └── tasks.json
│   │   ├── .vscode-test.mjs
│   │   ├── .vscodeignore
│   │   ├── ASSISTANT_BOOTSTRAP.md
│   │   ├── eslint.config.mjs
│   │   ├── images
│   │   │   └── icon.png
│   │   ├── LICENSE
│   │   ├── Makefile
│   │   ├── out
│   │   │   ├── extension.d.ts
│   │   │   ├── extension.js
│   │   │   ├── test
│   │   │   │   ├── extension.test.d.ts
│   │   │   │   └── extension.test.js
│   │   │   ├── tools
│   │   │   │   ├── code_checker.d.ts
│   │   │   │   ├── code_checker.js
│   │   │   │   ├── debug_tools.d.ts
│   │   │   │   ├── debug_tools.js
│   │   │   │   ├── focus_editor.d.ts
│   │   │   │   ├── focus_editor.js
│   │   │   │   ├── search_symbol.d.ts
│   │   │   │   └── search_symbol.js
│   │   │   └── utils
│   │   │       ├── port.d.ts
│   │   │       └── port.js
│   │   ├── package.json
│   │   ├── pnpm-lock.yaml
│   │   ├── prettier.config.cjs
│   │   ├── README.md
│   │   ├── src
│   │   │   ├── extension.d.ts
│   │   │   ├── extension.ts
│   │   │   ├── test
│   │   │   │   ├── extension.test.d.ts
│   │   │   │   └── extension.test.ts
│   │   │   ├── tools
│   │   │   │   ├── code_checker.d.ts
│   │   │   │   ├── code_checker.ts
│   │   │   │   ├── debug_tools.d.ts
│   │   │   │   ├── debug_tools.ts
│   │   │   │   ├── focus_editor.d.ts
│   │   │   │   ├── focus_editor.ts
│   │   │   │   ├── search_symbol.d.ts
│   │   │   │   └── search_symbol.ts
│   │   │   └── utils
│   │   │       ├── port.d.ts
│   │   │       └── port.ts
│   │   ├── tsconfig.json
│   │   ├── tsconfig.tsbuildinfo
│   │   ├── vsc-extension-quickstart.md
│   │   └── webpack.config.js
│   └── mcp-server-web-research
│       ├── .env.example
│       ├── .gitignore
│       ├── .vscode
│       │   ├── launch.json
│       │   └── settings.json
│       ├── Makefile
│       ├── mcp_server_web_research
│       │   ├── __init__.py
│       │   ├── azure_openai.py
│       │   ├── config.py
│       │   ├── logging.py
│       │   ├── sampling.py
│       │   ├── server.py
│       │   ├── start.py
│       │   ├── utils.py
│       │   └── web_research.py
│       ├── pyproject.toml
│       ├── README.md
│       ├── test
│       │   └── test_web_research.py
│       └── uv.lock
├── README.md
├── RESPONSIBLE_AI_FAQ.md
├── ruff.toml
├── SECURITY.md
├── semantic-workbench.code-workspace
├── SUPPORT.md
├── tools
│   ├── build_ai_context_files.py
│   ├── collect_files.py
│   ├── docker
│   │   ├── azure_website_sshd.conf
│   │   ├── docker-entrypoint.sh
│   │   ├── Dockerfile.assistant
│   │   └── Dockerfile.mcp-server
│   ├── makefiles
│   │   ├── docker-assistant.mk
│   │   ├── docker-mcp-server.mk
│   │   ├── docker.mk
│   │   ├── python.mk
│   │   ├── recursive.mk
│   │   └── shell.mk
│   ├── reset-service-data.ps1
│   ├── reset-service-data.sh
│   ├── run-app.ps1
│   ├── run-app.sh
│   ├── run-canonical-agent.ps1
│   ├── run-canonical-agent.sh
│   ├── run-dotnet-examples-with-aspire.sh
│   ├── run-python-example1.sh
│   ├── run-python-example2.ps1
│   ├── run-python-example2.sh
│   ├── run-service.ps1
│   ├── run-service.sh
│   ├── run-workbench-chatbot.ps1
│   └── run-workbench-chatbot.sh
├── workbench-app
│   ├── .dockerignore
│   ├── .env.example
│   ├── .eslintrc.cjs
│   ├── .gitignore
│   ├── .vscode
│   │   ├── launch.json
│   │   └── settings.json
│   ├── docker-entrypoint.sh
│   ├── Dockerfile
│   ├── docs
│   │   ├── APP_DEV_GUIDE.md
│   │   ├── MESSAGE_METADATA.md
│   │   ├── MESSAGE_TYPES.md
│   │   ├── README.md
│   │   └── STATE_INSPECTORS.md
│   ├── index.html
│   ├── Makefile
│   ├── nginx.conf
│   ├── package.json
│   ├── pnpm-lock.yaml
│   ├── prettier.config.cjs
│   ├── public
│   │   └── assets
│   │       ├── background-1-upscaled.jpg
│   │       ├── background-1-upscaled.png
│   │       ├── background-1.jpg
│   │       ├── background-1.png
│   │       ├── background-2.jpg
│   │       ├── background-2.png
│   │       ├── experimental-feature.jpg
│   │       ├── favicon.svg
│   │       ├── workflow-designer-1.jpg
│   │       ├── workflow-designer-outlets.jpg
│   │       ├── workflow-designer-states.jpg
│   │       └── workflow-designer-transitions.jpg
│   ├── README.md
│   ├── run.sh
│   ├── src
│   │   ├── components
│   │   │   ├── App
│   │   │   │   ├── AppFooter.tsx
│   │   │   │   ├── AppHeader.tsx
│   │   │   │   ├── AppMenu.tsx
│   │   │   │   ├── AppView.tsx
│   │   │   │   ├── CodeLabel.tsx
│   │   │   │   ├── CommandButton.tsx
│   │   │   │   ├── ConfirmLeave.tsx
│   │   │   │   ├── ContentExport.tsx
│   │   │   │   ├── ContentImport.tsx
│   │   │   │   ├── CopyButton.tsx
│   │   │   │   ├── DialogControl.tsx
│   │   │   │   ├── DynamicIframe.tsx
│   │   │   │   ├── ErrorListFromAppState.tsx
│   │   │   │   ├── ErrorMessageBar.tsx
│   │   │   │   ├── ExperimentalNotice.tsx
│   │   │   │   ├── FormWidgets
│   │   │   │   │   ├── BaseModelEditorWidget.tsx
│   │   │   │   │   ├── CustomizedArrayFieldTemplate.tsx
│   │   │   │   │   ├── CustomizedFieldTemplate.tsx
│   │   │   │   │   ├── CustomizedObjectFieldTemplate.tsx
│   │   │   │   │   └── InspectableWidget.tsx
│   │   │   │   ├── LabelWithDescription.tsx
│   │   │   │   ├── Loading.tsx
│   │   │   │   ├── MenuItemControl.tsx
│   │   │   │   ├── MiniControl.tsx
│   │   │   │   ├── MyAssistantServiceRegistrations.tsx
│   │   │   │   ├── MyItemsManager.tsx
│   │   │   │   ├── OverflowMenu.tsx
│   │   │   │   ├── PresenceMotionList.tsx
│   │   │   │   ├── ProfileSettings.tsx
│   │   │   │   └── TooltipWrapper.tsx
│   │   │   ├── Assistants
│   │   │   │   ├── ApplyConfigButton.tsx
│   │   │   │   ├── AssistantAdd.tsx
│   │   │   │   ├── AssistantConfigExportButton.tsx
│   │   │   │   ├── AssistantConfigImportButton.tsx
│   │   │   │   ├── AssistantConfiguration.tsx
│   │   │   │   ├── AssistantConfigure.tsx
│   │   │   │   ├── AssistantCreate.tsx
│   │   │   │   ├── AssistantDelete.tsx
│   │   │   │   ├── AssistantDuplicate.tsx
│   │   │   │   ├── AssistantExport.tsx
│   │   │   │   ├── AssistantImport.tsx
│   │   │   │   ├── AssistantRemove.tsx
│   │   │   │   ├── AssistantRename.tsx
│   │   │   │   ├── AssistantServiceInfo.tsx
│   │   │   │   ├── AssistantServiceMetadata.tsx
│   │   │   │   └── MyAssistants.tsx
│   │   │   ├── AssistantServiceRegistrations
│   │   │   │   ├── AssistantServiceRegistrationApiKey.tsx
│   │   │   │   ├── AssistantServiceRegistrationApiKeyReset.tsx
│   │   │   │   ├── AssistantServiceRegistrationCreate.tsx
│   │   │   │   └── AssistantServiceRegistrationRemove.tsx
│   │   │   ├── Conversations
│   │   │   │   ├── Canvas
│   │   │   │   │   ├── AssistantCanvas.tsx
│   │   │   │   │   ├── AssistantCanvasList.tsx
│   │   │   │   │   ├── AssistantInspector.tsx
│   │   │   │   │   ├── AssistantInspectorList.tsx
│   │   │   │   │   └── ConversationCanvas.tsx
│   │   │   │   ├── ChatInputPlugins
│   │   │   │   │   ├── ClearEditorPlugin.tsx
│   │   │   │   │   ├── LexicalMenu.ts
│   │   │   │   │   ├── ParticipantMentionsPlugin.tsx
│   │   │   │   │   ├── TypeaheadMenuPlugin.css
│   │   │   │   │   └── TypeaheadMenuPlugin.tsx
│   │   │   │   ├── ContentRenderers
│   │   │   │   │   ├── CodeContentRenderer.tsx
│   │   │   │   │   ├── ContentListRenderer.tsx
│   │   │   │   │   ├── ContentRenderer.tsx
│   │   │   │   │   ├── DiffRenderer.tsx
│   │   │   │   │   ├── HtmlContentRenderer.tsx
│   │   │   │   │   ├── JsonSchemaContentRenderer.tsx
│   │   │   │   │   ├── MarkdownContentRenderer.tsx
│   │   │   │   │   ├── MarkdownEditorRenderer.tsx
│   │   │   │   │   ├── MermaidContentRenderer.tsx
│   │   │   │   │   ├── MusicABCContentRenderer.css
│   │   │   │   │   └── MusicABCContentRenderer.tsx
│   │   │   │   ├── ContextWindow.tsx
│   │   │   │   ├── ConversationCreate.tsx
│   │   │   │   ├── ConversationDuplicate.tsx
│   │   │   │   ├── ConversationExport.tsx
│   │   │   │   ├── ConversationFileIcon.tsx
│   │   │   │   ├── ConversationRemove.tsx
│   │   │   │   ├── ConversationRename.tsx
│   │   │   │   ├── ConversationShare.tsx
│   │   │   │   ├── ConversationShareCreate.tsx
│   │   │   │   ├── ConversationShareList.tsx
│   │   │   │   ├── ConversationShareView.tsx
│   │   │   │   ├── ConversationsImport.tsx
│   │   │   │   ├── ConversationTranscript.tsx
│   │   │   │   ├── DebugInspector.tsx
│   │   │   │   ├── FileItem.tsx
│   │   │   │   ├── FileList.tsx
│   │   │   │   ├── InputAttachmentList.tsx
│   │   │   │   ├── InputOptionsControl.tsx
│   │   │   │   ├── InteractHistory.tsx
│   │   │   │   ├── InteractInput.tsx
│   │   │   │   ├── Message
│   │   │   │   │   ├── AttachmentSection.tsx
│   │   │   │   │   ├── ContentRenderer.tsx
│   │   │   │   │   ├── ContentSafetyNotice.tsx
│   │   │   │   │   ├── InteractMessage.tsx
│   │   │   │   │   ├── MessageActions.tsx
│   │   │   │   │   ├── MessageBase.tsx
│   │   │   │   │   ├── MessageBody.tsx
│   │   │   │   │   ├── MessageContent.tsx
│   │   │   │   │   ├── MessageFooter.tsx
│   │   │   │   │   ├── MessageHeader.tsx
│   │   │   │   │   ├── NotificationAccordion.tsx
│   │   │   │   │   └── ToolResultMessage.tsx
│   │   │   │   ├── MessageDelete.tsx
│   │   │   │   ├── MessageLink.tsx
│   │   │   │   ├── MyConversations.tsx
│   │   │   │   ├── MyShares.tsx
│   │   │   │   ├── ParticipantAvatar.tsx
│   │   │   │   ├── ParticipantAvatarGroup.tsx
│   │   │   │   ├── ParticipantItem.tsx
│   │   │   │   ├── ParticipantList.tsx
│   │   │   │   ├── ParticipantStatus.tsx
│   │   │   │   ├── RewindConversation.tsx
│   │   │   │   ├── ShareRemove.tsx
│   │   │   │   ├── SpeechButton.tsx
│   │   │   │   └── ToolCalls.tsx
│   │   │   └── FrontDoor
│   │   │       ├── Chat
│   │   │       │   ├── AssistantDrawer.tsx
│   │   │       │   ├── CanvasDrawer.tsx
│   │   │       │   ├── Chat.tsx
│   │   │       │   ├── ChatCanvas.tsx
│   │   │       │   ├── ChatControls.tsx
│   │   │       │   └── ConversationDrawer.tsx
│   │   │       ├── Controls
│   │   │       │   ├── AssistantCard.tsx
│   │   │       │   ├── AssistantSelector.tsx
│   │   │       │   ├── AssistantServiceSelector.tsx
│   │   │       │   ├── ConversationItem.tsx
│   │   │       │   ├── ConversationList.tsx
│   │   │       │   ├── ConversationListOptions.tsx
│   │   │       │   ├── NewConversationButton.tsx
│   │   │       │   ├── NewConversationForm.tsx
│   │   │       │   └── SiteMenuButton.tsx
│   │   │       ├── GlobalContent.tsx
│   │   │       └── MainContent.tsx
│   │   ├── Constants.ts
│   │   ├── global.d.ts
│   │   ├── index.css
│   │   ├── libs
│   │   │   ├── AppStorage.ts
│   │   │   ├── AuthHelper.ts
│   │   │   ├── EventSubscriptionManager.ts
│   │   │   ├── Theme.ts
│   │   │   ├── useAssistantCapabilities.ts
│   │   │   ├── useChatCanvasController.ts
│   │   │   ├── useConversationEvents.ts
│   │   │   ├── useConversationUtility.ts
│   │   │   ├── useCreateConversation.ts
│   │   │   ├── useDebugComponentLifecycle.ts
│   │   │   ├── useDragAndDrop.ts
│   │   │   ├── useEnvironment.ts
│   │   │   ├── useExportUtility.ts
│   │   │   ├── useHistoryUtility.ts
│   │   │   ├── useKeySequence.ts
│   │   │   ├── useMediaQuery.ts
│   │   │   ├── useMicrosoftGraph.ts
│   │   │   ├── useNotify.tsx
│   │   │   ├── useParticipantUtility.tsx
│   │   │   ├── useSiteUtility.ts
│   │   │   ├── useWorkbenchEventSource.ts
│   │   │   ├── useWorkbenchService.ts
│   │   │   └── Utility.ts
│   │   ├── main.tsx
│   │   ├── models
│   │   │   ├── Assistant.ts
│   │   │   ├── AssistantCapability.ts
│   │   │   ├── AssistantServiceInfo.ts
│   │   │   ├── AssistantServiceRegistration.ts
│   │   │   ├── Config.ts
│   │   │   ├── Conversation.ts
│   │   │   ├── ConversationFile.ts
│   │   │   ├── ConversationMessage.ts
│   │   │   ├── ConversationMessageDebug.ts
│   │   │   ├── ConversationParticipant.ts
│   │   │   ├── ConversationShare.ts
│   │   │   ├── ConversationShareRedemption.ts
│   │   │   ├── ConversationState.ts
│   │   │   ├── ConversationStateDescription.ts
│   │   │   ├── ServiceEnvironment.ts
│   │   │   └── User.ts
│   │   ├── redux
│   │   │   ├── app
│   │   │   │   ├── hooks.ts
│   │   │   │   ├── rtkQueryErrorLogger.ts
│   │   │   │   └── store.ts
│   │   │   └── features
│   │   │       ├── app
│   │   │       │   ├── appSlice.ts
│   │   │       │   └── AppState.ts
│   │   │       ├── chatCanvas
│   │   │       │   ├── chatCanvasSlice.ts
│   │   │       │   └── ChatCanvasState.ts
│   │   │       ├── localUser
│   │   │       │   ├── localUserSlice.ts
│   │   │       │   └── LocalUserState.ts
│   │   │       └── settings
│   │   │           ├── settingsSlice.ts
│   │   │           └── SettingsState.ts
│   │   ├── Root.tsx
│   │   ├── routes
│   │   │   ├── AcceptTerms.tsx
│   │   │   ├── AssistantEditor.tsx
│   │   │   ├── AssistantServiceRegistrationEditor.tsx
│   │   │   ├── Dashboard.tsx
│   │   │   ├── ErrorPage.tsx
│   │   │   ├── FrontDoor.tsx
│   │   │   ├── Login.tsx
│   │   │   ├── Settings.tsx
│   │   │   ├── ShareRedeem.tsx
│   │   │   └── Shares.tsx
│   │   ├── services
│   │   │   └── workbench
│   │   │       ├── assistant.ts
│   │   │       ├── assistantService.ts
│   │   │       ├── conversation.ts
│   │   │       ├── file.ts
│   │   │       ├── index.ts
│   │   │       ├── participant.ts
│   │   │       ├── share.ts
│   │   │       ├── state.ts
│   │   │       └── workbench.ts
│   │   └── vite-env.d.ts
│   ├── tools
│   │   └── filtered-ts-prune.cjs
│   ├── tsconfig.json
│   └── vite.config.ts
└── workbench-service
    ├── .env.example
    ├── .vscode
    │   ├── extensions.json
    │   ├── launch.json
    │   └── settings.json
    ├── alembic.ini
    ├── devdb
    │   ├── docker-compose.yaml
    │   └── postgresql-init.sh
    ├── Dockerfile
    ├── Makefile
    ├── migrations
    │   ├── env.py
    │   ├── README
    │   ├── script.py.mako
    │   └── versions
    │       ├── 2024_09_19_000000_69dcda481c14_init.py
    │       ├── 2024_09_19_190029_dffb1d7e219a_file_version_filename.py
    │       ├── 2024_09_20_204130_b29524775484_share.py
    │       ├── 2024_10_30_231536_039bec8edc33_index_message_type.py
    │       ├── 2024_11_04_204029_5149c7fb5a32_conversationmessagedebug.py
    │       ├── 2024_11_05_015124_245baf258e11_double_check_debugs.py
    │       ├── 2024_11_25_191056_a106de176394_drop_workflow.py
    │       ├── 2025_03_19_140136_aaaf792d4d72_set_user_title_set.py
    │       ├── 2025_03_21_153250_3763629295ad_add_assistant_template_id.py
    │       ├── 2025_05_19_163613_b2f86e981885_delete_context_transfer_assistants.py
    │       └── 2025_06_18_174328_503c739152f3_delete_knowlege_transfer_assistants.py
    ├── pyproject.toml
    ├── README.md
    ├── semantic_workbench_service
    │   ├── __init__.py
    │   ├── api.py
    │   ├── assistant_api_key.py
    │   ├── auth.py
    │   ├── azure_speech.py
    │   ├── config.py
    │   ├── controller
    │   │   ├── __init__.py
    │   │   ├── assistant_service_client_pool.py
    │   │   ├── assistant_service_registration.py
    │   │   ├── assistant.py
    │   │   ├── conversation_share.py
    │   │   ├── conversation.py
    │   │   ├── convert.py
    │   │   ├── exceptions.py
    │   │   ├── export_import.py
    │   │   ├── file.py
    │   │   ├── participant.py
    │   │   └── user.py
    │   ├── db.py
    │   ├── event.py
    │   ├── files.py
    │   ├── logging_config.py
    │   ├── middleware.py
    │   ├── query.py
    │   ├── service_user_principals.py
    │   ├── service.py
    │   └── start.py
    ├── tests
    │   ├── __init__.py
    │   ├── conftest.py
    │   ├── docker-compose.yaml
    │   ├── test_assistant_api_key.py
    │   ├── test_files.py
    │   ├── test_integration.py
    │   ├── test_middleware.py
    │   ├── test_migrations.py
    │   ├── test_workbench_service.py
    │   └── types.py
    └── uv.lock
```

# Files

--------------------------------------------------------------------------------
/workbench-app/src/components/Conversations/InteractInput.tsx:
--------------------------------------------------------------------------------

```typescript
  1 | // Copyright (c) Microsoft. All rights reserved.
  2 | 
  3 | import {
  4 |     $createTextNode,
  5 |     $getRoot,
  6 |     ChatInput,
  7 |     ChatInputEntityNode,
  8 |     ChatInputSubmitEvents,
  9 |     ChatInputTokenNode,
 10 |     EditorInputValueData,
 11 |     EditorState,
 12 |     LexicalEditor,
 13 |     LexicalEditorRefPlugin,
 14 |     TextNode,
 15 | } from '@fluentui-copilot/react-copilot';
 16 | import { Button, makeStyles, mergeClasses, shorthands, Title3, tokens } from '@fluentui/react-components';
 17 | import { Attach20Regular } from '@fluentui/react-icons';
 18 | import debug from 'debug';
 19 | import { getEncoding } from 'js-tiktoken';
 20 | import {
 21 |     $createLineBreakNode,
 22 |     CLEAR_EDITOR_COMMAND,
 23 |     COMMAND_PRIORITY_LOW,
 24 |     LineBreakNode,
 25 |     PASTE_COMMAND,
 26 |     SerializedTextNode,
 27 | } from 'lexical';
 28 | import React from 'react';
 29 | import { Constants } from '../../Constants';
 30 | import useDragAndDrop from '../../libs/useDragAndDrop';
 31 | import { useNotify } from '../../libs/useNotify';
 32 | import { AssistantCapability } from '../../models/AssistantCapability';
 33 | import { Conversation } from '../../models/Conversation';
 34 | import { ConversationMessage } from '../../models/ConversationMessage';
 35 | import { ConversationParticipant } from '../../models/ConversationParticipant';
 36 | import { useAppDispatch, useAppSelector } from '../../redux/app/hooks';
 37 | import {
 38 |     updateGetConversationMessagesQueryData,
 39 |     useCreateConversationMessageMutation,
 40 |     useUploadConversationFilesMutation,
 41 | } from '../../services/workbench';
 42 | import { ClearEditorPlugin } from './ChatInputPlugins/ClearEditorPlugin';
 43 | import { ParticipantMentionsPlugin } from './ChatInputPlugins/ParticipantMentionsPlugin';
 44 | import { InputAttachmentList } from './InputAttachmentList';
 45 | import { InputOptionsControl } from './InputOptionsControl';
 46 | import { SpeechButton } from './SpeechButton';
 47 | 
 48 | const log = debug(Constants.debug.root).extend('InteractInput');
 49 | 
 50 | const useClasses = makeStyles({
 51 |     root: {
 52 |         display: 'flex',
 53 |         flexDirection: 'column',
 54 |         alignItems: 'center',
 55 |         width: '100%',
 56 |         gap: tokens.spacingVerticalS,
 57 |         ...shorthands.padding(tokens.spacingVerticalM),
 58 |     },
 59 |     readOnly: {
 60 |         pointerEvents: 'none',
 61 |         opacity: 0.5,
 62 |     },
 63 |     content: {
 64 |         display: 'flex',
 65 |         flexDirection: 'column',
 66 |         justifyContent: 'stretch',
 67 |         width: '100%',
 68 |         maxWidth: `${Constants.app.maxContentWidth}px`,
 69 |         gap: tokens.spacingVerticalS,
 70 | 
 71 |         // ...shorthands.padding(0, tokens.spacingHorizontalXXL, 0, tokens.spacingHorizontalM),
 72 |         boxSizing: 'border-box',
 73 |     },
 74 |     row: {
 75 |         display: 'flex',
 76 |         flexDirection: 'row',
 77 |         alignItems: 'center',
 78 |         width: '100%',
 79 |         gap: tokens.spacingHorizontalS,
 80 |     },
 81 |     rowEnd: {
 82 |         justifyContent: 'end',
 83 |     },
 84 |     fullWidth: {
 85 |         width: '100%',
 86 |         maxWidth: '100%',
 87 |     },
 88 |     commandTextbox: {
 89 |         '& [role=textbox]': {
 90 |             fontFamily: 'monospace',
 91 |         },
 92 |     },
 93 |     dragTarget: {
 94 |         transition: 'border 0.3s',
 95 |         border: `2px dashed transparent`,
 96 |     },
 97 |     dragOverBody: {
 98 |         border: `2px dashed ${tokens.colorPaletteBlueBorderActive}`,
 99 |         borderRadius: tokens.borderRadiusLarge,
100 |     },
101 |     dragOverTarget: {
102 |         cursor: 'copy',
103 |         border: `2px dashed ${tokens.colorPaletteGreenBorderActive}`,
104 |         borderRadius: tokens.borderRadiusLarge,
105 |     },
106 | });
107 | 
108 | interface InteractInputProps {
109 |     conversation: Conversation;
110 |     messages: ConversationMessage[];
111 |     participants: ConversationParticipant[];
112 |     additionalContent?: React.ReactNode;
113 |     readOnly: boolean;
114 |     assistantCapabilities: Set<AssistantCapability>;
115 | }
116 | 
117 | interface SerializedTemporaryTextNode extends SerializedTextNode {}
118 | 
119 | class TemporaryTextNode extends TextNode {
120 |     static getType() {
121 |         return 'temporary';
122 |     }
123 | 
124 |     static clone(node: TemporaryTextNode) {
125 |         return new TemporaryTextNode(node.__text, node.__key);
126 |     }
127 | 
128 |     static importJSON(serializedNode: SerializedTextNode): TextNode {
129 |         return super.importJSON(serializedNode) as TemporaryTextNode;
130 |     }
131 | 
132 |     exportJSON(): SerializedTextNode {
133 |         return super.exportJSON() as SerializedTemporaryTextNode;
134 |     }
135 | }
136 | 
137 | export const InteractInput: React.FC<InteractInputProps> = (props) => {
138 |     const { conversation, messages, participants, additionalContent, readOnly, assistantCapabilities } = props;
139 |     const classes = useClasses();
140 |     const dropTargetRef = React.useRef<HTMLDivElement>(null);
141 |     const localUserId = useAppSelector((state) => state.localUser.id);
142 |     const isDraggingOverBody = useAppSelector((state) => state.app.isDraggingOverBody);
143 |     const isDraggingOverTarget = useDragAndDrop(dropTargetRef.current, log);
144 |     const [createMessage] = useCreateConversationMessageMutation();
145 |     const [uploadConversationFiles] = useUploadConversationFilesMutation();
146 |     const [messageTypeValue, setMessageTypeValue] = React.useState<'Chat' | 'Command'>('Chat');
147 |     const [tokenCount, setTokenCount] = React.useState(0);
148 |     const [directedAtId, setDirectedAtId] = React.useState<string>();
149 |     const [attachmentFiles, setAttachmentFiles] = React.useState<Map<string, File>>(new Map());
150 |     const [isSubmitting, setIsSubmitting] = React.useState(false);
151 |     const [isListening, setIsListening] = React.useState(false);
152 |     const [editorIsInitialized, setEditorIsInitialized] = React.useState(false);
153 |     const editorRef = React.useRef<LexicalEditor | null>();
154 |     const attachmentInputRef = React.useRef<HTMLInputElement>(null);
155 |     const { notifyWarning } = useNotify();
156 |     const dispatch = useAppDispatch();
157 | 
158 |     const editorRefCallback = React.useCallback((editor: LexicalEditor) => {
159 |         editorRef.current = editor;
160 | 
161 |         // set the editor as initialized
162 |         setEditorIsInitialized(true);
163 |     }, []);
164 | 
165 |     // add a set of attachments to the list of attachments
166 |     const addAttachments = React.useCallback(
167 |         (files: Iterable<File>) => {
168 |             setAttachmentFiles((prevFiles) => {
169 |                 const updatedFiles = new Map(prevFiles);
170 |                 const duplicates = new Map<string, number>();
171 | 
172 |                 for (const file of files) {
173 |                     // limit the number of attachments to the maximum allowed
174 |                     if (updatedFiles.size >= Constants.app.maxFileAttachmentsPerMessage) {
175 |                         notifyWarning({
176 |                             id: 'attachment-limit-reached',
177 |                             title: 'Attachment limit reached',
178 |                             message: `Only ${Constants.app.maxFileAttachmentsPerMessage} files can be attached per message`,
179 |                         });
180 |                         return updatedFiles;
181 |                     }
182 | 
183 |                     if (updatedFiles.has(file.name)) {
184 |                         duplicates.set(file.name, (duplicates.get(file.name) || 0) + 1);
185 |                         continue;
186 |                     }
187 | 
188 |                     updatedFiles.set(file.name, file);
189 |                 }
190 | 
191 |                 for (const [filename, count] of duplicates.entries()) {
192 |                     notifyWarning({
193 |                         id: `duplicate-attachment-${filename}`,
194 |                         title: `Attachment with duplicate filename`,
195 |                         message: `Attachment with filename '${filename}' ${count !== 1 ? 'was' : 'were'} ignored`,
196 |                     });
197 |                 }
198 |                 return updatedFiles;
199 |             });
200 |         },
201 |         [notifyWarning],
202 |     );
203 | 
204 |     React.useEffect(() => {
205 |         if (!editorIsInitialized) return;
206 | 
207 |         if (!editorRef.current) {
208 |             console.error('Failed to get editor reference after initialization');
209 |             return;
210 |         }
211 |         const editor = editorRef.current;
212 | 
213 |         const removePasteListener = editor.registerCommand(
214 |             PASTE_COMMAND,
215 |             (event: ClipboardEvent) => {
216 |                 log('paste event', event);
217 | 
218 |                 const clipboardItems = event.clipboardData?.items;
219 |                 if (!clipboardItems) return false;
220 | 
221 |                 for (const item of clipboardItems) {
222 |                     if (item.kind !== 'file') continue;
223 |                     const file = item.getAsFile();
224 |                     if (!file) continue;
225 |                     // ensure the filename is unique by appending a timestamp before the extension
226 |                     const timestamp = new Date().getTime();
227 |                     const filename = `${file.name.replace(/\.[^/.]+$/, '')}_${timestamp}${file.name.match(
228 |                         /\.[^/.]+$/,
229 |                     )}`;
230 | 
231 |                     // file.name is read-only, so create a new file object with the new name
232 |                     // make sure to use the same file contents, content type, etc.
233 |                     const updatedFile = filename !== file.name ? new File([file], filename, { type: file.type }) : file;
234 | 
235 |                     // add the file to the list of attachments
236 |                     log('calling add attachment from paste', file);
237 |                     addAttachments([updatedFile]);
238 | 
239 |                     // Prevent default paste for file items
240 |                     event.preventDefault();
241 |                     event.stopPropagation();
242 | 
243 |                     // Indicate command was handled
244 |                     return true;
245 |                 }
246 | 
247 |                 // Allow default handling for non-file paste
248 |                 return false;
249 |             },
250 |             COMMAND_PRIORITY_LOW,
251 |         );
252 | 
253 |         return () => {
254 |             // Clean up listeners on unmount
255 |             removePasteListener();
256 |         };
257 |     }, [editorIsInitialized, addAttachments]);
258 | 
259 |     const tokenizer = React.useMemo(() => getEncoding('cl100k_base'), []);
260 | 
261 |     const onAttachmentChanged = React.useCallback(() => {
262 |         if (!attachmentInputRef.current) {
263 |             return;
264 |         }
265 |         addAttachments(attachmentInputRef.current.files ?? []);
266 |         attachmentInputRef.current.value = '';
267 |     }, [addAttachments]);
268 | 
269 |     const handleDrop = React.useCallback(
270 |         (event: React.DragEvent) => {
271 |             addAttachments(event.dataTransfer.files);
272 |         },
273 |         [addAttachments],
274 |     );
275 | 
276 |     const handleSend = (_event: ChatInputSubmitEvents, data: EditorInputValueData) => {
277 |         if (data.value.trim() === '' || isSubmitting) {
278 |             return;
279 |         }
280 | 
281 |         (async () => {
282 |             if (!localUserId) {
283 |                 throw new Error('Local user ID is not set');
284 |             }
285 | 
286 |             setIsSubmitting(true);
287 |             const content = data.value.trim();
288 |             const metadata: Record<string, any> = directedAtId ? { directed_at: directedAtId } : {};
289 | 
290 |             const messageType = messageTypeValue.toLowerCase() as 'chat' | 'command';
291 | 
292 |             const mentions: string[] = [];
293 |             const nodes = editorRef.current?.getEditorState()._nodeMap;
294 |             if (nodes) {
295 |                 for (const node of nodes.values()) {
296 |                     if (node.__type !== 'entity') continue;
297 |                     try {
298 |                         const nodeData = (node as any).__data as { type: string; participant: ConversationParticipant };
299 |                         if (nodeData.type === 'mention') {
300 |                             mentions.push(nodeData.participant.id);
301 |                         }
302 |                     } catch (error) {
303 |                         // ignore, not a mention
304 |                     }
305 |                 }
306 |             }
307 | 
308 |             if (mentions.length > 0) {
309 |                 metadata.mentions = mentions;
310 |             }
311 | 
312 |             // optimistically update the UI
313 |             // this will be replaced by the actual message when the mutation completes
314 |             // need to define the extra fields for the message such as sender, timestamp, etc.
315 |             // so that the message can be rendered correctly
316 |             dispatch(
317 |                 updateGetConversationMessagesQueryData({ conversationId: conversation.id }, [
318 |                     ...(messages ?? []),
319 |                     {
320 |                         id: 'optimistic',
321 |                         sender: {
322 |                             participantId: localUserId,
323 |                             participantRole: 'user',
324 |                         },
325 |                         timestamp: new Date().toISOString(),
326 |                         messageType,
327 |                         content,
328 |                         contentType: 'text/plain',
329 |                         filenames: [],
330 |                         metadata,
331 |                         hasDebugData: false,
332 |                     },
333 |                 ]),
334 |             );
335 | 
336 |             editorRef.current?.dispatchCommand(CLEAR_EDITOR_COMMAND, undefined);
337 | 
338 |             // upload attachments
339 |             const filenames = attachmentFiles.size > 0 ? [...attachmentFiles.keys()] : undefined;
340 |             const files = attachmentFiles.size > 0 ? [...attachmentFiles.values()] : undefined;
341 |             // reset the attachment files so that the same files are not uploaded again
342 |             setAttachmentFiles(new Map());
343 |             // reset the files form input
344 |             if (attachmentInputRef.current) {
345 |                 attachmentInputRef.current.value = '';
346 |             }
347 |             if (files) {
348 |                 await uploadConversationFiles({ conversationId: conversation.id, files });
349 |             }
350 | 
351 |             // create the message
352 |             await createMessage({
353 |                 conversationId: conversation.id,
354 |                 content,
355 |                 messageType,
356 |                 filenames,
357 |                 metadata,
358 |             });
359 | 
360 |             // reset for the next message
361 |             setMessageTypeValue('Chat');
362 | 
363 |             setIsSubmitting(false);
364 |         })();
365 |     };
366 | 
367 |     const updateInput = (newInput: string) => {
368 |         const newMessageType = newInput.startsWith('/') ? 'Command' : 'Chat';
369 |         if (newMessageType !== messageTypeValue) {
370 |             setMessageTypeValue(newMessageType);
371 |         }
372 | 
373 |         const tokens = tokenizer.encode(newInput);
374 |         setTokenCount(tokens.length);
375 |     };
376 | 
377 |     const onAttachment = () => {
378 |         attachmentInputRef.current?.click();
379 |     };
380 | 
381 |     // update the listening state when the speech recognizer starts or stops
382 |     // so that we can disable the input send while listening
383 |     const handleListeningChange = (listening: boolean) => {
384 |         setIsListening(listening);
385 |     };
386 | 
387 |     // update the editor with the in-progress recognized text while the speech recognizer is recognizing,
388 |     // which is not the final text yet, but it will give the user an idea of what is being recognized
389 |     const handleSpeechRecognizing = (text: string) => {
390 |         const editor = editorRef.current;
391 |         if (!editor) {
392 |             console.error('Failed to get editor reference');
393 |             return;
394 |         }
395 | 
396 |         editor.update(() => {
397 |             // get the editor state
398 |             const editorState: EditorState = editor.getEditorState();
399 | 
400 |             // check if there is a temporary text node in the editor
401 |             // if found, update the text content of the temporary text node
402 |             let foundTemporaryNode = false;
403 |             editorState._nodeMap.forEach((node) => {
404 |                 if (node instanceof TemporaryTextNode) {
405 |                     node.setTextContent(text);
406 |                     foundTemporaryNode = true;
407 |                 }
408 |             });
409 | 
410 |             // get the root node of the editor
411 |             const root = $getRoot();
412 | 
413 |             // if no temporary text node was found, insert a new temporary text node at the end of the editor
414 |             if (!foundTemporaryNode) {
415 |                 const selection = root.selectEnd();
416 |                 if (!selection) {
417 |                     console.error('Failed to get selection');
418 |                     return;
419 |                 }
420 | 
421 |                 // insert a line break before the temporary text node if the editor is not empty
422 |                 if (root.getTextContentSize() > 0) {
423 |                     selection.insertNodes([$createLineBreakNode()]);
424 |                 }
425 | 
426 |                 // insert the temporary text node at the end of the editor
427 |                 selection.insertNodes([new TemporaryTextNode(text)]);
428 |             }
429 | 
430 |             // select the end of the editor to ensure the temporary text node is visible
431 |             root.selectEnd();
432 |         });
433 |     };
434 | 
435 |     // update the editor with the final recognized text when the speech recognizer has recognized the speech
436 |     // this will replace the in-progress recognized text in the editor
437 |     const handleSpeechRecognized = (text: string) => {
438 |         const editor = editorRef.current;
439 |         if (!editor) {
440 |             console.error('Failed to get editor reference');
441 |             return;
442 |         }
443 | 
444 |         editor.update(() => {
445 |             // get the editor state
446 |             const editorState: EditorState = editor.getEditorState();
447 | 
448 |             // remove any temporary text nodes from the editor
449 |             editorState._nodeMap.forEach((node) => {
450 |                 if (node instanceof TemporaryTextNode) {
451 |                     node.remove();
452 |                 }
453 |             });
454 | 
455 |             // get the root node of the editor
456 |             const root = $getRoot();
457 | 
458 |             // insert the recognized text as a text node at the end of the editor
459 |             const selection = root.selectEnd();
460 |             if (!selection) {
461 |                 console.error('Failed to get selection');
462 |                 return;
463 |             }
464 |             selection.insertNodes([$createTextNode(text)]);
465 | 
466 |             // select the end of the editor to ensure the text node is visible
467 |             root.selectEnd();
468 |         });
469 |     };
470 | 
471 |     const disableSend = readOnly || isSubmitting || tokenCount === 0;
472 |     const disableInputs = readOnly || isSubmitting || isListening;
473 |     const disableAttachments =
474 |         readOnly || isSubmitting || !assistantCapabilities.has(AssistantCapability.SupportsConversationFiles);
475 | 
476 |     const tokenCounts = `${tokenCount} token${tokenCount !== 1 ? 's' : ''}`;
477 |     const attachmentCount = disableAttachments
478 |         ? ''
479 |         : `${attachmentFiles.size} attachments (max ${Constants.app.maxFileAttachmentsPerMessage})`;
480 |     const inputCounts = [tokenCounts, attachmentCount].filter((count) => count !== '').join(' | ');
481 |     const attachFilesButtonTitle = disableAttachments
482 |         ? 'Attachments are not supported by the assistants in this conversation'
483 |         : 'Attach files';
484 | 
485 |     return (
486 |         <div className={classes.root}>
487 |             {readOnly ? (
488 |                 <div className={classes.readOnly}>
489 |                     <Title3>You are currently observing this conversation.</Title3>
490 |                 </div>
491 |             ) : (
492 |                 <div className={classes.content}>
493 |                     {/* this is for injecting controls for other features */}
494 |                     {additionalContent}
495 |                     <InputOptionsControl
496 |                         disabled={readOnly}
497 |                         messageTypeValue={messageTypeValue}
498 |                         participants={participants}
499 |                         onDirectedAtChange={setDirectedAtId}
500 |                     />
501 |                     <div
502 |                         ref={dropTargetRef}
503 |                         onDrop={handleDrop}
504 |                         className={mergeClasses(
505 |                             classes.row,
506 |                             classes.dragTarget,
507 |                             isDraggingOverTarget
508 |                                 ? classes.dragOverTarget
509 |                                 : isDraggingOverBody
510 |                                 ? classes.dragOverBody
511 |                                 : '',
512 |                         )}
513 |                     >
514 |                         <ChatInput
515 |                             className={mergeClasses(
516 |                                 classes.fullWidth,
517 |                                 messageTypeValue === 'Command' ? classes.commandTextbox : '',
518 |                             )}
519 |                             onChange={(_event, data) => updateInput(data.value)}
520 |                             maxLength={Constants.app.maxInputLength}
521 |                             characterCount={tokenCount}
522 |                             charactersRemainingMessage={(charactersRemaining) =>
523 |                                 `${charactersRemaining} characters remaining`
524 |                             }
525 |                             count={<span>{inputCounts}</span>}
526 |                             disabled={readOnly}
527 |                             placeholderValue="Ask a question or request assistance or type / to enter a command."
528 |                             customNodes={[ChatInputTokenNode, ChatInputEntityNode, LineBreakNode, TemporaryTextNode]}
529 |                             disableSend={disableSend}
530 |                             onSubmit={handleSend}
531 |                             trimWhiteSpace
532 |                             showCount
533 |                             actions={
534 |                                 <span style={{ display: 'flex', alignItems: 'center' }}>
535 |                                     <span>
536 |                                         <input
537 |                                             hidden
538 |                                             ref={attachmentInputRef}
539 |                                             type="file"
540 |                                             onChange={onAttachmentChanged}
541 |                                             multiple
542 |                                         />
543 |                                         <Button
544 |                                             appearance="transparent"
545 |                                             title={attachFilesButtonTitle}
546 |                                             disabled={disableAttachments}
547 |                                             icon={<Attach20Regular />}
548 |                                             onClick={onAttachment}
549 |                                         />
550 |                                         <SpeechButton
551 |                                             disabled={disableInputs}
552 |                                             onListeningChange={handleListeningChange}
553 |                                             onSpeechRecognizing={handleSpeechRecognizing}
554 |                                             onSpeechRecognized={handleSpeechRecognized}
555 |                                         />
556 |                                     </span>
557 |                                 </span>
558 |                             }
559 |                             attachments={
560 |                                 <InputAttachmentList
561 |                                     attachments={[...attachmentFiles.values()]}
562 |                                     onDismissAttachment={(dismissedFile) =>
563 |                                         setAttachmentFiles((prevFiles) => {
564 |                                             const updatedFiles = new Map(prevFiles);
565 |                                             updatedFiles.delete(dismissedFile.name);
566 |                                             return updatedFiles;
567 |                                         })
568 |                                     }
569 |                                 />
570 |                             }
571 |                         >
572 |                             <ClearEditorPlugin />
573 |                             {participants && (
574 |                                 <ParticipantMentionsPlugin
575 |                                     participants={participants.filter((participant) => participant.id !== localUserId)}
576 |                                     parent={document.getElementById('app')}
577 |                                 />
578 |                             )}
579 |                             <LexicalEditorRefPlugin editorRef={editorRefCallback} />
580 |                         </ChatInput>
581 |                     </div>
582 |                 </div>
583 |             )}
584 |         </div>
585 |     );
586 | };
587 | 
```

--------------------------------------------------------------------------------
/assistants/knowledge-transfer-assistant/assistant/files.py:
--------------------------------------------------------------------------------

```python
  1 | """
  2 | Project files management module.
  3 | 
  4 | This module provides functionality for sharing files between Coordinator and Team conversations.
  5 | It enables automatic synchronization of files from Coordinator to Team conversations.
  6 | """
  7 | 
  8 | import asyncio
  9 | import io
 10 | import pathlib
 11 | from datetime import datetime
 12 | from typing import Dict, List, Optional
 13 | 
 14 | from pydantic import BaseModel, Field
 15 | from semantic_workbench_api_model import workbench_model
 16 | from semantic_workbench_api_model.workbench_model import MessageType, NewConversationMessage
 17 | from semantic_workbench_assistant.assistant_app import ConversationContext
 18 | 
 19 | from .common import detect_assistant_role
 20 | from .conversation_clients import ConversationClientManager
 21 | from .conversation_share_link import ConversationKnowledgePackageManager
 22 | from .data import LogEntryType
 23 | from .logging import logger
 24 | from .storage import ShareStorage, ShareStorageManager, read_model, write_model
 25 | from .storage_models import ConversationRole
 26 | 
 27 | 
 28 | # Define helper function for safe logging without 'filename' conflict
 29 | def safe_extra(log_data):
 30 |     """Create a safe extra dict for logging without LogRecord conflicts."""
 31 |     # Make a copy to avoid modifying the original
 32 |     safe_data = log_data.copy()
 33 | 
 34 |     # Rename any keys that conflict with LogRecord attributes
 35 |     if "filename" in safe_data:
 36 |         safe_data["file_name"] = safe_data.pop("filename")
 37 |     if "module" in safe_data:
 38 |         safe_data["mod_name"] = safe_data.pop("module")
 39 |     if "name" in safe_data:
 40 |         safe_data["obj_name"] = safe_data.pop("name")
 41 | 
 42 |     return safe_data
 43 | 
 44 | 
 45 | class ShareFile(BaseModel):
 46 |     """Metadata for a file shared within a share."""
 47 | 
 48 |     file_id: str
 49 |     filename: str
 50 |     content_type: str
 51 |     file_size: int
 52 |     created_by: str  # User ID
 53 |     created_at: datetime
 54 |     updated_at: datetime
 55 |     updated_by: str  # User ID
 56 |     is_coordinator_file: bool = True  # Whether this file was created by Coordinator
 57 | 
 58 | 
 59 | class ShareCollection(BaseModel):
 60 |     """Collection of file metadata for a share."""
 61 | 
 62 |     files: List[ShareFile] = Field(default_factory=list)
 63 | 
 64 | 
 65 | class ShareFilesManager:
 66 |     """
 67 |     Manages shared knowledge transfer files.
 68 | 
 69 |     Provides functionality for copying files between conversations and maintaining
 70 |     a synchronized file repository for each knowledge share.
 71 |     """
 72 | 
 73 |     @staticmethod
 74 |     def get_share_files_dir(share_id: str) -> pathlib.Path:
 75 |         """
 76 |         Gets the directory for share files.
 77 |         """
 78 |         share_dir = ShareStorageManager.get_share_dir(share_id)
 79 |         files_dir = share_dir / "files"
 80 |         files_dir.mkdir(parents=True, exist_ok=True)
 81 |         return files_dir
 82 | 
 83 |     @staticmethod
 84 |     def get_file_metadata_path(share_id: str) -> pathlib.Path:
 85 |         """
 86 |         Gets the path to the file metadata JSON.
 87 |         """
 88 |         files_dir = ShareFilesManager.get_share_files_dir(share_id)
 89 |         return files_dir / "file_metadata.json"
 90 | 
 91 |     @staticmethod
 92 |     def get_file_path(share_id: str, filename: str) -> pathlib.Path:
 93 |         """
 94 |         Gets the path to a specific file in the share.
 95 |         """
 96 |         files_dir = ShareFilesManager.get_share_files_dir(share_id)
 97 |         return files_dir / filename
 98 | 
 99 |     @staticmethod
100 |     def read_file_metadata(share_id: str) -> ShareCollection:
101 |         """
102 |         Reads file metadata for a share.
103 |         """
104 |         path = ShareFilesManager.get_file_metadata_path(share_id)
105 |         return read_model(path, ShareCollection) or ShareCollection(
106 |             files=[],
107 |         )
108 | 
109 |     @staticmethod
110 |     def write_file_metadata(share_id: str, metadata: ShareCollection) -> pathlib.Path:
111 |         """
112 |         Writes file metadata for a share.
113 |         """
114 |         path = ShareFilesManager.get_file_metadata_path(share_id)
115 |         write_model(path, metadata)
116 |         return path
117 | 
118 |     @staticmethod
119 |     async def copy_file_to_share_storage(
120 |         context: ConversationContext,
121 |         share_id: str,
122 |         file: workbench_model.File,
123 |         is_coordinator_file: bool = True,
124 |     ) -> bool:
125 |         """
126 |         Copies a file from a conversation to share storage.
127 |         """
128 |         # Create safe log data for debugging
129 |         log_extra = {
130 |             "file_name": file.filename,
131 |             "share_id": share_id,
132 |             "conversation_id": str(context.id),
133 |             "file_size": getattr(file, "file_size", 0),
134 |             "is_coordinator_file": is_coordinator_file,
135 |         }
136 | 
137 |         try:
138 |             # Verify file information
139 |             if not file.filename:
140 |                 logger.error("Missing filename in file metadata", extra=safe_extra(log_extra))
141 |                 return False
142 | 
143 |             # Check if share storage directory exists
144 |             files_dir = ShareFilesManager.get_share_files_dir(share_id)
145 |             if not files_dir.exists():
146 |                 logger.debug(f"Creating knowledge transfer files directory: {files_dir}", extra=safe_extra(log_extra))
147 |                 files_dir.mkdir(parents=True, exist_ok=True)
148 | 
149 |             # Read the file from the conversation with error handling
150 |             try:
151 |                 buffer = io.BytesIO()
152 |                 async with context.read_file(file.filename) as reader:
153 |                     async for chunk in reader:
154 |                         buffer.write(chunk)
155 | 
156 |                 # Verify we got file content
157 |                 buffer_size = buffer.tell()
158 |                 if buffer_size == 0:
159 |                     logger.error(
160 |                         "Failed to read file content from conversation - buffer is empty", extra=safe_extra(log_extra)
161 |                     )
162 |                     return False
163 | 
164 |             except Exception as read_error:
165 |                 logger.error(f"Error reading file from conversation: {read_error}", extra=safe_extra(log_extra))
166 |                 return False
167 | 
168 |             buffer.seek(0)
169 | 
170 |             # Write the file to share storage
171 |             file_path = ShareFilesManager.get_file_path(share_id, file.filename)
172 |             try:
173 |                 with open(file_path, "wb") as f:
174 |                     f.write(buffer.getvalue())
175 | 
176 |                 # Verify file was written
177 |                 if not file_path.exists() or file_path.stat().st_size == 0:
178 |                     logger.error(
179 |                         "Failed to write file to share storage - file is missing or empty",
180 |                         extra=safe_extra(log_extra),
181 |                     )
182 |                     return False
183 | 
184 |             except Exception as write_error:
185 |                 logger.error(f"Error writing file to share storage: {write_error}", extra=safe_extra(log_extra))
186 |                 return False
187 | 
188 |             # Store file metadata
189 |             file_metadata = ShareFile(
190 |                 file_id=str(getattr(file, "id", "")),
191 |                 filename=file.filename,
192 |                 content_type=file.content_type,
193 |                 file_size=file.file_size,
194 |                 created_by=file.participant_id,
195 |                 created_at=file.created_datetime,
196 |                 updated_at=file.updated_datetime,
197 |                 updated_by=file.participant_id,
198 |                 is_coordinator_file=is_coordinator_file,
199 |             )
200 | 
201 |             # Add to metadata collection with error handling
202 |             try:
203 |                 metadata_path = ShareFilesManager.get_file_metadata_path(share_id)
204 |                 logger.debug(f"Reading metadata from {metadata_path}", extra=safe_extra(log_extra))
205 | 
206 |                 metadata = read_model(metadata_path, ShareCollection)
207 |                 if not metadata:
208 |                     # Create new collection
209 |                     metadata = ShareCollection(
210 |                         files=[],
211 |                     )
212 | 
213 |                 # Check if file already exists in collection
214 |                 existing_idx = next((i for i, f in enumerate(metadata.files) if f.filename == file.filename), None)
215 |                 if existing_idx is not None:
216 |                     metadata.files[existing_idx] = file_metadata
217 |                 else:
218 |                     metadata.files.append(file_metadata)
219 | 
220 |                 # Save metadata
221 |                 ShareFilesManager.write_file_metadata(share_id, metadata)
222 | 
223 |                 # Verify metadata was written
224 |                 if not metadata_path.exists():
225 |                     logger.error(f"Failed to write metadata file {metadata_path}", extra=safe_extra(log_extra))
226 |                     return False
227 | 
228 |                 # Final check - verify file appears in metadata
229 |                 verification_metadata = read_model(metadata_path, ShareCollection)
230 |                 if not verification_metadata:
231 |                     logger.error("Metadata file exists but can't be read", extra=safe_extra(log_extra))
232 |                     return False
233 | 
234 |                 file_exists_in_metadata = any(f.filename == file.filename for f in verification_metadata.files)
235 |                 if not file_exists_in_metadata:
236 |                     logger.error(
237 |                         f"File metadata doesn't contain entry for {file.filename}", extra=safe_extra(log_extra)
238 |                     )
239 |                     return False
240 | 
241 |             except Exception as metadata_error:
242 |                 logger.error(f"Error updating metadata: {metadata_error}", extra=safe_extra(log_extra))
243 |                 return False
244 | 
245 |             return True
246 | 
247 |         except Exception as e:
248 |             logger.exception(f"Error copying file to share storage: {e}", extra=safe_extra(log_extra))
249 |             return False
250 | 
251 |     @staticmethod
252 |     async def delete_file_from_knowledge_share_storage(
253 |         context: ConversationContext, share_id: str, filename: str
254 |     ) -> bool:
255 |         """
256 |         Deletes a file from share storage.
257 |         """
258 |         try:
259 |             # Get the file path
260 |             file_path = ShareFilesManager.get_file_path(share_id, filename)
261 |             if not file_path.exists():
262 |                 return True  # File doesn't exist, nothing to delete
263 | 
264 |             # Remove the file
265 |             file_path.unlink()
266 | 
267 |             # Update metadata
268 |             metadata_path = ShareFilesManager.get_file_metadata_path(share_id)
269 |             metadata = read_model(metadata_path, ShareCollection)
270 |             if not metadata:
271 |                 return True  # No metadata to update
272 | 
273 |             # Remove the file from metadata
274 |             metadata.files = [f for f in metadata.files if f.filename != filename]
275 | 
276 |             # Save metadata
277 |             ShareFilesManager.write_file_metadata(share_id, metadata)
278 | 
279 |             # Also notify Team conversations to delete their copies
280 |             await ShareFilesManager.notify_team_conversations_file_deleted(
281 |                 context=context, share_id=share_id, filename=filename
282 |             )
283 | 
284 |             return True
285 | 
286 |         except Exception as e:
287 |             logger.exception(f"Error deleting file from share storage: {e}")
288 |             return False
289 | 
290 |     @staticmethod
291 |     async def notify_team_conversations_file_deleted(
292 |         context: ConversationContext, share_id: str, filename: str
293 |     ) -> None:
294 |         """
295 |         Notifies Team conversations to delete a file that was deleted by the Coordinator.
296 |         """
297 |         try:
298 |             # Get Team conversations
299 |             team_conversations = await ShareFilesManager.get_team_conversations(context, share_id)
300 |             if not team_conversations:
301 |                 return
302 | 
303 |             for conv_id in team_conversations:
304 |                 try:
305 |                     client = ConversationClientManager.get_conversation_client(context, conv_id)
306 | 
307 |                     # Check if file exists in the conversation
308 |                     conversation = await client.get_conversation()
309 |                     files = getattr(conversation, "files", [])
310 |                     file_exists = any(f.filename == filename for f in files)
311 | 
312 |                     if file_exists:
313 |                         # Delete the file
314 |                         await client.delete_file(filename)
315 |                         logger.debug(f"Deleted file {filename} from Team conversation {conv_id}")
316 | 
317 |                         # Send notification
318 |                         await client.send_messages(
319 |                             NewConversationMessage(
320 |                                 content=f"Coordinator deleted a shared file: {filename}",
321 |                                 message_type=MessageType.notice,
322 |                             )
323 |                         )
324 |                 except Exception as e:
325 |                     logger.warning(f"Failed to delete file {filename} from Team conversation {conv_id}: {e}")
326 | 
327 |         except Exception as e:
328 |             logger.exception(f"Error notifying Team conversations about deleted file: {e}")
329 | 
330 |     @staticmethod
331 |     async def copy_file_to_conversation(
332 |         context: ConversationContext,
333 |         share_id: str,
334 |         filename: str,
335 |         target_conversation_id: str,
336 |     ) -> bool:
337 |         """
338 |         Copies a file from share storage to a target conversation.
339 |         """
340 |         try:
341 |             # Check if the file exists in share storage
342 |             file_path = ShareFilesManager.get_file_path(share_id, filename)
343 |             if not file_path.exists():
344 |                 logger.warning(f"File {filename} not found in share storage")
345 |                 return False
346 | 
347 |             # Get file metadata
348 |             metadata = ShareFilesManager.read_file_metadata(share_id)
349 |             if not metadata:
350 |                 logger.warning(f"No file metadata found for share {share_id}")
351 |                 return False
352 | 
353 |             # Find the file metadata
354 |             file_meta = next((f for f in metadata.files if f.filename == filename), None)
355 |             if not file_meta:
356 |                 logger.warning(f"No metadata found for file {filename}")
357 |                 return False
358 | 
359 |             # Create client for target conversation
360 |             target_client = ConversationClientManager.get_conversation_client(context, target_conversation_id)
361 |             if not target_client:
362 |                 logger.warning(f"Could not create client for conversation {target_conversation_id}")
363 |                 return False
364 | 
365 |             # Read the file content
366 |             try:
367 |                 with open(file_path, "rb") as f:
368 |                     file_bytes = f.read()
369 | 
370 |                 if not file_bytes:
371 |                     logger.warning(f"Failed to read file content from {file_path} (empty file)")
372 |                     return False
373 | 
374 |                 file_content = io.BytesIO(file_bytes)
375 |             except Exception as read_error:
376 |                 logger.error(f"Failed to read file: {read_error}")
377 |                 return False
378 | 
379 |             # Determine content type
380 |             content_type = file_meta.content_type
381 |             if not content_type:
382 |                 content_type = "application/octet-stream"
383 | 
384 |             # Check if the file exists and delete it first (to handle updates)
385 |             try:
386 |                 conversation = await target_client.get_conversation()
387 |                 target_files = getattr(conversation, "files", [])
388 |                 file_exists = any(f.filename == filename for f in target_files)
389 | 
390 |                 if file_exists:
391 |                     logger.debug(f"File {filename} exists, deleting before upload")
392 |                     await target_client.delete_file(filename)
393 | 
394 |                     # Brief wait after deletion
395 |                     await asyncio.sleep(1.0)
396 |             except Exception as e:
397 |                 logger.error(f"Could not check/delete existing file: {e}")
398 |                 # Continue with upload anyway
399 | 
400 |             # Upload the file
401 |             try:
402 |                 file_content.seek(0)  # Reset position to start of file
403 |                 await target_client.write_file(filename=filename, file_content=file_content, content_type=content_type)
404 |                 logger.debug(f"Successfully uploaded file {filename}")
405 |                 return True
406 |             except Exception as upload_error:
407 |                 logger.error(f"Failed to upload file: {upload_error}")
408 |                 return False
409 | 
410 |         except Exception as e:
411 |             logger.exception(f"Error copying file to conversation: {e}")
412 |             return False
413 | 
414 |     @staticmethod
415 |     async def get_team_conversations(context: ConversationContext, share_id: str) -> List[str]:
416 |         """
417 |         Gets all Team conversation IDs for a share.
418 |         """
419 |         try:
420 |             # Get linked conversations
421 |             linked_conversations = await ConversationKnowledgePackageManager.get_linked_conversations(context)
422 | 
423 |             # Filter for team conversations
424 |             team_conversations = []
425 |             for conv_id in linked_conversations:
426 |                 # Check if this is a team conversation
427 |                 temp_context = await ShareFilesManager.create_temporary_context(context, conv_id)
428 |                 if temp_context:
429 |                     role = await ConversationKnowledgePackageManager.get_conversation_role(temp_context)
430 |                     if role == ConversationRole.TEAM:
431 |                         team_conversations.append(conv_id)
432 | 
433 |             return team_conversations
434 | 
435 |         except Exception as e:
436 |             logger.exception(f"Error getting team conversations: {e}")
437 |             return []
438 | 
439 |     @staticmethod
440 |     async def create_temporary_context(
441 |         source_context: ConversationContext, target_conversation_id: str
442 |     ) -> Optional[ConversationContext]:
443 |         """
444 |         Creates a temporary context for a target conversation.
445 |         """
446 |         try:
447 |             return await ConversationClientManager.create_temporary_context_for_conversation(
448 |                 source_context, target_conversation_id
449 |             )
450 | 
451 |         except Exception as e:
452 |             logger.exception(f"Error creating temporary context: {e}")
453 |             return None
454 | 
455 |     @staticmethod
456 |     async def synchronize_files_to_team_conversation(
457 |         context: ConversationContext,
458 |         share_id: str,
459 |     ) -> None:
460 |         """
461 |         Synchronize all share files to a Team conversation.
462 |         """
463 |         logger.debug(f"Starting file synchronization for share {share_id}")
464 | 
465 |         # Get file metadata for the share
466 |         metadata = ShareFilesManager.read_file_metadata(share_id)
467 | 
468 |         if not metadata or not metadata.files:
469 |             # No metadata found
470 |             await context.send_messages(
471 |                 NewConversationMessage(
472 |                     content="No shared files available. The coordinator hasn't shared any files yet.",
473 |                     message_type=MessageType.notice,
474 |                 )
475 |             )
476 | 
477 |         # Identify Coordinator files to sync
478 |         coordinator_files = [f for f in metadata.files if f.is_coordinator_file]
479 | 
480 |         # Check which files already exist in conversation
481 |         conversation = await context.get_conversation()
482 |         existing_files = getattr(conversation, "files", [])
483 |         existing_filenames = {f.filename for f in existing_files}
484 | 
485 |         # Track successful and failed files
486 |         successful_files = []
487 |         failed_files = []
488 |         skipped_files = []  # Files that already exist
489 | 
490 |         # Process each file
491 |         for file_meta in coordinator_files:
492 |             # Skip files that already exist
493 |             if file_meta.filename in existing_filenames:
494 |                 skipped_files.append(file_meta.filename)
495 |                 continue
496 | 
497 |             # Try to copy the file
498 |             success = await ShareFilesManager.copy_file_to_conversation(
499 |                 context=context,
500 |                 share_id=share_id,
501 |                 filename=file_meta.filename,
502 |                 target_conversation_id=str(context.id),
503 |             )
504 | 
505 |             if success:
506 |                 successful_files.append(file_meta.filename)
507 |             else:
508 |                 failed_files.append(file_meta.filename)
509 | 
510 |         # Create notification message for the user
511 |         available_files = successful_files + skipped_files
512 |         if available_files:
513 |             # Create message about synchronized files
514 |             if successful_files:
515 |                 file_list = ", ".join(successful_files)
516 |                 message = f"Synchronized files from Coordinator: {file_list}"
517 | 
518 |                 # Add info about skipped files if any
519 |                 if skipped_files:
520 |                     existing_list = ", ".join(skipped_files)
521 |                     message += f"\nAlready available: {existing_list}"
522 |             else:
523 |                 # Only skipped files
524 |                 file_list = ", ".join(skipped_files)
525 |                 message = f"All shared files already available: {file_list}"
526 | 
527 |             # Send notification
528 |             await context.send_messages(
529 |                 NewConversationMessage(
530 |                     content=message,
531 |                     message_type=MessageType.notice,
532 |                 )
533 |             )
534 | 
535 |             # Log the synchronization event
536 |             sync_message = (
537 |                 f"Synchronized files to Team conversation: {len(successful_files)} new, {len(skipped_files)} existing"
538 |             )
539 | 
540 |             await ShareStorage.log_share_event(
541 |                 context=context,
542 |                 share_id=share_id,
543 |                 entry_type=LogEntryType.FILE_SHARED,
544 |                 message=sync_message,
545 |                 metadata={
546 |                     "successful_files": successful_files,
547 |                     "skipped_files": skipped_files,
548 |                     "failed_files": failed_files,
549 |                 },
550 |             )
551 | 
552 |     @staticmethod
553 |     async def get_shared_files(context: ConversationContext, share_id: str) -> Dict[str, ShareFile]:
554 |         """
555 |         Gets all shared files for a share with filename as key.
556 |         """
557 |         try:
558 |             # Get file metadata for the share
559 |             metadata = ShareFilesManager.read_file_metadata(share_id)
560 |             if not metadata or not metadata.files:
561 |                 return {}
562 | 
563 |             # Create dictionary with filename as key
564 |             files_dict = {f.filename: f for f in metadata.files}
565 |             return files_dict
566 | 
567 |         except Exception as e:
568 |             logger.exception(f"Error getting shared files: {e}")
569 |             return {}
570 | 
571 |     @staticmethod
572 |     async def process_share_update_notification(
573 |         context: ConversationContext, share_id: str, update_type: str, filename: str
574 |     ) -> bool:
575 |         """
576 |         Processes a file update notification in a Team conversation.
577 |         """
578 |         try:
579 |             # First verify that this is a Team conversation
580 |             role = await detect_assistant_role(context)
581 | 
582 |             if role != ConversationRole.TEAM:
583 |                 logger.warning("Only Team conversations should process file update notifications")
584 |                 return False
585 | 
586 |             # Process based on update type
587 |             if update_type == "file_created" or update_type == "file_updated":
588 |                 # Synchronize the specific file from share storage
589 |                 success = await ShareFilesManager.copy_file_to_conversation(
590 |                     context=context, share_id=share_id, filename=filename, target_conversation_id=str(context.id)
591 |                 )
592 | 
593 |                 action = "added" if update_type == "file_created" else "updated"
594 |                 if success:
595 |                     return True
596 |                 else:
597 |                     logger.warning(f"Failed to {action} file {filename} in Team conversation {context.id}")
598 |                     return False
599 | 
600 |             elif update_type == "file_deleted":
601 |                 # Delete the file from this conversation
602 |                 try:
603 |                     # Check if file exists
604 |                     conversation = await context.get_conversation()
605 |                     files = getattr(conversation, "files", [])
606 |                     file_exists = files and any(f.filename == filename for f in files)
607 | 
608 |                     if file_exists:
609 |                         # Delete the file
610 |                         await context.delete_file(filename)
611 |                         logger.debug(f"Deleted file {filename} from Team conversation {context.id}")
612 |                         return True
613 |                     else:
614 |                         # File doesn't exist, nothing to do
615 |                         return True
616 | 
617 |                 except Exception as e:
618 |                     logger.warning(f"Failed to delete file {filename} from Team conversation: {e}")
619 |                     return False
620 |             else:
621 |                 logger.warning(f"Unknown file update type: {update_type}")
622 |                 return False
623 | 
624 |         except Exception as e:
625 |             logger.exception(f"Error processing file update notification: {e}")
626 |             return False
627 | 
```
Page 101/145FirstPrevNextLast