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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -7,6 +7,13 @@ ships only the local collector runner, the device-exporter client, and bundled
7
7
  Claude Code / Codex connector entrypoints. Browser/Patchright-backed connectors
8
8
  stay out of this package until each has its own publishability review.
9
9
 
10
+ For filesystem-class collectors, the local device or host supervisor decides
11
+ when the process runs. The reference server owns enrollment, ingestion, state,
12
+ health diagnostics, and optional desired-freshness/request-run signals, but it
13
+ does not start local processes. `PDPP_CONNECTION_ID` is the stable
14
+ connection/source identity for a specific device/account/home binding; the
15
+ enrollment response currently names that value `source_instance_id`.
16
+
10
17
  ## Usage
11
18
 
12
19
  ```bash
@@ -9,6 +9,11 @@ const LOCAL_COLLECTOR_PACKAGE_NAME = "@pdpp/local-collector";
9
9
  const LOCAL_COLLECTOR_PACKAGE_VERSION = "0.0.0";
10
10
  const HELP_TEXT = `pdpp-local-collector — PDPP local collector runner.
11
11
 
12
+ Ownership: the local device/host supervisor decides when filesystem-class
13
+ collectors run. The reference server owns enrollment, ingestion, state, health
14
+ diagnostics, and optional desired-freshness/request-run signals; it does not
15
+ start local processes.
16
+
12
17
  Subcommands:
13
18
  advertise Print runtime capabilities and protocol version.
14
19
  status Print local durable outbox health as JSON.
@@ -30,6 +35,8 @@ Subcommands:
30
35
  [--run-id <id>]
31
36
 
32
37
  Public connectors: ${BUNDLED_CONNECTOR_IDS.join(", ")}.
38
+ Connection id is the stable source identity for one device/account/home binding;
39
+ enrollment responses currently return it as source_instance_id.
33
40
  Browser-bound connectors stay in the monorepo until each has its own
34
41
  publishability review.
35
42
 
@@ -149,6 +156,7 @@ export function inspectLocalOutboxStatus(options) {
149
156
  version: LOCAL_COLLECTOR_PACKAGE_VERSION,
150
157
  },
151
158
  source: {
159
+ connection_id: options.sourceInstanceId ?? null,
152
160
  source_instance_id: options.sourceInstanceId ?? null,
153
161
  },
154
162
  };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pdpp/local-collector",
3
- "version": "0.1.0-beta.4",
3
+ "version": "0.1.0-beta.5",
4
4
  "description": "Publishable local collector runtime for PDPP: filesystem-class connectors (Claude Code, Codex) plus the device-exporter ingest client.",
5
5
  "type": "module",
6
6
  "private": false,