@pdpp/local-collector 0.1.0-beta.3 → 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,22 +7,29 @@ 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
|
|
13
|
-
# @pdpp/local-collector package, npx-launched pdpp-local-collector binary
|
|
14
|
-
npx -y @pdpp/local-collector advertise
|
|
20
|
+
# @pdpp/local-collector@beta package, npx-launched pdpp-local-collector binary
|
|
21
|
+
npx -y @pdpp/local-collector@beta advertise
|
|
15
22
|
|
|
16
|
-
# @pdpp/local-collector package, npx-launched pdpp-local-collector binary
|
|
17
|
-
npx -y @pdpp/local-collector enroll \
|
|
23
|
+
# @pdpp/local-collector@beta package, npx-launched pdpp-local-collector binary
|
|
24
|
+
npx -y @pdpp/local-collector@beta enroll \
|
|
18
25
|
--base-url https://<reference-host> \
|
|
19
26
|
--code <one-time-code>
|
|
20
27
|
|
|
21
|
-
# @pdpp/local-collector package, npx-launched pdpp-local-collector binary
|
|
28
|
+
# @pdpp/local-collector@beta package, npx-launched pdpp-local-collector binary
|
|
22
29
|
PDPP_LOCAL_DEVICE_ID=<device_id> \
|
|
23
30
|
PDPP_LOCAL_DEVICE_TOKEN=<device_token> \
|
|
24
31
|
PDPP_CONNECTION_ID=<source_instance_id> \
|
|
25
|
-
npx -y @pdpp/local-collector run \
|
|
32
|
+
npx -y @pdpp/local-collector@beta run \
|
|
26
33
|
--base-url https://<reference-host> \
|
|
27
34
|
--connector claude_code
|
|
28
35
|
```
|
|
@@ -34,8 +41,8 @@ before persisting records or state.
|
|
|
34
41
|
Install globally if you prefer a persistent binary:
|
|
35
42
|
|
|
36
43
|
```bash
|
|
37
|
-
# @pdpp/local-collector package, installs the pdpp-local-collector binary
|
|
38
|
-
npm i -g @pdpp/local-collector
|
|
44
|
+
# @pdpp/local-collector@beta package, installs the pdpp-local-collector binary
|
|
45
|
+
npm i -g @pdpp/local-collector@beta
|
|
39
46
|
pdpp-local-collector advertise
|
|
40
47
|
```
|
|
41
48
|
|
|
@@ -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.
|
|
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,
|