@relayhistory/provider-sources 0.18.2

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.
Files changed (2) hide show
  1. package/README.md +32 -0
  2. package/package.json +49 -0
package/README.md ADDED
@@ -0,0 +1,32 @@
1
+ # Optional provider source plugins
2
+
3
+ `npm install ai-hist @relayhistory/provider-sources`
4
+
5
+ This optional package registers `claude-web` and `codex-cloud` source adapters.
6
+ It uses the provider CLI's existing sign-in only when an acquisition is selected.
7
+ Installation and registration do not probe credentials. Local operations remain
8
+ in the local SDK and do not invoke these adapters.
9
+
10
+ ```json
11
+ {"plugins":[{"module":"@relayhistory/provider-sources","options":{"connectors":["claude-web","codex-cloud"],"instanceId":"personal"}}]}
12
+ ```
13
+
14
+ ```sh
15
+ ai-hist sessions discover --remote --config history.json --source-connector claude-web
16
+ ai-hist sessions hydrate claude SESSION_ID --remote --config history.json --source-connector claude-web
17
+ ai-hist sync --all --config history.json --source-connector codex-cloud
18
+ ```
19
+
20
+ Programmatic callers use `createHistoryPlugin`, register it in a
21
+ `HistoryPluginRegistry`, and pass that registry as `plugins` to discovery,
22
+ hydration or sync. `sourceConnectors: []` disables remote acquisition. Remote
23
+ scope with no installed/selected source fails explicitly. Source identities
24
+ include an instance label; each observation keeps its opaque acquisition locator,
25
+ stamp, revision, evidence and checkpoint independently from other connectors.
26
+
27
+ The platform package supplies `history-provider-sources`. Development may set
28
+ `HISTORY_PROVIDER_SOURCES_BIN` or `binaryPath`. The helper is a bounded subprocess
29
+ protocol, not another native addon. Claude's private teleport contract can change;
30
+ Codex exposes a diff rather than a full transcript. Adapters report their covered
31
+ evidence kinds and the local engine retains partial capability honestly. See
32
+ `../rust/README.md` in the source repository for provider transport limits.
package/package.json ADDED
@@ -0,0 +1,49 @@
1
+ {
2
+ "name": "@relayhistory/provider-sources",
3
+ "version": "0.18.2",
4
+ "description": "Optional Claude web and Codex cloud source adapters for local ai-hist.",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "main": "dist/index.js",
8
+ "types": "dist/index.d.ts",
9
+ "exports": {
10
+ ".": {
11
+ "types": "./dist/index.d.ts",
12
+ "default": "./dist/index.js"
13
+ }
14
+ },
15
+ "files": [
16
+ "dist/index.*",
17
+ "dist/helper.*",
18
+ "bin/",
19
+ "README.md"
20
+ ],
21
+ "scripts": {
22
+ "build": "tsc -p tsconfig.json",
23
+ "typecheck": "tsc -p tsconfig.json --noEmit",
24
+ "test": "npm run build && node --test dist/*.test.js"
25
+ },
26
+ "peerDependencies": {
27
+ "ai-hist": "^0.18.2"
28
+ },
29
+ "devDependencies": {
30
+ "ai-hist": "file:../../../sdk-ts",
31
+ "@types/node": "^22.18.0",
32
+ "typescript": "^5.9.2"
33
+ },
34
+ "engines": {
35
+ "node": ">=20"
36
+ },
37
+ "optionalDependencies": {
38
+ "@relayhistory/provider-sources-darwin-arm64": "0.18.2",
39
+ "@relayhistory/provider-sources-darwin-x64": "0.18.2",
40
+ "@relayhistory/provider-sources-linux-x64-gnu": "0.18.2",
41
+ "@relayhistory/provider-sources-linux-arm64-gnu": "0.18.2",
42
+ "@relayhistory/provider-sources-linux-x64-musl": "0.18.2",
43
+ "@relayhistory/provider-sources-linux-arm64-musl": "0.18.2",
44
+ "@relayhistory/provider-sources-win32-x64-msvc": "0.18.2"
45
+ },
46
+ "publishConfig": {
47
+ "access": "public"
48
+ }
49
+ }