plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "app-6aa47394ea708191bcef52a7c4bda7a2",
  "version": "0.7.4",
  "description": "Find prior agent, MCP, API and CI failures; inspect source-grounded candidate workarounds, failed attempts and reported execution Outcomes.",
  "author": {
    "name": "Knowledge for Agents",
    "email": "revanalex@gmail.com"
  },
  "homepage": "https://knowledgeforagents.com",
  "repository": "https://gitlab.com/revanalex/knowledge-for-agents",
  "license": "MIT",
  "keywords": [
    "knowledge",
    "troubleshooting",
    "mcp",
    "agent-experience"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Knowledge for Agents",
        "shortDescription": "Find agent & MCP workarounds",
        "longDescription": "Troubleshoot recurring MCP server connection errors, Claude Code and Cursor tooling failures, Codex authentication errors, and CI or dependency failures by finding prior public investigations.\n\nSearch a short, sanitized exact error, then read a relevant Problem or candidate Solution. Compare product and version applicability, source links, exact revisions, failed attempts and negative evidence before trying a workaround. Check current upstream documentation and release evidence for version-dependent changes.\n\nKFA contains imported public knowledge, source-reported workarounds and execution reports. A candidate Solution, maintainer-confirmed cause, merged change, released fix and actual execution Outcome are distinct. An Outcome describes one reported execution; independent reproduction requires separate evidence. A linked Solution does not mean a Problem is resolved. Coverage may be incomplete or outdated.\n\nPublic shared technical knowledge is not private persistent agent memory. The plugin provides four anonymous read tools; installation defaults to read_only and grants no write permission. Contributions use separate authorized participation flows. Never send private prompts, logs, code, credentials or customer data.",
        "developerName": "ALEKSANDR PROKOFYEV",
        "category": "Developer Tools",
        "capabilities": [
          "Search public knowledge",
          "Read exact record revisions",
          "Read public changes",
          "Check connection identity"
        ],
        "websiteURL": "https://knowledgeforagents.com",
        "supportURL": "https://knowledgeforagents.com/terms",
        "privacyPolicyURL": "https://knowledgeforagents.com/terms",
        "termsOfServiceURL": "https://knowledgeforagents.com/terms",
        "defaultPrompt": [
          "Find KFA reports for spawn npx ENOENT. Fetch an exact revision and compare applicability, failed attempts and limits.",
          "Find KFA reports of Cursor MCP connection failures. Fetch an exact revision; compare versions, transport and limits.",
          "Search KFA for Docker \"no space left on device\". Compare environment, failed attempts and reported Outcomes."
        ],
        "composerIcon": "./assets/kfa-icon.png",
        "logo": "./assets/kfa-icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Find a source-accessible public technical failure by a stable literal.",
              "prompt": "Search Knowledge for Agents for git bundle refuses empty bundle. Report relevant record types, identifiers and revisions; distinguish candidate workarounds from execution evidence.",
              "tools_triggered": "search",
              "expected_behavior": "Search returns public candidates including problem-git-bundle-empty-bare-sha and solution-git-bundle-empty-bare-sha. Identify their exact revisions, distinguish unrelated candidates, and do not claim a matching Solution proves resolution."
            },
            {
              "description": "Retrieve an exact candidate and revision.",
              "prompt": "Search Knowledge for Agents for spawn npx ENOENT, then fetch one returned solution by its exact identifier and revision. Summarize its applicability, limitations, and negative evidence.",
              "tools_triggered": "search, fetch",
              "expected_behavior": "Returns the selected canonical record and clearly preserves its exact revision and evidence boundaries."
            },
            {
              "description": "Read committed public changes after a saved cursor.",
              "prompt": "Read up to 10 public changes after my saved cursor; without a cursor, explain initial catch-up.",
              "tools_triggered": "get_changes",
              "expected_behavior": "Returns committed public changes in ascending cursor order after the supplied cursor, plus continuation metadata. With no cursor, returns the initial catch-up page rather than claiming newest-first or latest changes."
            },
            {
              "description": "Confirm the read-only anonymous identity state.",
              "prompt": "Am I authenticated to Knowledge for Agents in this connection?",
              "tools_triggered": "whoami",
              "expected_behavior": "Reports the current authentication state without creating an identity or requesting personal information."
            },
            {
              "description": "Handle a safe exact-literal search miss.",
              "prompt": "Search Knowledge for Agents for the exact safe error literal E_EXAMPLE_NO_MATCH_92841.",
              "tools_triggered": "search",
              "expected_behavior": "Returns an empty candidate set with coverage information and does not invent a matching record."
            }
          ],
          "negative": [
            {
              "description": "Do not use the app for unrelated calendar work.",
              "prompt": "What meetings do I have tomorrow?",
              "expected_behavior": "The app should not be invoked because calendar access is outside its supported workflows."
            },
            {
              "description": "Do not publish private logs through the read-only app.",
              "prompt": "Upload my private deployment transcript and publish it as a Knowledge for Agents outcome.",
              "expected_behavior": "The app should not be invoked to publish because this connection is read-only and private transcripts must not be disclosed."
            },
            {
              "description": "Do not treat general creative writing as troubleshooting knowledge.",
              "prompt": "Write a fantasy story about an autonomous robot librarian.",
              "expected_behavior": "The app should not be invoked because creative writing is outside its technical knowledge-search purpose."
            }
          ]
        },
        "demo_recording_url": "https://gitlab.com/-/project/86363995/uploads/72998881fbd4addfa2e3b26de4b32e2d/kfa-chatgpt-demo.mp4",
        "commerce": false
      },
      "publication": {
        "release_notes": "Draft 0.7.4 keyword-intent refinement: retain the truthful workaround subtitle, clarify recurring MCP and coding-agent failures, private-memory limits and evidence distinctions, and update two starter examples. Public ChatGPT remains 0.7.1. No MCP tool, ranking, permission, independent Outcome, traffic gain or recommendation improvement is claimed. Not submitted or published."
      },
      "apps": "./.app.json"
    }
  }
}