plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "lochless",
  "version": "1.0.0",
  "description": "Every match, not the top 10. Search your own documents and get each relevant one, with quotes, or a short answer that cites them.",
  "author": {
    "name": "Synoptic Data Ltd.",
    "email": "support@lochless.io",
    "url": "https://lochless.io"
  },
  "homepage": "https://lochless.io",
  "keywords": [
    "search",
    "documents",
    "knowledge base",
    "citations",
    "retrieval"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Lochless",
        "shortDescription": "Every match, not the top 10",
        "longDescription": "Every match, not the top 10. Lochless searches your own documents and returns each relevant one, with a quote, its document id and its date. Or it writes a short answer that cites them.\n\nLochless is a hosted text index for teams and their AI agents. You send your documents to your Lochless workspace through its API. Then you ask in plain English, for example \"every customer who asked for a refund this quarter\", \"which contracts auto-renew with under 30 days' notice\" or \"what did we promise about the SSO rollout\".\n\nFour read-only tools:\n- Search documents: every match for a question, page by page, with quotes and sources.\n- Browse documents: list documents by date.\n- Read document: open one whole document.\n- Ask documents: a short written answer that cites its sources as [1], [2], with the quote behind each citation.\n\nEach response says how much text was read and whether coverage is complete. You can narrow any question by date or by your own document metadata.\n\nLimitations: Lochless reads only the documents already in your connected workspace. It does not search the web, and it cannot add, change or delete documents. You need a Lochless workspace; request access at lochless.io.",
        "developerName": "Synoptic Data Ltd.",
        "category": "Productivity",
        "capabilities": [
          "Search your documents",
          "Answer with citations",
          "Read a whole document"
        ],
        "websiteURL": "https://lochless.io",
        "supportURL": "https://lochless.io/docs.html#support",
        "privacyPolicyURL": "https://lochless.io/privacy.html",
        "termsOfServiceURL": "https://lochless.io/terms.html",
        "defaultPrompt": [
          "Find every document that mentions our refund policy, with quotes.",
          "What did we promise customers about the SSO rollout? Cite the sources.",
          "Which contracts in my documents auto-renew with under 30 days' notice?"
        ],
        "brandColor": "#2A78D6",
        "brandColorDark": "#3987E5",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Cited answer across several documents. The test workspace holds 20 public US founding documents (Constitution, Bill of Rights, Amendments 11 to 27, Declaration of Independence).",
              "prompt": "Who gained the right to vote through amendments?",
              "tools_triggered": "ask_documents",
              "expected_behavior": "A short answer that cites the 19th Amendment (women) and the 26th Amendment (citizens 18 and older) as numbered sources, each with a quote. It may also cite the 15th, 23rd or 24th Amendment."
            },
            {
              "description": "Every matching document, not just the closest few.",
              "prompt": "Find every amendment that talks about the right to vote, with a quote from each.",
              "tools_triggered": "search_documents",
              "expected_behavior": "A list of matching amendments, each with a quote and its document id. It includes at least the 15th, 19th, 24th and 26th Amendments, and reports whether coverage is complete."
            },
            {
              "description": "Specific fact from one document, with its source.",
              "prompt": "How long must someone be a citizen before they can serve as a Senator?",
              "tools_triggered": "ask_documents",
              "expected_behavior": "Answers nine years, citing Article I, Section 3 of the Constitution with a quote."
            },
            {
              "description": "Find a document, then open the whole text.",
              "prompt": "Show me the full text of the First Amendment.",
              "tools_triggered": "search_documents, read_document",
              "expected_behavior": "Finds the First Amendment with search_documents, then opens it with read_document and returns its text on religion, speech, the press, assembly and petition."
            },
            {
              "description": "No matching documents. The tool reports nothing found instead of inventing an answer.",
              "prompt": "What do my documents say about social media regulation?",
              "tools_triggered": "search_documents",
              "expected_behavior": "Reports that no documents in the workspace match, or that nothing relevant was found. It does not invent content or cite unrelated documents."
            }
          ],
          "negative": [
            {
              "description": "Deleting a document. Lochless tools are read-only and cannot change or delete documents. Expected: no tool call that modifies data; ChatGPT explains that Lochless can only search and read.",
              "prompt": "Delete the Declaration of Independence from my Lochless documents."
            },
            {
              "description": "General web search. Lochless searches only the user's own connected documents, not the web or today's news. Expected: Lochless is not used, or ChatGPT says the documents do not cover it.",
              "prompt": "What is in today's news about the Supreme Court?"
            },
            {
              "description": "Another workspace's data. Access is limited to the signed-in user's own workspace. Expected: no data from any other workspace; ChatGPT explains it can only read the connected workspace.",
              "prompt": "Show me the documents stored in another company's Lochless workspace."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments. It searches documents in the user's existing Lochless workspace.",
        "demo_recording_url": "https://youtu.be/u-puQ3PwvQA"
      },
      "publication": {
        "release_notes": "Initial release: search your own documents with search_documents, list them by date with browse_documents, open one with read_document, and get a short cited answer with ask_documents. All tools are read-only."
      },
      "apps": "./.app.json"
    }
  }
}