@variance-authority/mcp 0.1.0

package/dist/tools.js

@@ -0,0 +1,127 @@
+import { adjudicate } from './tools/adjudicate.js';
+import { changelog } from './tools/changelog.js';
+import { changes } from './tools/changes.js';
+import { composition } from './tools/composition.js';
+import { describe } from './tools/describe.js';
+import { diff, diffState } from './tools/diff.js';
+import { explain } from './tools/explain-verdict.js';
+import { findings } from './tools/findings.js';
+import { summarize } from './tools/summary.js';
+import { attention } from './tools/attention.js';
+import { observability, testingSurface } from './tools/observability.js';
+import { presentations } from './tools/presentations.js';
+import { scenarios } from './tools/scenarios.js';
+import { sourceTests } from './tools/source-tests.js';
+import { runSignals } from './tools/run-signals.js';
+import { testSignals } from './tools/test-signals.js';
+import { NO_ARGS, stringArg } from './tools/tool.js';
+import { trace } from './tools/trace-component.js';
+import { variations } from './tools/variations.js';
+// The tool-authoring contract, not an implementation detail of this set. A
+// server over another subject writes tools against the same interface, and the
+// first thing any tool does with a model's argument is refuse it or narrow it.
+export { NO_ARGS, stringArg };
+export { notObservedSentence } from './tools/subject.js';
+export { diffState };
+/** The source-to-named-test tool set for an MCP server over an execution index. */
+export const SOURCE_TEST_TOOLS = [sourceTests, diff];
+/** Look up one source-test tool without widening it to the visual-report subject. */
+export function sourceTestToolByName(name) {
+    return SOURCE_TEST_TOOLS.find((tool) => tool.name === name);
+}
+/**
+ * The tool set for a watcher attached to a suite that is still running.
+ *
+ * A third subject, and the first one that is not a thing somebody produced. The
+ * report tools answer about a run that finished and the source-test tools answer
+ * about an index that was written; these answer about a run *in flight*, held in
+ * the memory of the process answering, and gone when it exits.
+ *
+ * The listing comes first for the same reason `variance_summary` does: the other
+ * two take an argument it printed. `variance_diff` is last here rather than
+ * second, because on a live subject it is not the session question but the
+ * *progress* question — what the suite did between two asks — and that is only
+ * worth asking once a reader knows what they are watching.
+ */
+export const VANTAGE_TOOLS = [
+    runSignals,
+    testSignals,
+    diff,
+];
+/** Look up one live-run tool without widening it to the visual-report subject. */
+export function vantageToolByName(name) {
+    return VANTAGE_TOOLS.find((tool) => tool.name === name);
+}
+export const TOOLS = [
+    summarize,
+    diff,
+    changes,
+    adjudicate,
+    composition,
+    variations,
+    changelog,
+    describe,
+    findings,
+    trace,
+    explain,
+];
+export function toolByName(name) {
+    return TOOLS.find((tool) => tool.name === name);
+}
+/** Full presentation graphs supplied by the caller, independent of report projections. */
+export const PRESENTATION_TOOLS = [
+    presentations,
+    diff,
+];
+export function presentationToolByName(name) {
+    return PRESENTATION_TOOLS.find((tool) => tool.name === name);
+}
+/** Test attention captured synchronously while DOM nodes still have attribution. */
+export const EYES_TOOLS = [attention, diff];
+export function eyesToolByName(name) {
+    return EYES_TOOLS.find((tool) => tool.name === name);
+}
+/** Retained scenario executions, including witnessed Arrange state and Act outcomes. */
+export const SCENARIO_TOOLS = [scenarios, diff];
+export function scenarioToolByName(name) {
+    return SCENARIO_TOOLS.find((tool) => tool.name === name);
+}
+/**
+ * Every independently supplied observability domain behind one MCP connection.
+ *
+ * Native tools are lifted without changing their answers. A missing field is a
+ * tool error, not an empty subject, and previous invocation state is projected
+ * through the same field before a native diff sees it.
+ */
+export const OBSERVABILITY_TOOLS = [
+    observability,
+    ...TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) => lift(tool, 'visual/report', (subject) => subject.report)),
+    ...PRESENTATION_TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) => lift(tool, 'presentation readings', (subject) => subject.presentations)),
+    ...SOURCE_TEST_TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) => lift(tool, 'runtime journey', (subject) => subject.execution)),
+    ...VANTAGE_TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) => lift(tool, 'live journey/events', (subject) => subject.vantage)),
+    ...EYES_TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) => lift(tool, 'Eyes attention', (subject) => subject.eyes)),
+    testingSurface,
+    ...SCENARIO_TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) => lift(tool, 'scenario AAA', (subject) => subject.scenarios)),
+    diff,
+];
+export function observabilityToolByName(name) {
+    return OBSERVABILITY_TOOLS.find((tool) => tool.name === name);
+}
+function lift(tool, domain, read) {
+    return {
+        name: tool.name,
+        description: tool.description,
+        inputSchema: tool.inputSchema,
+        run(subject, input, invocation) {
+            const evidence = read(subject);
+            if (evidence === undefined) {
+                throw new Error(`${domain} evidence is unavailable to this MCP connection`);
+            }
+            const previous = invocation?.previous === undefined
+                ? undefined
+                : read(invocation.previous);
+            return tool.run(evidence, input, previous === undefined ? undefined : { previous });
+        },
+    };
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../src/tools.ts"],"names":[],"mappings":"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","sourcesContent":["import type { EyesArchive } from '@variance-authority/eyes';\nimport type { PresentationReport } from '@variance-authority/presentation';\nimport type { ExecutionIndex } from '@variance-authority/sense/test-selection';\nimport type { VantageState } from '@variance-authority/vantage';\nimport type { ObservabilitySubject } from './observability-subject.js';\nimport { adjudicate } from './tools/adjudicate.js';\nimport { changelog } from './tools/changelog.js';\nimport { changes } from './tools/changes.js';\nimport { composition } from './tools/composition.js';\nimport { describe } from './tools/describe.js';\nimport { diff, diffState, type StateDifference } from './tools/diff.js';\nimport { explain } from './tools/explain-verdict.js';\nimport { findings } from './tools/findings.js';\nimport { summarize } from './tools/summary.js';\nimport { attention } from './tools/attention.js';\nimport { observability, testingSurface } from './tools/observability.js';\nimport { presentations, type PresentationEvidence } from './tools/presentations.js';\nimport { scenarios, type ScenarioEvidence } from './tools/scenarios.js';\nimport { sourceTests } from './tools/source-tests.js';\nimport { runSignals } from './tools/run-signals.js';\nimport { testSignals } from './tools/test-signals.js';\nimport { NO_ARGS, stringArg, type Tool } from './tools/tool.js';\nimport { trace } from './tools/trace-component.js';\nimport { variations } from './tools/variations.js';\n\n/**\n * The tools, as pure functions over a run report.\n *\n * Separated from the transport deliberately. A tool implementation tangled into\n * a JSON-RPC handler can only be exercised by speaking JSON-RPC at it, and the\n * interesting question — *does this answer help an agent fix the thing?* — then\n * becomes the hardest thing in the package to ask.\n *\n * Every answer is text, and the shape of that text is the product. An agent does\n * not benefit from a JSON blob it has to interpret; it benefits from the same\n * sentence a person would want, with a file path on the end. So these read like\n * the report does: cause first, collateral counted, and a path an editor opens.\n *\n * `variance_adjudicate` is the one tool that takes evidence *in*. It follows\n * `summary` and `changes` because it needs nothing they printed and everything\n * they cannot supply: an agent's own account of what it was doing. The other report tools\n * answer *what changed*; this one answers *what changed against what you claimed*, and\n * its third arm — declared, and did not happen — is the only thing here that can\n * catch an edit which never landed. An agent that has just edited something\n * should call it before `describe`, and an agent reviewing somebody else's run\n * has nothing to declare and should skip it.\n *\n * One tool per module under `./tools/`, and this file is the list. Each answer is\n * a paragraph somebody argued about, and the arguments do not compose — the\n * reason the summary refuses to say \"nothing to review\" has nothing to do with\n * the reason findings are grouped by rule — so they are read, and edited, one at\n * a time. What stays here is the only thing that is genuinely about the set:\n * the order, which is the order `tools/list` announces them in and therefore the\n * order an agent meets them in. `variance_summary` is first because every report\n * tool takes an argument it printed. `variance_diff` sits beside it as the session\n * question, and `variance_changes` follows because it\n * is the one that decides how many of the rest get called: an agent that walks\n * forty changed subjects one at a time spends forty calls learning what one call\n * says, which is *three things happened and one of them explains thirty-one*.\n *\n * `variance_composition` follows `adjudicate`, and the boundary it sits on is\n * the one worth seeing: the first seven answer about the *suite* and the last four narrow to a\n * subject. It goes after `changes` rather than before because the two reshape\n * the same run along different axes and only one of them is about this run's\n * diff — `changes` says which decisions there are, and this says which component\n * and which caller is behind one, including when the answer is *nothing in this\n * run*.\n *\n * `variance_variations` follows it, on the same axis and one step further out. Both\n * compare this run to itself; `composition` compares subjects that were never\n * meant to differ, and this compares the ones that were. It is the only tool here\n * whose answer is not, in any reading, a finding — which is why it is neither\n * earlier (an agent triaging a visual diff would spend a call learning that a dark story\n * is dark) nor omitted (when a change *is* to a flagged component, what the flag\n * does is the first thing the reviewer does not know).\n *\n * `variance_changelog` closes the suite-level group because it is the only tool\n * here that is not about the run. The other report tools describe what a run observed;\n * this one describes what *accepting* it would write down, and that answer is\n * the last thing an agent needs before it proposes a command. Its position is\n * also a claim about when it stops being useful: after acceptance there is\n * nothing to preview, because the record exists and `git log` has it.\n *\n * It is the second tool whose answer changes with the agent's own input, and\n * unlike `adjudicate` the input is not evidence — it is the selection, the same\n * one `accept` takes. That is why it must not be earlier: an agent that has not\n * yet read `changes` has no shape to ask about, and would be told what `--all`\n * records before knowing whether `--all` is what it wants.\n */\n\nexport type { Served, Tool, ToolInvocation } from './tools/tool.js';\nexport type { StateDifference };\n\n// The tool-authoring contract, not an implementation detail of this set. A\n// server over another subject writes tools against the same interface, and the\n// first thing any tool does with a model's argument is refuse it or narrow it.\nexport { NO_ARGS, stringArg };\nexport { notObservedSentence } from './tools/subject.js';\nexport { diffState };\n\n/** The source-to-named-test tool set for an MCP server over an execution index. */\nexport const SOURCE_TEST_TOOLS = [sourceTests, diff as Tool<ExecutionIndex>] as const;\n\n/** Look up one source-test tool without widening it to the visual-report subject. */\nexport function sourceTestToolByName(name: string): Tool<ExecutionIndex> | undefined {\n  return SOURCE_TEST_TOOLS.find((tool) => tool.name === name);\n}\n\n/**\n * The tool set for a watcher attached to a suite that is still running.\n *\n * A third subject, and the first one that is not a thing somebody produced. The\n * report tools answer about a run that finished and the source-test tools answer\n * about an index that was written; these answer about a run *in flight*, held in\n * the memory of the process answering, and gone when it exits.\n *\n * The listing comes first for the same reason `variance_summary` does: the other\n * two take an argument it printed. `variance_diff` is last here rather than\n * second, because on a live subject it is not the session question but the\n * *progress* question — what the suite did between two asks — and that is only\n * worth asking once a reader knows what they are watching.\n */\nexport const VANTAGE_TOOLS = [\n  runSignals,\n  testSignals,\n  diff as Tool<VantageState>,\n] as const;\n\n/** Look up one live-run tool without widening it to the visual-report subject. */\nexport function vantageToolByName(name: string): Tool<VantageState> | undefined {\n  return VANTAGE_TOOLS.find((tool) => tool.name === name);\n}\n\nexport const TOOLS: readonly Tool[] = [\n  summarize,\n  diff,\n  changes,\n  adjudicate,\n  composition,\n  variations,\n  changelog,\n  describe,\n  findings,\n  trace,\n  explain,\n];\n\nexport function toolByName(name: string): Tool | undefined {\n  return TOOLS.find((tool) => tool.name === name);\n}\n\n/** Full presentation graphs supplied by the caller, independent of report projections. */\nexport const PRESENTATION_TOOLS = [\n  presentations,\n  diff as Tool<PresentationEvidence>,\n] as const;\n\nexport function presentationToolByName(name: string): Tool<readonly PresentationReport[]> | undefined {\n  return PRESENTATION_TOOLS.find((tool) => tool.name === name);\n}\n\n/** Test attention captured synchronously while DOM nodes still have attribution. */\nexport const EYES_TOOLS = [attention, diff as Tool<EyesArchive>] as const;\n\nexport function eyesToolByName(name: string): Tool<EyesArchive> | undefined {\n  return EYES_TOOLS.find((tool) => tool.name === name);\n}\n\n/** Retained scenario executions, including witnessed Arrange state and Act outcomes. */\nexport const SCENARIO_TOOLS = [scenarios, diff as Tool<ScenarioEvidence>] as const;\n\nexport function scenarioToolByName(name: string): Tool<ScenarioEvidence> | undefined {\n  return SCENARIO_TOOLS.find((tool) => tool.name === name);\n}\n\n/**\n * Every independently supplied observability domain behind one MCP connection.\n *\n * Native tools are lifted without changing their answers. A missing field is a\n * tool error, not an empty subject, and previous invocation state is projected\n * through the same field before a native diff sees it.\n */\nexport const OBSERVABILITY_TOOLS: readonly Tool<ObservabilitySubject>[] = [\n  observability,\n  ...TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) =>\n    lift(tool, 'visual/report', (subject) => subject.report)),\n  ...PRESENTATION_TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) =>\n    lift(tool, 'presentation readings', (subject) => subject.presentations)),\n  ...SOURCE_TEST_TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) =>\n    lift(tool, 'runtime journey', (subject) => subject.execution)),\n  ...VANTAGE_TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) =>\n    lift(tool, 'live journey/events', (subject) => subject.vantage)),\n  ...EYES_TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) =>\n    lift(tool, 'Eyes attention', (subject) => subject.eyes)),\n  testingSurface,\n  ...SCENARIO_TOOLS.filter((tool) => tool.name !== 'variance_diff').map((tool) =>\n    lift(tool, 'scenario AAA', (subject) => subject.scenarios)),\n  diff as Tool<ObservabilitySubject>,\n];\n\nexport function observabilityToolByName(name: string): Tool<ObservabilitySubject> | undefined {\n  return OBSERVABILITY_TOOLS.find((tool) => tool.name === name);\n}\n\nfunction lift<Subject>(\n  tool: Tool<Subject>,\n  domain: string,\n  read: (subject: ObservabilitySubject) => Subject | undefined,\n): Tool<ObservabilitySubject> {\n  return {\n    name: tool.name,\n    description: tool.description,\n    inputSchema: tool.inputSchema,\n    run(subject, input, invocation) {\n      const evidence = read(subject);\n      if (evidence === undefined) {\n        throw new Error(`${domain} evidence is unavailable to this MCP connection`);\n      }\n      const previous = invocation?.previous === undefined\n        ? undefined\n        : read(invocation.previous);\n      return tool.run(evidence, input, previous === undefined ? undefined : { previous });\n    },\n  };\n}\n"]}

package/mark.svg

@@ -0,0 +1,30 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 320" role="img" aria-labelledby="title desc">
+  <title id="title">Variance Authority mark</title>
+  <desc id="desc">Folded ribbon VA mark in charcoal and orange.</desc>
+
+  <defs>
+    <style>
+      .ribbon-dark {
+        fill: #24282A;
+      }
+
+      @media (prefers-color-scheme: dark) {
+        .ribbon-dark {
+          fill: #F3F4F6;
+        }
+      }
+    </style>
+  </defs>
+
+  <!-- Left descending ribbon -->
+  <path class="ribbon-dark" d="M64 54H159L256 266H160Z"/>
+
+  <!-- Right descending ribbon -->
+  <path class="ribbon-dark" d="M331 28H419L494 266H397Z"/>
+
+  <!-- Chosen / variant ribbon -->
+  <path d="M256 266L202 152L283 28H376L301 165Z" fill="#FF4A19"/>
+
+  <!-- Fold shadow -->
+  <path d="M202 152L256 266L301 165L264 103Z" fill="#D83A13" opacity="0.72"/>
+</svg>

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@variance-authority/mcp",
+  "version": "0.1.0",
+  "description": "Expose independently supplied observability evidence to an MCP client.",
+  "keywords": [
+    "variance-authority",
+    "visual-regression",
+    "mcp",
+    "model-context-protocol",
+    "agent",
+    "ai"
+  ],
+  "license": "MIT",
+  "author": "Machine Garden",
+  "homepage": "https://variance-authority.dev#packages",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Variance-Authority/variance-authority.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": "https://github.com/Variance-Authority/variance-authority/issues",
+  "engines": {
+    "node": ">=22"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./tools": {
+      "types": "./dist/tools.d.ts",
+      "default": "./dist/tools.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "default": "./dist/protocol.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "variance-authority-mcp": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.d.ts.map",
+    "mark.svg"
+  ],
+  "scripts": {
+    "build": "tsc --build"
+  },
+  "dependencies": {
+    "@variance-authority/eyes": "^0.1.0",
+    "@variance-authority/presentation": "^0.1.0",
+    "@variance-authority/report": "^0.1.0",
+    "@variance-authority/scenario": "^0.1.0",
+    "@variance-authority/sense": "^0.1.0",
+    "@variance-authority/vantage": "^0.1.0"
+  },
+  "devDependencies": {
+    "@variance-authority/core": "^0.1.0"
+  }
+}