~ knotless Search/
↑↓ move↵ open⇧↵ all results

chadtmiller.com/hud

A remote MCP server that shows atproto records as interactive UI inside MCP Apps hosts

0
0
148 lines · 8.3 KB Raw History
{
  "lexicon": 1,
  "id": "dev.knotless.getFeed",
  "description": "What happened on the public repositories an appview has indexed, newest first.",
  "defs": {
    "main": {
      "type": "query",
      "description": "What happened on the public repositories an appview has indexed, newest first: repositories created and forked, refs pushed and deleted, pulls and issues opened, discussed and moved between states, and repositories starred. With filter `following`, what the account asking and those it follows did, and anything done on its repositories and those it starred; without, the same for anyone, but no stars. Without `actor`, what a repository's bots said or pushed on it is left out: the runners and triagers its record names, but its owner and collaborators. A pull a runner merged landing the merge queue is shown as merged by whoever queued it.",
      "parameters": {
        "type": "params",
        "properties": {
          "limit": { "type": "integer", "minimum": 1, "maximum": 100, "default": 40 },
          "cursor": { "type": "string", "description": "Where the page starts: a previous page's cursor." },
          "actor": { "type": "string", "format": "did", "description": "Only what this account did: the repositories it created, the refs it pushed, the pulls, issues, comments and changes of state it wrote, and the repositories it starred." },
          "filter": { "type": "string", "knownValues": ["everyone", "following"], "default": "everyone", "description": "Whose doings: `everyone`'s, or with `following`, those of the account asking and whom it follows, which needs an account to ask." },
          "kind": { "type": "string", "knownValues": ["pushes", "pulls", "issues", "comments", "stars", "repos"], "description": "Only what is of this kind: refs pushed and deleted, pulls or issues opened and moved between states, comments, repositories starred, or repositories created and forked. A kind the appview does not know answers nothing." }
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "type": "object",
          "required": ["events"],
          "properties": {
            "events": { "type": "array", "items": { "type": "ref", "ref": "#eventView" } },
            "cursor": { "type": "string", "description": "Where the next page starts, when there may be one." }
          }
        }
      }
    },
    "eventView": {
      "type": "object",
      "description": "Something an account did to a repository.",
      "required": ["createdAt", "actor", "repo", "action"],
      "properties": {
        "createdAt": { "type": "string", "format": "datetime", "description": "When the record saying so was made." },
        "actor": { "type": "ref", "ref": "#actorView" },
        "repo": { "type": "ref", "ref": "#repoView" },
        "action": {
          "type": "union",
          "refs": ["#created", "#pushed", "#deleted", "#opened", "#commented", "#changed", "#starred"]
        }
      }
    },
    "actorView": {
      "type": "object",
      "required": ["did", "handle"],
      "properties": {
        "did": { "type": "string", "format": "did" },
        "handle": { "type": "string", "description": "The handle the account claims, when it resolves back to it; else the DID." },
        "avatar": { "type": "string", "format": "uri", "description": "The account's picture, as in dev.knotless.getProfile#profileView." },
        "bot": { "type": "boolean", "description": "Whether its knotless profile says it is a bot, as in dev.knotless.defs#actorView." }
      }
    },
    "repoView": {
      "type": "object",
      "description": "A repository, under the name it has now.",
      "required": ["did", "handle", "name"],
      "properties": {
        "did": { "type": "string", "format": "did", "description": "The repository's owner." },
        "handle": { "type": "string", "description": "The owner's handle, as in #actorView." },
        "name": { "type": "string", "maxLength": 100 }
      }
    },
    "created": {
      "type": "object",
      "description": "A repository created, or forked from another.",
      "properties": {
        "description": { "type": "string", "maxGraphemes": 300, "maxLength": 3000 },
        "forkOf": { "type": "ref", "ref": "#repoView" }
      }
    },
    "pushed": {
      "type": "object",
      "description": "A ref created or moved, or moved again and again by one account, each move within an hour of the last, as one. A new ref brings what the repository's default branch did not reach just before, nor its fork source's; a fork's copies of its source's refs are not events.",
      "required": ["ref", "created", "count", "new", "commits"],
      "properties": {
        "ref": { "type": "string", "description": "The full ref name, such as refs/heads/main." },
        "created": { "type": "boolean", "description": "Whether the ref was new." },
        "to": {
          "type": "string",
          "description": "The commit the ref was left at, in hex: what the push brought, which a page can link to after the ref is gone."
        },
        "forced": { "type": "boolean", "description": "Whether the ref moved to where it no longer reaches some of what it did, as a rebase or a rewrite does. Absent when not." },
        "count": { "type": "integer", "minimum": 0, "maximum": 100, "description": "Commits the push brought; 100 means at least that many. A forced push's leave out those it brought again: the same author, at the same time, with the same message as a commit it left behind." },
        "new": { "type": "integer", "minimum": 0, "maximum": 100, "description": "Of those, the commits no other ref of the repository had before, and no event before it on the same page lists; the rest are only counted." },
        "commits": { "type": "array", "maxLength": 10, "items": { "type": "ref", "ref": "#commitView" }, "description": "The newest of the new ones, newest first." }
      }
    },
    "deleted": {
      "type": "object",
      "description": "A ref deleted.",
      "required": ["ref"],
      "properties": {
        "ref": { "type": "string" }
      }
    },
    "opened": {
      "type": "object",
      "description": "A pull or an issue opened.",
      "required": ["subject", "title"],
      "properties": {
        "subject": { "type": "string", "format": "at-uri", "description": "The dev.knotless.pull or dev.knotless.issue record." },
        "title": { "type": "string" },
        "subjectState": { "type": "string", "knownValues": ["open", "closed", "merged"], "description": "Where the subject stands now, whoever moved it there." }
      }
    },
    "commented": {
      "type": "object",
      "description": "A comment or review on a pull or an issue.",
      "required": ["subject", "title", "text"],
      "properties": {
        "subject": { "type": "string", "format": "at-uri" },
        "title": { "type": "string", "description": "The subject's title." },
        "text": { "type": "string", "description": "The comment, as Markdown." },
        "verdict": { "type": "string", "knownValues": ["approve", "changes"] },
        "subjectState": { "type": "string", "knownValues": ["open", "closed", "merged"], "description": "Where the subject stands now, whoever moved it there." }
      }
    },
    "changed": {
      "type": "object",
      "description": "A pull or an issue moved to another state.",
      "required": ["subject", "title", "state"],
      "properties": {
        "subject": { "type": "string", "format": "at-uri" },
        "title": { "type": "string", "description": "The subject's title." },
        "state": { "type": "string", "knownValues": ["open", "closed", "merged"] },
        "subjectState": { "type": "string", "knownValues": ["open", "closed", "merged"], "description": "Where the subject stands now, whoever moved it there." }
      }
    },
    "starred": {
      "type": "object",
      "description": "The event's repository starred.",
      "properties": {
        "subject": { "type": "string", "format": "at-uri", "description": "The dev.knotless.repo record starred." }
      }
    },
    "commitView": {
      "type": "object",
      "required": ["sha", "message"],
      "properties": {
        "sha": { "type": "string" },
        "message": { "type": "string" },
        "merge": { "type": "boolean", "description": "Whether the commit has more than one parent. Absent when not." }
      }
    }
  }
}