@memrov2/pentcloud-file-analysis 0.0.0-stage → 0.1.1-dev.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PentCloud contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# PentCloud file-analysis
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Offline Binwalk in a separate native Cloudflare runtime. **Version 0.1.0 SDK.** Uses pinned distro Binwalk 2.4.3; extraction and recursion are excluded.
+
+```js
+export { FileRunner } from '@memrov2/pentcloud-file-analysis/worker';
+const runner = env.TOOL.getByName(runId);
+try {
+  const result = await runner.run({tool:'binwalk',view:'signatures'}, {input:fileBytes});
+  // Save the result in your existing private assessment store.
+} finally {
+  await runner.stop();
+}
+```
+
+Configure the matching named Container image. See [interfaces, build instructions, verification and limits](https://github.com/Memrov/PentCloud-tools/blob/main/docs/remaining-bundles.md) before integration. This package does not deploy or modify PentCloud.

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,3 @@
+# Third-party notices
+
+The adapter is MIT licensed. Original runtime programs and data retain their upstream licenses and notices, preserved in the image. The package lock lists every pinned input. Unreleased candidate; no license grant for third-party redistribution is implied.

package/package.json

@@ -1,6 +1,38 @@
 {
   "name": "@memrov2/pentcloud-file-analysis",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1-dev.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Cloudflare-native file-analysis tool pack",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Memrov/PentCloud-tools.git",
+    "directory": "packages/file-analysis"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "exports": {
+    ".": {
+      "types": "./src/index.d.mts",
+      "import": "./src/index.mjs"
+    },
+    "./worker": {
+      "types": "./src/worker.d.mts",
+      "import": "./src/worker.mjs"
+    },
+    "./tools.lock.json": "./tools.lock.json"
+  },
+  "files": [
+    "src",
+    "tools.lock.json",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@memrov2/pentcloud-tool-runtime": "0.1.1-dev.0"
+  }
+}

package/src/index.d.mts

@@ -0,0 +1,4 @@
+import type { ToolCommand, PackLock } from "@memrov2/pentcloud-tool-runtime";
+export type PackRequest = { tool: "binwalk"; view?: "signatures" | "entropy" };
+export declare const lock: PackLock;
+export declare function buildCommand(input: PackRequest): ToolCommand;

package/src/index.mjs

@@ -0,0 +1,23 @@
+import lock from "../tools.lock.json" with { type: "json" };
+export { lock };
+export function buildCommand(input) {
+  if (
+    !input ||
+    Object.keys(input).some((k) => !["tool", "view"].includes(k)) ||
+    input.tool !== "binwalk" ||
+    !["signatures", "entropy"].includes(input.view ?? "signatures")
+  )
+    throw new TypeError("Select an offline file view");
+  return {
+    argv: [
+      "/opt/pentcloud-file-analysis/bin/binwalk",
+      ...(input.view === "entropy"
+        ? ["--entropy", "--nplot"]
+        : ["--signature"]),
+      "/tmp/pentcloud-file-analysis/input.bin",
+    ],
+    stdin: "",
+    timeoutMs: 75000,
+    requiredFiles: ["input"],
+  };
+}

package/src/worker.d.mts

@@ -0,0 +1,14 @@
+import { DurableObject } from "cloudflare:workers";
+import type { ToolResult } from "@memrov2/pentcloud-tool-runtime";
+import type { PackRequest } from "./index.mjs";
+export declare class FileRunner extends DurableObject {
+  ready(): Promise<{ image: string; instance: "lite"; readyMs: number }>;
+  run(input: PackRequest, files: { input: Uint8Array }): Promise<ToolResult>;
+  retire(): Promise<{ stopped: boolean; retired: true }>;
+  stop(): Promise<{ stopped: boolean }>;
+  capabilities(): Promise<{
+    platform: string;
+    architecture: string;
+    rawPacketSocket: boolean;
+  }>;
+}

package/src/worker.mjs

@@ -0,0 +1,3 @@
+import { createRunner } from "@memrov2/pentcloud-tool-runtime/worker";
+import { lock, buildCommand } from "./index.mjs";
+export const FileRunner = createRunner(lock, buildCommand);

package/tools.lock.json

@@ -0,0 +1,141 @@
+{
+  "schemaVersion": 1,
+  "packId": "file-analysis",
+  "packVersion": "0.1.0",
+  "platform": "linux/amd64",
+  "baseImage": "docker.io/library/debian@sha256:a72b4433de1cf7d6bae0c4cee74d0547f58601a643b3375f070c51600d63b6b2",
+  "tools": [
+    {
+      "tool": "binwalk",
+      "version": "2.4.3"
+    }
+  ],
+  "assets": [],
+  "debs": [
+    {
+      "package": "libexpat1",
+      "version": "2.9.0-1~deb13u1",
+      "url": "https://deb.debian.org/debian-security/pool/updates/main/e/expat/libexpat1_2.9.0-1%7edeb13u1_amd64.deb",
+      "sha256": "feff874772cae904ae4d24e917b35664952bec4b4ae9100a4edda5a7fa746832",
+      "format": "deb"
+    },
+    {
+      "package": "libpython3.13-minimal",
+      "version": "3.13.5-2+deb13u5",
+      "url": "https://deb.debian.org/debian/pool/main/p/python3.13/libpython3.13-minimal_3.13.5-2%2bdeb13u5_amd64.deb",
+      "sha256": "a4aa6a9a8c77f87bfe545e1d14ec42c001d189ace90e3aa75deec882b39dee49",
+      "format": "deb"
+    },
+    {
+      "package": "python3.13-minimal",
+      "version": "3.13.5-2+deb13u5",
+      "url": "https://deb.debian.org/debian/pool/main/p/python3.13/python3.13-minimal_3.13.5-2%2bdeb13u5_amd64.deb",
+      "sha256": "c1fda9e7b1bf15b2fa75a238d8a8710e142fe14c722fc650c5fc614f078c9073",
+      "format": "deb"
+    },
+    {
+      "package": "python3-minimal",
+      "version": "3.13.5-1",
+      "url": "https://deb.debian.org/debian/pool/main/p/python3-defaults/python3-minimal_3.13.5-1_amd64.deb",
+      "sha256": "a5d2371bebf3689f676e3f3bae800371bcc4392a8a51269e23d528249b399615",
+      "format": "deb"
+    },
+    {
+      "package": "media-types",
+      "version": "13.0.0",
+      "url": "https://deb.debian.org/debian/pool/main/m/media-types/media-types_13.0.0_all.deb",
+      "sha256": "0788e4b0b72db1bcf74a19cb24c3511e7770ad0b341f0f30e361701c3072f53e",
+      "format": "deb"
+    },
+    {
+      "package": "netbase",
+      "version": "6.5",
+      "url": "https://deb.debian.org/debian/pool/main/n/netbase/netbase_6.5_all.deb",
+      "sha256": "76bafa92947ebd37b0a6f9ec6570412041f56edebc1c66d323731216d318471e",
+      "format": "deb"
+    },
+    {
+      "package": "libffi8",
+      "version": "3.4.8-2",
+      "url": "https://deb.debian.org/debian/pool/main/libf/libffi/libffi8_3.4.8-2_amd64.deb",
+      "sha256": "0ebdc340de33333639c3c63874cd4b15ac2e83dfa1ef3053b7eefaf4919f4f68",
+      "format": "deb"
+    },
+    {
+      "package": "libncursesw6",
+      "version": "6.5+20250216-2",
+      "url": "https://deb.debian.org/debian/pool/main/n/ncurses/libncursesw6_6.5%2b20250216-2_amd64.deb",
+      "sha256": "47baa2e11579583654583a066b69bd5a5d2f22423081f707ed6c0c3ba6d538b7",
+      "format": "deb"
+    },
+    {
+      "package": "readline-common",
+      "version": "8.2-6",
+      "url": "https://deb.debian.org/debian/pool/main/r/readline/readline-common_8.2-6_all.deb",
+      "sha256": "f77e8aa0bf0de618f11cb0b21658a4ed60f177d63b3cf26d7fc3706b6d0eaaa9",
+      "format": "deb"
+    },
+    {
+      "package": "libreadline8t64",
+      "version": "8.2-6",
+      "url": "https://deb.debian.org/debian/pool/main/r/readline/libreadline8t64_8.2-6_amd64.deb",
+      "sha256": "eeadf2b5e755c9f183883feea2d9b5b28560284275d5f54d3e55d0923b1d0967",
+      "format": "deb"
+    },
+    {
+      "package": "libpython3.13-stdlib",
+      "version": "3.13.5-2+deb13u5",
+      "url": "https://deb.debian.org/debian/pool/main/p/python3.13/libpython3.13-stdlib_3.13.5-2%2bdeb13u5_amd64.deb",
+      "sha256": "db161322a3481d2c0c3b9a3b9a03c3ab0e2b1718f54b88755fb4a3f939165b84",
+      "format": "deb"
+    },
+    {
+      "package": "python3.13",
+      "version": "3.13.5-2+deb13u5",
+      "url": "https://deb.debian.org/debian/pool/main/p/python3.13/python3.13_3.13.5-2%2bdeb13u5_amd64.deb",
+      "sha256": "460c1fd72845516ac3ce9d1686916f3ab2e4c86f8a9746e14d26243a47e2b98d",
+      "format": "deb"
+    },
+    {
+      "package": "libpython3-stdlib",
+      "version": "3.13.5-1",
+      "url": "https://deb.debian.org/debian/pool/main/p/python3-defaults/libpython3-stdlib_3.13.5-1_amd64.deb",
+      "sha256": "7e142ed64a81ccdd39714f213467bd365736ef341adb2be11be981f638b9175f",
+      "format": "deb"
+    },
+    {
+      "package": "python3",
+      "version": "3.13.5-1",
+      "url": "https://deb.debian.org/debian/pool/main/p/python3-defaults/python3_3.13.5-1_amd64.deb",
+      "sha256": "c1388174dc7140e6c19a6dd39f8a0dcb38a835cd66c65644e0dded43d5223cb0",
+      "format": "deb"
+    },
+    {
+      "package": "python3-binwalk",
+      "version": "2.4.3+dfsg1-2+deb13u1",
+      "url": "https://deb.debian.org/debian/pool/main/b/binwalk/python3-binwalk_2.4.3%2bdfsg1-2%2bdeb13u1_all.deb",
+      "sha256": "b857724e8b9eab3859aca97605961633d9a051cc8e207bd230be2beb92f652c3",
+      "format": "deb"
+    },
+    {
+      "package": "binwalk",
+      "version": "2.4.3+dfsg1-2+deb13u1",
+      "url": "https://deb.debian.org/debian/pool/main/b/binwalk/binwalk_2.4.3%2bdfsg1-2%2bdeb13u1_all.deb",
+      "sha256": "645a6833e8ca714dec3368d59a60ba42b3d015acf0749ae4ff3d819b9d0ff9c4",
+      "format": "deb"
+    }
+  ],
+  "executables": [
+    "binwalk"
+  ],
+  "runtime": {
+    "enableInternet": false,
+    "vcpu": 1,
+    "memoryMib": 1024,
+    "diskMb": 3000
+  },
+  "files": true,
+  "links": {
+    "binwalk": "/usr/bin/binwalk"
+  }
+}