@actagent/diffs-language-pack 2026.6.2

package/index.ts

@@ -0,0 +1,10 @@
+// Diffs Language Pack plugin entrypoint registers its ACTAgent integration.
+import { definePluginEntry } from "./api.js";
+import { registerDiffsLanguagePackPlugin } from "./src/plugin.js";
+
+export default definePluginEntry({
+  id: "diffs-language-pack",
+  name: "Diff Viewer Language Pack",
+  description: "Adds syntax highlighting for languages outside the default diffs viewer set.",
+  register: registerDiffsLanguagePackPlugin,
+});

package/npm-shrinkwrap.json

@@ -0,0 +1,12 @@
+{
+  "name": "@actagent/diffs-language-pack",
+  "version": "2026.6.2",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "@actagent/diffs-language-pack",
+      "version": "2026.6.2"
+    }
+  }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@actagent/diffs-language-pack",
+  "version": "2026.6.2",
+  "description": "ACTAgent diffs viewer syntax highlighting language pack",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/actagent/actagent"
+  },
+  "type": "module",
+  "devDependencies": {
+    "@actagent/plugin-sdk": "workspace:*"
+  },
+  "actagent": {
+    "extensions": [
+      "./index.ts"
+    ],
+    "install": {
+      "npmSpec": "@actagent/diffs-language-pack",
+      "actagenthubSpec": "actagenthub:@actagent/diffs-language-pack",
+      "localPath": "extensions/diffs-language-pack",
+      "defaultChoice": "npm",
+      "minHostVersion": ">=2026.5.27"
+    },
+    "compat": {
+      "pluginApi": ">=2026.6.2"
+    },
+    "assetScripts": {
+      "build": "node ../../scripts/build-diffs-viewer-runtime.mjs full"
+    },
+    "build": {
+      "actagentVersion": "2026.6.2",
+      "staticAssets": [
+        {
+          "source": "./assets/viewer-runtime.js",
+          "output": "assets/viewer-runtime.js"
+        }
+      ]
+    },
+    "release": {
+      "publishToACTAgentHub": true,
+      "publishToNpm": true
+    }
+  }
+}

package/src/plugin.ts

@@ -0,0 +1,65 @@
+// Diffs Language Pack plugin module implements plugin behavior.
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { ACTAgentPluginApi } from "../api.js";
+import { VIEWER_ASSET_PREFIX, getServedViewerAsset } from "./viewer-assets.js";
+
+export function registerDiffsLanguagePackPlugin(api: ACTAgentPluginApi): void {
+  api.registerHttpRoute({
+    path: "/plugins/diffs-language-pack",
+    auth: "plugin",
+    match: "prefix",
+    handler: createDiffsLanguagePackHttpHandler(),
+  });
+}
+
+function createDiffsLanguagePackHttpHandler() {
+  return async (req: IncomingMessage, res: ServerResponse): Promise<boolean> => {
+    const parsed = parseRequestUrl(req.url);
+    if (!parsed?.pathname.startsWith(VIEWER_ASSET_PREFIX)) {
+      return false;
+    }
+    if (req.method !== "GET" && req.method !== "HEAD") {
+      respondText(res, 405, "Method not allowed");
+      return true;
+    }
+
+    const asset = await getServedViewerAsset(parsed.pathname);
+    if (!asset) {
+      respondText(res, 404, "Asset not found");
+      return true;
+    }
+
+    res.statusCode = 200;
+    setSharedHeaders(res, asset.contentType);
+    if (req.method === "HEAD") {
+      res.end();
+    } else {
+      res.end(asset.body);
+    }
+    return true;
+  };
+}
+
+function parseRequestUrl(rawUrl?: string): URL | null {
+  if (!rawUrl) {
+    return null;
+  }
+  try {
+    return new URL(rawUrl, "http://127.0.0.1");
+  } catch {
+    return null;
+  }
+}
+
+function respondText(res: ServerResponse, statusCode: number, body: string): void {
+  res.statusCode = statusCode;
+  setSharedHeaders(res, "text/plain; charset=utf-8");
+  res.end(body);
+}
+
+function setSharedHeaders(res: ServerResponse, contentType: string): void {
+  res.setHeader("cache-control", "no-store, max-age=0");
+  res.setHeader("content-type", contentType);
+  res.setHeader("x-content-type-options", "nosniff");
+  res.setHeader("referrer-policy", "no-referrer");
+}

package/src/viewer-assets.ts

@@ -0,0 +1,91 @@
+// Diffs Language Pack plugin module implements viewer assets behavior.
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+
+export const VIEWER_ASSET_PREFIX = "/plugins/diffs-language-pack/assets/";
+export const VIEWER_LOADER_PATH = `${VIEWER_ASSET_PREFIX}viewer.js`;
+export const VIEWER_RUNTIME_PATH = `${VIEWER_ASSET_PREFIX}viewer-runtime.js`;
+const VIEWER_RUNTIME_RELATIVE_IMPORT_PATH = "./viewer-runtime.js";
+const VIEWER_RUNTIME_CANDIDATE_RELATIVE_PATHS = [
+  "./assets/viewer-runtime.js",
+  "../assets/viewer-runtime.js",
+] as const;
+
+type ServedViewerAsset = {
+  body: string | Buffer;
+  contentType: string;
+};
+
+type RuntimeAssetCache = {
+  mtimeMs: number;
+  runtimeBody: Buffer;
+  loaderBody: string;
+};
+
+let runtimeAssetCache: RuntimeAssetCache | null = null;
+
+function isMissingFileError(error: unknown): error is NodeJS.ErrnoException {
+  return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+
+export async function resolveViewerRuntimeFileUrl(): Promise<URL> {
+  let missingFileError: NodeJS.ErrnoException | null = null;
+
+  for (const relativePath of VIEWER_RUNTIME_CANDIDATE_RELATIVE_PATHS) {
+    const candidateUrl = new URL(relativePath, import.meta.url);
+    try {
+      await fs.stat(fileURLToPath(candidateUrl));
+      return candidateUrl;
+    } catch (error) {
+      if (isMissingFileError(error)) {
+        missingFileError = error;
+        continue;
+      }
+      throw error;
+    }
+  }
+
+  if (missingFileError) {
+    throw missingFileError;
+  }
+
+  throw new Error("viewer runtime asset candidates were not checked");
+}
+
+export async function getServedViewerAsset(pathname: string): Promise<ServedViewerAsset | null> {
+  if (pathname !== VIEWER_LOADER_PATH && pathname !== VIEWER_RUNTIME_PATH) {
+    return null;
+  }
+
+  const assets = await loadViewerAssets();
+  if (pathname === VIEWER_LOADER_PATH) {
+    return {
+      body: assets.loaderBody,
+      contentType: "text/javascript; charset=utf-8",
+    };
+  }
+
+  return {
+    body: assets.runtimeBody,
+    contentType: "text/javascript; charset=utf-8",
+  };
+}
+
+async function loadViewerAssets(): Promise<RuntimeAssetCache> {
+  const runtimeUrl = await resolveViewerRuntimeFileUrl();
+  const runtimePath = fileURLToPath(runtimeUrl);
+  const runtimeStat = await fs.stat(runtimePath);
+  if (runtimeAssetCache && runtimeAssetCache.mtimeMs === runtimeStat.mtimeMs) {
+    return runtimeAssetCache;
+  }
+
+  const runtimeBody = await fs.readFile(runtimePath);
+  const hash = crypto.createHash("sha1").update(runtimeBody).digest("hex").slice(0, 12);
+  runtimeAssetCache = {
+    mtimeMs: runtimeStat.mtimeMs,
+    runtimeBody,
+    loaderBody: `import "${VIEWER_RUNTIME_RELATIVE_IMPORT_PATH}?v=${hash}";\n`,
+  };
+  return runtimeAssetCache;
+}