@pdpp/local-collector 0.1.0-beta.4 → 0.1.0-beta.6

package/README.md

@@ -7,6 +7,13 @@ ships only the local collector runner, the device-exporter client, and bundled
 Claude Code / Codex connector entrypoints. Browser/Patchright-backed connectors
 stay out of this package until each has its own publishability review.
 
+For filesystem-class collectors, the local device or host supervisor decides
+when the process runs. The reference server owns enrollment, ingestion, state,
+health diagnostics, and optional desired-freshness/request-run signals, but it
+does not start local processes. `PDPP_CONNECTION_ID` is the stable
+connection/source identity for a specific device/account/home binding; the
+enrollment response currently names that value `source_instance_id`.
+
 ## Usage
 
 ```bash

package/dist/local-collector/bin/pdpp-local-collector.js

@@ -1,14 +1,44 @@
 #!/usr/bin/env node
-import { existsSync } from "node:fs";
+import { existsSync, readFileSync } from "node:fs";
 import { basename, dirname, extname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { ALLOW_CUSTOM_COMMAND_ENV, CollectorCustomCommandRefusedError, CollectorUsageError, } from "../src/errors.js";
 import { BUNDLED_CONNECTOR_IDS, COLLECTOR_PROTOCOL_VERSION, COLLECTOR_RUNTIME_CAPABILITIES, LocalDeviceOutbox, enrollCollector, getBundledConnector, isMainModule, runCollectorConnector, } from "../src/runner.js";
 const DEFAULT_QUEUE_PATH = join(dirname(fileURLToPath(import.meta.url)), "..", ".pdpp-data", "collector-runner-queue.json");
 const LOCAL_COLLECTOR_PACKAGE_NAME = "@pdpp/local-collector";
-const LOCAL_COLLECTOR_PACKAGE_VERSION = "0.0.0";
+const LOCAL_COLLECTOR_PACKAGE_VERSION_FALLBACK = "0.0.0";
+export function resolveLocalCollectorPackageVersion(startUrl = import.meta.url) {
+    let current = typeof startUrl === "string" && !startUrl.startsWith("file:")
+        ? dirname(startUrl)
+        : dirname(fileURLToPath(startUrl));
+    for (;;) {
+        const manifestPath = join(current, "package.json");
+        if (existsSync(manifestPath)) {
+            try {
+                const manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+                if (manifest.name === LOCAL_COLLECTOR_PACKAGE_NAME &&
+                    typeof manifest.version === "string" &&
+                    manifest.version) {
+                    return manifest.version;
+                }
+            }
+            catch {
+            }
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            return LOCAL_COLLECTOR_PACKAGE_VERSION_FALLBACK;
+        }
+        current = parent;
+    }
+}
 const HELP_TEXT = `pdpp-local-collector — PDPP local collector runner.
 
+Ownership: the local device/host supervisor decides when filesystem-class
+collectors run. The reference server owns enrollment, ingestion, state, health
+diagnostics, and optional desired-freshness/request-run signals; it does not
+start local processes.
+
 Subcommands:
   advertise                       Print runtime capabilities and protocol version.
   status                          Print local durable outbox health as JSON.
@@ -30,6 +60,8 @@ Subcommands:
           [--run-id <id>]
 
 Public connectors: ${BUNDLED_CONNECTOR_IDS.join(", ")}.
+Connection id is the stable source identity for one device/account/home binding;
+enrollment responses currently return it as source_instance_id.
 Browser-bound connectors stay in the monorepo until each has its own
 publishability review.
 
@@ -146,9 +178,10 @@ export function inspectLocalOutboxStatus(options) {
         },
         package: {
             name: LOCAL_COLLECTOR_PACKAGE_NAME,
-            version: LOCAL_COLLECTOR_PACKAGE_VERSION,
+            version: resolveLocalCollectorPackageVersion(),
         },
         source: {
+            connection_id: options.sourceInstanceId ?? null,
             source_instance_id: options.sourceInstanceId ?? null,
         },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pdpp/local-collector",
-  "version": "0.1.0-beta.4",
+  "version": "0.1.0-beta.6",
   "description": "Publishable local collector runtime for PDPP: filesystem-class connectors (Claude Code, Codex) plus the device-exporter ingest client.",
   "type": "module",
   "private": false,