log10x-mcp 1.27.0 → 1.27.1

package/assets/tenx-mcp-file.config.yaml

@@ -0,0 +1,106 @@
+# Log10x MCP — file-mode tenx runtime config.
+#
+# Reads events from LOG10X_MCP_INPUT_PATH, writes templates/encoded/
+# decoded/aggregated to LOG10X_MCP_OUTPUT_DIR. Override this file via
+# LOG10X_MCP_FILE_CONFIG_PATH.
+
+tenx: run
+runtimeName: $=TenXEnv.get("LOG10X_MCP_RUNTIME_NAME", "mcp-file")
+
+# Include the input/output MODULES, not their config wrappers. The
+# wrappers pre-define named entries reading/writing the image's bundled
+# sample, and `allowMultiple: true` would run those alongside the MCP's
+# own entries below.
+include:
+
+
+  # Shared bootstrap (symbols, template loading, transform, etc.)
+  - apps/shared
+
+  # Input module
+  - run/modules/input/file
+
+  # Full enrichment chain.
+  - run/initialize/inputField
+  - run/initialize/level
+  - run/initialize/group
+  - run/initialize/message
+  - run/initialize/httpCode
+  - run/initialize/lookup
+  - run/initialize/custom
+  - run/initialize/k8s
+
+  # Aggregator. Without this NO TenXSummary is produced, so the
+  # `filter: isSummary` output below matches nothing and aggregated.csv
+  # is a header with zero data rows. That silently strips the only
+  # source of per-pattern severity, and `isReducibleSeverity(undefined)`
+  # then treats every ERROR pattern as reducible. Do not remove.
+  #
+  # DELIBERATELY EXPLICIT. DO NOT RELY ON FLAVOR DEFAULTS. If a future
+  # engine emits summary rows by default, this stays. Flavors differ:
+  # the compiler-flavor image emitted neither summary rows nor anchors
+  # while the edge-flavor host binary emitted both, on the same input
+  # and version family. A pinned older image, or a flavor we have not
+  # met, silently stops producing them, severity coverage returns to
+  # 0%, every ERROR pattern is marked reducible, and NOTHING ERRORS.
+  # That silence is how this defect survived unnoticed the first time.
+  - run/aggregate/mcp
+
+  # Output module
+  - run/modules/output/event/file
+
+# Template cache: in local-binary mode the runner shadows the install's
+# run/template/config.yaml with files: [] so persistent state under
+# data/templates/ and data/sample/output/ doesn't pre-load. Docker is
+# ephemeral, so the runner skips the shadow there.
+
+# ========================== Input options ==========================
+
+inputFile:
+  - name: mcpFileInput
+    path: $=TenXEnv.get("LOG10X_MCP_INPUT_PATH")
+    printProgress: false
+    extractors: []
+    sourcePattern: null
+
+# ========================= Output options =========================
+
+outputFile:
+
+  - path: $=TenXEnv.get("LOG10X_MCP_OUTPUT_DIR") + "/templates.json"
+    writeTemplates: true
+    append: false
+
+  # DELIBERATELY EXPLICIT. DO NOT RELY ON FLAVOR DEFAULTS. Asking for
+  # these here is not redundant even once the engine emits them by
+  # default: it is what makes the MCP independent of which flavor and
+  # which image tag it happens to be talking to. See the note above.
+  #
+  # The four anchor fields after encode() are what carry Reporter-tier
+  # identity out of the engine: `pattern=,<symbolMessage>` and
+  # `patternHash=,<tenx_hash>`. cli-output-parser reads them off each
+  # encoded line, and pattern-extraction joins aggregated.csv on the
+  # tenx_hash to resolve severity. Drop them and every pattern loses its
+  # tenxHash, the aggregated join misses, and collapseBySymbolMessage
+  # becomes a no-op.
+  - path: $=TenXEnv.get("LOG10X_MCP_OUTPUT_DIR") + "/encoded.log"
+    fields:
+      - encode()
+      - patternPrefix="pattern="
+      - $=yield TenXEnv.get("symbolMessageField")
+      - patternHashPrefix="patternHash="
+      - $=yield TenXEnv.get("symbolMessageHashField")
+
+  - path: $=TenXEnv.get("LOG10X_MCP_OUTPUT_DIR") + "/decoded.log"
+    filter: isEncoded
+    fields:
+      - text
+
+  - path: $=TenXEnv.get("LOG10X_MCP_OUTPUT_DIR") + "/aggregated.csv"
+    filter: isSummary
+    header: $=yield TenXString.join(",", TenXEnv.get("enrichmentFields"), "summaryVolume", "summaryBytes", "summaryTotals") + "\n"
+    fields:
+      - $=yield TenXEnv.get("enrichmentFields")
+      - summaryVolume
+      - summaryBytes
+      - summaryTotals

package/assets/tenx-mcp-stdin.config.yaml

@@ -0,0 +1,106 @@
+# Log10x MCP — stdin-mode tenx runtime config.
+#
+# Used by log10x_resolve_batch. The batch is piped to tenx over stdin,
+# templates + encoded rows + aggregated summary are written to a
+# per-invocation temp dir via LOG10X_MCP_OUTPUT_DIR.
+#
+# Safe to edit: copy to ~/.log10x-mcp/stdin.config.yaml and set
+# LOG10X_MCP_STDIN_CONFIG_PATH in the MCP env.
+
+tenx: run
+runtimeName: $=TenXEnv.get("LOG10X_MCP_RUNTIME_NAME", "mcp-stdin")
+
+# Stdin input is controlled by the `stdinEnabled` env var. Force it on
+# so the stdin reader consumes piped batches.
+stdinEnabled: "true"
+
+include:
+
+  # --------------------------- Shared bootstrap ---------------------------
+  # apps/shared chains run/bootstrap, run/symbol, run/template,
+  # run/transform, run/reload, run/monitor, run/console — everything
+  # the runtime needs before input/enrichment/output. Intentionally
+  # NOT including `dev` or `run/aggregate/dev` — those pull in
+  # DevOutputStream which requires an API key, and we want local
+  # offline validation to work without one.
+  - apps/shared
+
+  # --------------------------- Input ---------------------------
+  - run/input/stdin
+
+  # ------------------------ Enrichment --------------------------
+  # Full chain — keeps validation realistic. Matches the modules the
+  # paste Lambda and in-cluster fluentd use, so templates and
+  # identities here are byte-compatible with the production pipeline.
+  - run/initialize/inputField
+  - run/initialize/level
+  - run/initialize/group
+  - run/initialize/message
+  - run/initialize/httpCode
+  - run/initialize/lookup
+  - run/initialize/custom
+  - run/initialize/k8s
+
+  # --------------------------- Output ---------------------------
+  # File sink only. Output paths are constructed per-invocation from
+  # LOG10X_MCP_OUTPUT_DIR. The MCP creates a fresh tempdir per call
+  # so concurrent invocations don't collide.
+  #
+  # IMPORTANT: include the bare module (`run/modules/output/event/file`)
+  # not the full config-bearing path (`run/output/event/file`). The
+  # full path's `config.yaml` defines `outputFile:` entries pointing at
+  # `data/sample/output/*.json` — those entries APPEND to ours and the
+  # engine writes newly-discovered templates into the system cache at
+  # `/usr/local/etc/tenx/config/data/sample/output/templates.json`. On
+  # subsequent MCP runs the engine loads that system cache and
+  # correctly deduplicates already-known templates, so our tempdir's
+  # `templates.json` comes back empty even though `encoded.log` is full
+  # — which makes `resolve_batch` return "No patterns resolved" for any
+  # input whose templates were learned in a previous MCP run.
+  # Caught live by the eval-harness sub-agent on cart logs (templates
+  # were cached system-wide after the first run; second run returned
+  # 0 templates with the same input).
+  - run/modules/output/event/file
+
+# Template cache: the engine loads cached templates from
+# data/templates/*.json and data/sample/output/*.json at startup.
+# The MCP's runner sets TENX_INCLUDE_PATHS with the per-invocation
+# tempdir FIRST, so template-file globs resolve to empty directories
+# there before hitting the install's cache. This forces all templates
+# produced during the run to be "new" and written to templates.json.
+
+# ========================== Input options ==========================
+
+stdin:
+  extractors: []
+  sourcePattern: null
+
+# ========================= Output options =========================
+
+outputFile:
+
+  # Full structural identity library — one line per unique template.
+  - path: $=TenXEnv.get("LOG10X_MCP_OUTPUT_DIR") + "/templates.json"
+    writeTemplates: true
+    append: false
+
+  # Per-event encoded rows — one per input event, mapping to template hash.
+  - path: $=TenXEnv.get("LOG10X_MCP_OUTPUT_DIR") + "/encoded.log"
+    fields:
+      - encode()
+
+  # Per-event decoded text — for human inspection / round-trip checks.
+  - path: $=TenXEnv.get("LOG10X_MCP_OUTPUT_DIR") + "/decoded.log"
+    filter: isEncoded
+    fields:
+      - text
+
+  # Aggregated summary — used for severity / service / volume rollups.
+  - path: $=TenXEnv.get("LOG10X_MCP_OUTPUT_DIR") + "/aggregated.csv"
+    filter: isSummary
+    header: $=yield TenXString.join(",", TenXEnv.get("enrichmentFields"), "summaryVolume", "summaryBytes", "summaryTotals") + "\n"
+    fields:
+      - $=yield TenXEnv.get("enrichmentFields")
+      - summaryVolume
+      - summaryBytes
+      - summaryTotals

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "log10x-mcp",
-  "version": "1.27.0",
+  "version": "1.27.1",
   "description": "Log10x MCP Server \u2014 per-pattern log cost attribution, root-cause investigation, pasted-batch triage, archive query/backfill, and cross-pillar correlation against customer metric backends (Grafana Cloud, Mimir, Thanos, AMP) with structural validation that refuses when it cannot prove linkage",
   "type": "module",
   "main": "build/index.js",
@@ -10,6 +10,7 @@
   },
   "files": [
     "build",
+    "assets",
     "default-manifest.json",
     "README.md",
     "LICENSE"