netzilo 4.3.14 → 4.3.17

package/dist/index.d.ts

@@ -60,6 +60,19 @@ export declare function flush(): void;
  * only uploaded hourly and at shutdown. No-op on older bundled libraries.
  */
 export declare function snapshot(): void;
+/**
+ * Register another process's PID as "the agent" for AIDR attribution.
+ *
+ * Only needed when start() runs in a supervisor/sidecar process that is NOT
+ * the process doing the actual agent work - e.g. a container entrypoint that
+ * arms netzilo, then forks/execs the real workload as a separate PID.
+ * Without this, only the PID that called start() is named with the
+ * configured agentName in the AIDR graph; every other process, including the
+ * intended one, falls back to a generic executable-basename label instead of
+ * appearing as the graph root. No-op on older bundled libraries, and if
+ * pid <= 0.
+ */
+export declare function setAgentPid(pid: number): void;
 /** Whether the embedded client is currently running. */
 export declare function isRunning(): boolean;
 /**

package/dist/index.js

@@ -40,6 +40,7 @@ exports.socks5Port = socks5Port;
 exports.stop = stop;
 exports.flush = flush;
 exports.snapshot = snapshot;
+exports.setAgentPid = setAgentPid;
 exports.isRunning = isRunning;
 exports.integrityLevel = integrityLevel;
 exports.evaluate = evaluate;
@@ -262,6 +263,21 @@ function flush() {
 function snapshot() {
     (0, loader_1.load)().FlushSnapshot();
 }
+/**
+ * Register another process's PID as "the agent" for AIDR attribution.
+ *
+ * Only needed when start() runs in a supervisor/sidecar process that is NOT
+ * the process doing the actual agent work - e.g. a container entrypoint that
+ * arms netzilo, then forks/execs the real workload as a separate PID.
+ * Without this, only the PID that called start() is named with the
+ * configured agentName in the AIDR graph; every other process, including the
+ * intended one, falls back to a generic executable-basename label instead of
+ * appearing as the graph root. No-op on older bundled libraries, and if
+ * pid <= 0.
+ */
+function setAgentPid(pid) {
+    (0, loader_1.load)().SetAgentPID(pid);
+}
 /** Whether the embedded client is currently running. */
 function isRunning() {
     return (0, loader_1.load)().IsRunning() !== 0;

package/dist/loader.d.ts

@@ -14,6 +14,7 @@ export interface NetziloLib {
     FlushEvents(): void;
     FlushSnapshot(): void;
     GetIntegrityLevel(): number;
+    SetAgentPID(pid: number): void;
 }
 export declare function load(): NetziloLib;
 /** Test-only: forget the cached binding so a fresh NETZILO_LIB_PATH can be picked up. */

package/dist/loader.js

@@ -110,11 +110,12 @@ function load() {
     // references it by the registered NAME, not by that return value.
     koffi.disposable("NetziloHeapStr", "str", freeString);
     const evaluate = lib.func("NetziloHeapStr Evaluate(str reqJSON)");
-    // FlushEvents/FlushSnapshot/GetIntegrityLevel may be absent in older
-    // bundled libraries; bind defensively.
+    // FlushEvents/FlushSnapshot/GetIntegrityLevel/SetAgentPID may be absent in
+    // older bundled libraries; bind defensively.
     let flushEvents = noop;
     let flushSnapshot = noop;
     let getIntegrityLevel = () => 2; // medium — the documented default
+    let setAgentPID = noop;
     try {
         flushEvents = lib.func("void FlushEvents()");
     }
@@ -133,6 +134,12 @@ function load() {
     catch {
         // absent in this build — keep the medium-default fallback
     }
+    try {
+        setAgentPID = lib.func("void SetAgentPID(int pid)");
+    }
+    catch {
+        // absent in this build — keep the no-op
+    }
     cached = {
         Start: (configJSON) => start(configJSON),
         Stop: () => stop(),
@@ -145,6 +152,9 @@ function load() {
             flushSnapshot();
         },
         GetIntegrityLevel: () => getIntegrityLevel(),
+        SetAgentPID: (pid) => {
+            setAgentPID(pid);
+        },
     };
     return cached;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "netzilo",
-  "version": "4.3.14",
+  "version": "4.3.17",
   "description": "Netzilo AI Detection & Response (AIDR) — governance for Node.js/TypeScript AI agents.",
   "license": "Commercial",
   "author": "Netzilo",
@@ -35,11 +35,11 @@
     "koffi": "^2.9.0"
   },
   "optionalDependencies": {
-    "netzilo-darwin-arm64": "4.3.14",
-    "netzilo-darwin-x64": "4.3.14",
-    "netzilo-linux-arm64": "4.3.14",
-    "netzilo-linux-x64": "4.3.14",
-    "netzilo-windows-x64": "4.3.14"
+    "netzilo-darwin-arm64": "4.3.17",
+    "netzilo-darwin-x64": "4.3.17",
+    "netzilo-linux-arm64": "4.3.17",
+    "netzilo-linux-x64": "4.3.17",
+    "netzilo-windows-x64": "4.3.17"
   },
   "peerDependencies": {
     "undici": "^8.5.0"