From 79c057e0d323b852c0866260a0ad7b971df727b6 Mon Sep 17 00:00:00 2001 From: Adeel Ahmad Date: Sun, 18 Oct 2026 06:07:16 +0000 Subject: [PATCH] docs: list chat export, tool choice, deep research, the sandbox gateway and clipper sign-in as built Since the last README refresh, #474, #484, #510, #511, #497, #495, #406, #516, #517, #491, #400 and #506 merged. The README's built list now says the assistant answers questions about Lens itself; a conversation exports as Markdown, PDF or JSON and its answers, questions and code copy; a Tools chip picks an answer's tools, limit and namespaces; sandbox runs open under the answer with downloads, and Settings starts the gateway; deep research plans, runs and returns a cited report; ready-made MCP servers, the MCP servers page and the optional containers start from the web app; and the web clipper signs in or takes an API token. Each has its checks in docs/requirements.md. In progress lists only open PRs; the Nebula mesh (#546, merged, partly built) moves to Planned with what's next; the Planned proof item keeps only the Raspberry Pi timing; the docs index links requirements and checks, and published feeds. Co-Authored-By: Claude Opus 5.5 (1M context) Claude-Session: https://claude.ai/code/session_01HDx7PPUauyjMn1LZs8JAsS --- README.md | 91 +++++++++++++++++++++++++++----------------- docs/requirements.md | 10 +++++ 2 files changed, 66 insertions(+), 35 deletions(-) diff --git a/README.md b/README.md index f2f6051ee..0fbaa02b3 100644 --- a/README.md +++ b/README.md @@ -76,29 +76,45 @@ listed under [In progress](#in-progress), and what comes next under [Planned](#p [API](docs/api.md), [the graph as files](docs/file-tree.md), [authentication](docs/authentication.md); [checks](docs/requirements.md#connect-your-agents)) - **Ask, and get cited answers.** A chat assistant on every page, and by voice, searches your archive by words (and by - meaning, once turned on), reads it, cites it and acts on it with tools: changes wait for your approval. Once an admin - turns them on, it also searches the web and reads pages, cited like the archive, and runs Python and bash in a sandbox - of each conversation's own. An admin's assistant searches and reads the mail, calendars and files connected to Lens - (Gmail, Google Calendar, Google Drive, S3 and the rest), cites messages and events, and brings them in once you - approve. Regenerating an answer or editing a question makes a new version beside the old one, and - nothing is lost. Each answer keeps a record of what produced it (the model, its tools, how long it took and what it - cost), opened from its header. It reads answers aloud with a speech provider, macOS `say` or StyleTTS2 on this machine - (opt-in), any message in one click. Long conversations are summarised before they fill the model's context, and - `/clear` and `/compact` start afresh or summarise now. Conversations title themselves after their first answer, unless - you name them. Each namespace can have its own assistant with - its own name, instructions and memory, answering in Telegram and Slack (built in, with voice notes and files), in - Discord, Matrix, WhatsApp and other chat rooms through Matterbridge, and by email at an address of its own that you - email or forward things to. ([Chat](docs/assistant.md), [web search](docs/assistant.md#web-search-and-reading-pages), - [mail, calendars and files](docs/assistant.md#mail-calendars-and-files), [code sandbox](docs/assistant.md#code-sandbox), [answer records](docs/assistant.md#what-each-answer-records), - [chat rooms](docs/chat-rooms.md), [email](docs/assistant-email.md), [speech providers](docs/speech-providers.md); + meaning, once turned on), reads it, cites it and acts on it with tools: changes wait for your approval. Ask it about + Lens itself ("what's the MCP address?", "is Telegram on?") and it answers from Lens's docs and this server, citing + both. A Tools chip picks which tools an answer may use, how many calls it may make and which namespaces it reads. Once + an admin turns them on, it also searches the web and reads pages, cited like the archive, and runs Python and bash in + a sandbox of each conversation's own (on a Docker install, Settings starts the sandbox's gateway next to Lens); each + run opens under the answer with its code and output, and a file it makes downloads from there. An admin's assistant + searches and reads the mail, calendars and files connected to Lens (Gmail, Google Calendar, Google Drive, S3 and the + rest), cites messages and events, and brings them in once you approve. Give it a goal that needs many look-ups and + deep research comes back with a plan to approve, edit or revise, then runs in the background and returns a cited + report, checked against its sources, to keep as a note, hear aloud or turn into a podcast. Regenerating an answer or + editing a question makes a new version beside the old one, and nothing is lost. Each answer keeps a record of what + produced it (the model, its tools, how long it took and what it cost), opened from its header. Copy an answer as + Markdown or plain text, a question or a code block, and export a conversation as Markdown, PDF or JSON, its citations + as footnotes that link back to the moment in Lens. It reads answers aloud with a speech provider, macOS `say` or + StyleTTS2 on this machine (opt-in), any message in one click. Long conversations are summarised before they fill the + model's context, and `/clear` and `/compact` start afresh or summarise now. Conversations title themselves after their + first answer, unless you name them. Each namespace can have its own assistant with its own name, instructions and + memory, answering in Telegram and Slack (built in, with voice notes and files), in Discord, Matrix, WhatsApp and other + chat rooms through Matterbridge, and by email at an address of its own that you email or forward things to. + ([Chat](docs/assistant.md), [questions about Lens](docs/assistant.md#questions-about-lens-itself), + [choosing tools](docs/assistant.md#choosing-tools-namespaces-and-a-limit), + [web search](docs/assistant.md#web-search-and-reading-pages), [code sandbox](docs/assistant.md#code-sandbox), + [the gateway](docs/assistant.md#the-gateway), [mail, calendars and files](docs/assistant.md#mail-calendars-and-files), + [deep research](docs/assistant.md#deep-research), [answer records](docs/assistant.md#what-each-answer-records), + [copy and export](docs/assistant.md#copy-and-export), [chat rooms](docs/chat-rooms.md), + [email](docs/assistant-email.md), [speech providers](docs/speech-providers.md); [checks](docs/requirements.md#ask-and-get-cited-answers)) - **Extend the assistant.** Add tools (a prompt, a web request, a graph drawn on the canvas, or sandboxed Python), skills, hooks and MCP servers, by code, on the canvas or just by asking. Remote MCP servers connect by address, and - ones that run as a program (`npx`, `uvx`) run in a sandboxed container of their own, off until you turn it on. Add - one with a form or by pasting another app's config, its tokens sealed and each of its tools switched on or off. - Install skills and plugins from marketplaces in the open plugin format, or from a repository or an archive. + ones that run as a program (`npx`, `uvx`) run in a sandboxed container of their own, off until you turn it on. Add one + with a form or by pasting another app's config, its tokens sealed and each of its tools switched on or off, or pick a + ready-made one: GitHub's own server, or a browser (a headless Chromium in a sandbox of its own) the assistant opens, + reads, clicks and types in, asking before anything that acts on a page. Settings › AI assistant › MCP servers lists + them all, and agents list and add them over MCP. The MCP runner, the browser and monitoring are containers Lens starts + next to itself from the web app, through the machine's upgrade agent, each off until an admin turns it on. Install + skills and plugins from marketplaces in the open plugin format, or from a repository or an archive. ([Extending the assistant](docs/assistant.md#extending-the-assistant-tools-skills-hooks-and-plugins), - [adding an MCP server](docs/assistant.md#adding-an-mcp-server), [the MCP runner](docs/assistant.md#the-mcp-runner); + [adding an MCP server](docs/assistant.md#adding-an-mcp-server), [the MCP runner](docs/assistant.md#the-mcp-runner), + [the browser](docs/assistant.md#the-browser), [optional containers](docs/assistant.md#optional-containers); [checks](docs/requirements.md#extend-the-assistant)) - **Bring in everything.** Watched folders on S3, Dropbox, Google Drive, OneDrive, SFTP, SMB, WebDAV or local disks (a local folder in four clicks); IMAP mail, Gmail and Google Workspace, iCal calendars, Google Calendar and RSS and Atom @@ -112,10 +128,12 @@ listed under [In progress](#in-progress), and what comes next under [Planned](#p ([Sensors](docs/sensors.md), [processing](docs/processing.md), [Apache Tika](docs/configuration.md#apache-tika), [import webhooks](docs/api.md#import-webhooks); [checks](docs/requirements.md#bring-in-everything)) - **Clip from the browser.** The Lens web clipper for Chrome, Edge, Firefox and Safari turns a page, a selection or a - part you pick into Markdown, lets you look it over, and sends it to a namespace. New releases reach installed copies - through the browser's store or a self-hosted update file. In Chrome and Edge, its side panel is a chat with the + part you pick into Markdown, lets you look it over, and sends it to a namespace. It signs in to Lens with nothing to + copy, or takes your API token or an import webhook's, and says why a token is refused. New releases reach installed + copies through the browser's store or a self-hosted update file. In Chrome and Edge, its side panel is a chat with the assistant, which can also use that browser on the sites you allow (open, read, click, type), asking before anything - that sends, deletes, buys or posts. ([Web clipper](docs/web-clipper.md), + that sends, deletes, buys or posts. + ([Web clipper](docs/web-clipper.md), [setting it up](docs/web-clipper.md#setting-it-up), [the assistant in your browser](docs/browser-assistant.md); [checks](docs/requirements.md#clip-from-the-browser)) - **Understand it.** Transcription, people recognised by voice (long recordings go to a speech provider in pieces that fit its limits), text on screen and in scans, faces (off by default), NSFW pictures flagged by a model on your own @@ -227,15 +245,16 @@ still loading. ([Components](docs/components.md), These are open pull requests, not yet part of Lens: -- **The assistant** answering questions about Lens itself, from its docs and this server - ([#400](https://github.com/adeelahmad/lense/pull/400)). -- **Chat:** a conversation exported as Markdown, PDF or JSON ([#474](https://github.com/adeelahmad/lense/pull/474)). +- **The assistant** sending mail, adding events and writing files after a yes + ([#552](https://github.com/adeelahmad/lense/pull/552)). +- **Voice:** answers and podcasts read aloud with Kokoro on this machine + ([#538](https://github.com/adeelahmad/lense/pull/538)). +- **Schedules:** one page for every routine, automation schedule and the backup + ([#535](https://github.com/adeelahmad/lense/pull/535)). +- **Secrets:** secret settings read from Vaultwarden by reference + ([#550](https://github.com/adeelahmad/lense/pull/550)). - **Pictures:** low-quality images enhanced before they're read ([#479](https://github.com/adeelahmad/lense/pull/479)). -- **Web clipper:** signing in, or using your API token, not only an import webhook's - ([#406](https://github.com/adeelahmad/lense/pull/406)). -- **Automations:** more operators for conditions ([#434](https://github.com/adeelahmad/lense/pull/434)). -- **Nodes:** Lens's own private network between the machines it runs on, a Nebula mesh it issues the certificates - for ([#546](https://github.com/adeelahmad/lense/pull/546)). +- **Transcripts:** grammar fixed with a LanguageTool server ([#521](https://github.com/adeelahmad/lense/pull/521)). ## Planned @@ -253,9 +272,11 @@ Next, and not in a pull request yet; each links to where it is tracked: ([storage](docs/storage.md)). - **Logging:** sending straight to Loki or another HTTP endpoint, and client certificates for TLS ([logging](docs/logging.md)). -- **Proof:** each release tested by upgrading an install of the last one, holding data - ([#482](https://github.com/adeelahmad/lense/issues/482)), and the scorecard's install-to-first-answer and Raspberry Pi - numbers, not measured yet ([#481](https://github.com/adeelahmad/lense/issues/481)). +- **Nodes:** Lens's own private network between the machines it runs on, a Nebula mesh it issues the certificates + for: the certificate authority, join tokens and the API are built; Nebula running on the primary, `lens node` and + Settings › Nodes come next ([nodes and the mesh](docs/mesh.md)). +- **Proof:** the install timed on a real Raspberry Pi, where GitHub's faster arm64 runner gives only a floor + ([scorecard](docs/contributing.md#scorecard)). ## Stack @@ -281,7 +302,7 @@ The guides are on the [docs site](https://adeelahmad.github.io/lense/) and in th [web clipper](docs/web-clipper.md), [the assistant in your browser](docs/browser-assistant.md), [sensors](docs/sensors.md), [processing](docs/processing.md), [video](docs/video.md), [NSFW classification](docs/nsfw.md), [notifications](docs/notifications.md), [automations](docs/automations.md), - [timeline](docs/timeline.md) + [timeline](docs/timeline.md), [published feeds](docs/feeds.md) - **Knowledge:** [graph and Cypher](docs/graph.md), [graph history](docs/graph-history.md), [topics](docs/topics.md), [the graph as files](docs/file-tree.md), [NFS share](docs/file-shares.md), [SMB share](docs/smb.md), [linked data (RDF)](docs/rdf.md), [IIIF](docs/iiif.md), [Fedora](docs/fedora.md) @@ -292,7 +313,7 @@ The guides are on the [docs site](https://adeelahmad.github.io/lense/) and in th [usage analytics](docs/analytics.md) - **Build:** [architecture](docs/architecture.md), [web app](docs/frontend.md), [technology](docs/technology-selection.md), [API work the design needs](docs/backend-gaps.md), - [contributing](CONTRIBUTING.md), [agent rules](AGENTS.md) + [contributing](CONTRIBUTING.md), [requirements and checks](docs/requirements.md), [agent rules](AGENTS.md) [Security](SECURITY.md), [threat model](threat-model.md), [changelog](CHANGELOG.md). diff --git a/docs/requirements.md b/docs/requirements.md index a7f3a2b3c..fd214ae8a 100644 --- a/docs/requirements.md +++ b/docs/requirements.md @@ -78,11 +78,18 @@ request, to another check that proves the same thing; loosening a requirement or | It searches by words, and by meaning once search by meaning is set up | [test_chats.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_chats.py) `test_tools_approvals_and_checking`; [test_semantic.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_semantic.py) `test_chat_retrieval_by_meaning`, `test_off_or_unconfigured` | | Answers cite their sources, and only what the person may read | [test_chats.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_chats.py) `test_chat_cites_only_what_you_can_read`; [chat.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/chat.test.tsx) `splits [n], [n, m] and [n][m]` | | It acts with tools, and changes wait for approval | [test_chats.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_chats.py) `test_tools_approvals_and_checking`; [test_approvals.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_approvals.py) `test_the_assistant_lists_and_declines_but_never_approves` | +| Questions about Lens itself answered from Lens's docs and this server's facts, both cited, for people and agents over MCP | [test_lens_help.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_lens_help.py) `test_the_docs_are_found_by_words`, `test_the_assistant_answers_about_lens_itself`, `test_agents_ask_lens_over_mcp`, `test_without_a_question_lens_help_still_gives_the_server` | +| A conversation, or one question, picks the tools an answer may use, a limit on its tool calls and the namespaces it reads | [test_chat_tools.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_chat_tools.py) `test_an_answer_is_offered_only_what_was_picked`, `test_at_most_so_many_tool_calls`, `test_a_scope_for_one_answer`; [chat-tools-picker.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/chat-tools-picker.test.tsx) `picks groups, keeps single tools, and goes back to Auto`, `limits the tool calls, from 1 to the server's most` | | Web search and reading pages, cited like the archive, off until an admin turns it on | [test_web_search.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_web_search.py) `test_an_answer_cites_the_web_and_the_conversation_keeps_it`, `test_reading_pages_and_pdfs`; [chat-web-citations.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/chat-web-citations.test.tsx) | | An admin's assistant searches and reads connected mail, calendars and files, cites messages and events, and brings them in only once approved | [test_connection_tools.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_connection_tools.py) `test_only_admins_get_them_and_only_for_what_is_connected`, `test_searching_and_reading_gmail`, `test_calendar_events_between_two_times`, `test_finding_and_reading_files_in_storage`, `test_bringing_things_in_waits_for_the_persons_yes`; [chat-web-citations.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/chat-web-citations.test.tsx) `a message from a connected mailbox` | | Python and bash in a sandbox of each conversation's own, off until an admin turns it on | [test_sandbox.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_sandbox.py) `test_python_and_bash_share_one_sandbox_per_conversation`, `test_the_sandbox_is_off_until_an_admin_turns_it_on_for_the_people_it_names` | +| Each run opens under the answer with its code and output, and a file the sandbox makes downloads from there | [test_sandbox.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_sandbox.py) `test_a_run_shows_its_output_and_a_file_it_shares_downloads_from_the_answer`; [sandbox-steps.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/sandbox-steps.test.tsx) `shows the code collapsed, then the code and its output`, `downloads a file the sandbox shared from the answer` | +| On a Docker install, Settings starts and stops the sandbox's gateway next to Lens, and says why a machine can't run it | [test_sandbox.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_sandbox.py) `test_the_gateway_is_started_and_stopped_from_settings`, `test_a_machine_that_cant_run_the_gateway_says_why`; [sandbox-gateway.test.ts](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/sandbox-gateway.test.ts) `says what the machine is doing, and whether Lens reaches the gateway` | +| Deep research: a goal becomes a plan to approve, edit or revise (a yes in a chat room approves it), runs in the background and returns a cited report checked against its sources, from chat, the API and MCP | [test_research.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_research.py) `test_a_goal_gets_a_plan_that_waits_for_approval_and_can_be_revised`, `test_an_approved_plan_runs_and_its_report_comes_back_checked`, `test_a_plan_is_approved_with_a_yes_in_a_chat_room`, `test_agents_start_research_over_mcp`, `test_a_report_becomes_a_note_and_a_podcast`; [chat-research.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/chat-research.test.tsx) `approves the plan with Enter, sending the edits`, `shows the stage, what's done and spent, and stops the run`, `reads it aloud, makes a podcast and exports Markdown` | | Regenerating an answer or editing a question makes a new version beside the old one | [test_chat_versions.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_chat_versions.py) `test_regenerate_edit_switch_and_go_on`; [chat-versions.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/chat-versions.test.tsx) `regenerating an answer`, `the version switch`; [journeys.mjs](https://github.com/adeelahmad/lense/blob/main/ci/clicks/journeys.mjs) `chat-regenerate`; [baseline.json](https://github.com/adeelahmad/lense/blob/main/ci/clicks/baseline.json) `chat-regenerate` ≤ 4 clicks | | Each answer keeps a record of what produced it: the model, its tools, how long it took and what it cost | [test_chat_records.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_chat_records.py) `test_an_answer_records_what_produced_it`, `test_a_regenerated_answer_has_its_own_record`; [chat-details.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/chat-details.test.tsx) `says what produced it: model and host, scope, tools, use, tokens, cost, time and how it ended` | +| A conversation exported as Markdown, PDF or JSON, its citations as footnotes linking back to Lens, by people and by agents over MCP | [test_chat_export.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_chat_export.py) `test_markdown`, `test_json`, `test_pdf_is_printed_by_what_the_server_has`, `test_agents_read_and_export_over_mcp`; [chat-copy-export.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/chat-copy-export.test.tsx) `downloads what the server makes, named as the server names it`, `prints in the browser when the server can't make the PDF` | +| Answers, questions and code blocks copied from the web app, an answer as Markdown or plain text | [chat-copy-export.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/chat-copy-export.test.tsx) `gives Markdown with citations as footnotes linking back to Lens, or plain text`, `copies a question`, `copies a code block and says Copied` | | Answers read aloud by a speech provider, macOS `say` or StyleTTS2 (opt-in) | [test_voice.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_voice.py) `test_answers_are_read_aloud_by_a_speech_model`; [test_speech.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/domain/test_speech.py) `test_macos_say_reads_aloud_on_a_mac`, `test_styletts2_reads_aloud_from_its_own_service`; [styletts2.yml](https://github.com/adeelahmad/lense/blob/main/.github/workflows/styletts2.yml) `Read a sentence aloud` | | Any message read aloud in one click, one at a time, its audio kept so a replay costs nothing | [chat-read-aloud.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/chat-read-aloud.test.tsx) `plays an answer by the speech model in one click, stops on the next, and keeps its audio`, `reads one message at a time: starting another stops the first`, `reads a long answer piece by piece, asking for the next while one plays` | | Conversations title themselves after their first answer, and a name you give is kept | [test_chat_titles.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_chat_titles.py) `test_a_first_answer_titles_the_conversation`, `test_a_title_you_give_is_kept`, `test_agents_rename_and_retitle_over_mcp` | @@ -100,6 +107,8 @@ request, to another check that proves the same thing; loosening a requirement or | Skills, hooks and MCP servers, by code, on the canvas or by asking | [test_extensions.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_extensions.py) `test_written_as_code_shared_and_versioned`, `test_change_tools_ask_first_and_hooks`, `test_made_in_chat_behind_an_approval`; [journeys.mjs](https://github.com/adeelahmad/lense/blob/main/ci/clicks/journeys.mjs) `extension-add`; [baseline.json](https://github.com/adeelahmad/lense/blob/main/ci/clicks/baseline.json) `extension-add` ≤ 3 clicks | | Remote MCP servers connect by address | [test_mcp_servers.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_mcp_servers.py) `test_an_admin_adds_a_server_and_the_assistant_uses_it` | | MCP servers that run as a program (`npx`, `uvx`) run in a sandboxed container of their own | [test_mcp_servers.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_mcp_servers.py) `test_a_server_that_runs_as_a_program_runs_in_the_runner`; [mcp-runner.yml](https://github.com/adeelahmad/lense/blob/main/.github/workflows/mcp-runner.yml) `Runs an npm server and a PyPI server` | +| Ready-made servers: the browser (a headless Chromium in a sandbox of its own, one session for everyone) and GitHub added in a click; the MCP runner, the browser and monitoring started and stopped from the web app through the upgrade agent, or the line to run shown without one | [test_services.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_services.py) `test_each_profile_is_turned_on_and_off_on_its_own`, `test_no_agent_shows_the_line_to_run`, `test_only_admins`; [test_mcp_servers.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_mcp_servers.py) `test_the_browser_preset_keeps_one_session`; [mcp-server-ui.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/mcp-server-ui.test.tsx) `adds the browser with one click once its container runs`, `turns the browser's container on first, when it isn't running`, `sets GitHub up with the token typed in its place` | +| Settings › AI assistant › MCP servers lists every server with its tools and the containers' switches; agents list and add servers over MCP | [test_mcp_servers.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_mcp_servers.py) `test_agents_list_and_add_servers`; [mcp-server-ui.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/mcp-server-ui.test.tsx) `lists each server with its tools, and the containers' switches` | | An MCP server added by form or a pasted config, its tokens sealed and each tool switched on or off | [test_mcp_servers.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_mcp_servers.py) `test_a_pasted_config_reads_as_servers_to_add`, `test_its_secrets_are_sealed_and_never_shown`, `test_each_tool_is_switched_and_says_whether_it_asks`; [mcp-server-ui.test.tsx](https://github.com/adeelahmad/lense/blob/main/nextjs-frontend/__tests__/mcp-server-ui.test.tsx) `adding an MCP server` | | Skills and plugins from marketplaces in the open plugin format, a repository or an archive | [test_marketplaces.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_marketplaces.py) `test_a_marketplace_an_admin_adds`, `test_imported_from_a_link_or_a_file` | @@ -128,6 +137,7 @@ request, to another check that proves the same thing; loosening a requirement or | Requirement | Checks | |---|---| | A page, a selection or a part you pick becomes Markdown, looked over and sent to a namespace | [clip.test.js](https://github.com/adeelahmad/lense/blob/main/extensions/browser/test/clip.test.js) `a full page becomes its article, with front matter`, `the selection`, `a picked element, with the selection template`; [clipper-edge.yml](https://github.com/adeelahmad/lense/blob/main/.github/workflows/clipper-edge.yml) `Smoke test in Edge` | +| The clipper signs in to Lens, or takes your API token or an import webhook's, and says why a token is refused | [lens.test.js](https://github.com/adeelahmad/lense/blob/main/extensions/browser/test/lens.test.js) `with the person's own token, the clip names its namespace`, `errors say what to do, by the kind of token`, `the popup offers each namespace a signed-in Lens can take, the picked one chosen`; [test_import_hooks.py](https://github.com/adeelahmad/lense/blob/main/fastapi_backend/tests/api/test_import_hooks.py) `test_people_push_with_their_own_token`, `test_the_clipper_signed_in_as_the_person` | | Built for Chrome, Edge, Firefox and Safari | [browser-extension.yml](https://github.com/adeelahmad/lense/blob/main/.github/workflows/browser-extension.yml) `Test and build the web clipper`, `Build every target`; [browser-extension-firefox.yml](https://github.com/adeelahmad/lense/blob/main/.github/workflows/browser-extension-firefox.yml) `Lint and package the Firefox clipper`; [safari-clipper.yml](https://github.com/adeelahmad/lense/blob/main/.github/workflows/safari-clipper.yml) `Build the Safari clipper`; [clipper-edge.yml](https://github.com/adeelahmad/lense/blob/main/.github/workflows/clipper-edge.yml) `Clip a page in Edge` | | New releases reach installed copies through a store or a self-hosted update file | [release.test.js](https://github.com/adeelahmad/lense/blob/main/extensions/browser/test/release.test.js) `update manifests` | | In Chrome and Edge, the side panel is a chat with the assistant | [assistant.test.js](https://github.com/adeelahmad/lense/blob/main/extensions/browser/test/assistant.test.js); [clipper-edge.yml](https://github.com/adeelahmad/lense/blob/main/.github/workflows/clipper-edge.yml) `Smoke test in Edge` |