@aigne/afs-json 1.11.0-beta.10 → 1.11.0-beta.12
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/dist/index.cjs +54 -6
- package/dist/index.d.cts +7 -1
- package/dist/index.d.cts.map +1 -1
- package/dist/index.d.mts +7 -1
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +55 -7
- package/dist/index.mjs.map +1 -1
- package/package.json +4 -3
package/dist/index.cjs
CHANGED
|
@@ -6,6 +6,7 @@ let node_path = require("node:path");
|
|
|
6
6
|
let _aigne_afs = require("@aigne/afs");
|
|
7
7
|
let _aigne_afs_provider = require("@aigne/afs/provider");
|
|
8
8
|
let _aigne_afs_utils_zod = require("@aigne/afs/utils/zod");
|
|
9
|
+
let _aigne_afs_provider_utils = require("@aigne/afs-provider-utils");
|
|
9
10
|
let ufo = require("ufo");
|
|
10
11
|
let yaml = require("yaml");
|
|
11
12
|
let zod = require("zod");
|
|
@@ -46,7 +47,46 @@ var AFSJSON = class AFSJSON extends _aigne_afs_provider.AFSBaseProvider {
|
|
|
46
47
|
"json",
|
|
47
48
|
"yaml",
|
|
48
49
|
"structured-data"
|
|
49
|
-
]
|
|
50
|
+
],
|
|
51
|
+
capabilityTags: [
|
|
52
|
+
"read-write",
|
|
53
|
+
"crud",
|
|
54
|
+
"search",
|
|
55
|
+
"auth:none",
|
|
56
|
+
"local"
|
|
57
|
+
],
|
|
58
|
+
security: {
|
|
59
|
+
riskLevel: "sandboxed",
|
|
60
|
+
resourceAccess: []
|
|
61
|
+
},
|
|
62
|
+
capabilities: { filesystem: {
|
|
63
|
+
read: true,
|
|
64
|
+
write: true
|
|
65
|
+
} }
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
static treeSchema() {
|
|
69
|
+
return {
|
|
70
|
+
operations: [
|
|
71
|
+
"list",
|
|
72
|
+
"read",
|
|
73
|
+
"write",
|
|
74
|
+
"delete",
|
|
75
|
+
"search",
|
|
76
|
+
"stat",
|
|
77
|
+
"explain"
|
|
78
|
+
],
|
|
79
|
+
tree: {
|
|
80
|
+
"/": { kind: "json:root" },
|
|
81
|
+
"/{key}": { kind: "json:value" }
|
|
82
|
+
},
|
|
83
|
+
auth: { type: "none" },
|
|
84
|
+
bestFor: [
|
|
85
|
+
"JSON/YAML navigation",
|
|
86
|
+
"structured data editing",
|
|
87
|
+
"config files"
|
|
88
|
+
],
|
|
89
|
+
notFor: ["binary files", "large datasets"]
|
|
50
90
|
};
|
|
51
91
|
}
|
|
52
92
|
static async load({ basePath, config } = {}) {
|
|
@@ -68,10 +108,7 @@ var AFSJSON = class AFSJSON extends _aigne_afs_provider.AFSBaseProvider {
|
|
|
68
108
|
this.options = options;
|
|
69
109
|
if (options.localPath && !options.jsonPath) options.jsonPath = options.localPath;
|
|
70
110
|
(0, _aigne_afs_utils_zod.zodParse)(afsJSONOptionsSchema, options);
|
|
71
|
-
|
|
72
|
-
jsonPath = options.jsonPath.replaceAll("${CWD}", process.cwd());
|
|
73
|
-
if (jsonPath.startsWith("~/")) jsonPath = (0, node_path.join)(process.env.HOME || "", jsonPath.slice(2));
|
|
74
|
-
if (!(0, node_path.isAbsolute)(jsonPath)) jsonPath = (0, node_path.join)(options.cwd || process.cwd(), jsonPath);
|
|
111
|
+
const jsonPath = (0, _aigne_afs_provider_utils.resolveLocalPath)(options.jsonPath, { cwd: options.cwd });
|
|
75
112
|
if (!(0, node_fs.existsSync)(jsonPath)) {
|
|
76
113
|
(0, node_fs.mkdirSync)((0, node_path.dirname)(jsonPath), { recursive: true });
|
|
77
114
|
(0, node_fs.writeFileSync)(jsonPath, "{}", "utf8");
|
|
@@ -521,10 +558,21 @@ var AFSJSON = class AFSJSON extends _aigne_afs_provider.AFSBaseProvider {
|
|
|
521
558
|
/**
|
|
522
559
|
* Get path segments from normalized path
|
|
523
560
|
*/
|
|
561
|
+
/**
|
|
562
|
+
* Dangerous property names that must never be used as object keys.
|
|
563
|
+
* Prevents prototype pollution attacks (e.g., writing to /__proto__/polluted).
|
|
564
|
+
*/
|
|
565
|
+
static DANGEROUS_KEYS = new Set([
|
|
566
|
+
"__proto__",
|
|
567
|
+
"constructor",
|
|
568
|
+
"prototype"
|
|
569
|
+
]);
|
|
524
570
|
getPathSegments(path) {
|
|
525
571
|
const normalized = this.normalizePath(path);
|
|
526
572
|
if (normalized === "/") return [];
|
|
527
|
-
|
|
573
|
+
const segments = normalized.slice(1).split("/");
|
|
574
|
+
for (const segment of segments) if (AFSJSON.DANGEROUS_KEYS.has(segment)) throw new Error(`Path segment "${segment}" is not allowed (prototype pollution guard)`);
|
|
575
|
+
return segments;
|
|
528
576
|
}
|
|
529
577
|
/**
|
|
530
578
|
* Navigate to a value in the JSON structure using path segments
|
package/dist/index.d.cts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { AFSAccessMode, AFSEntry, AFSExplainResult, AFSListResult, AFSModuleLoadParams, AFSSearchOptions, AFSStatResult, AFSWriteEntryPayload, ProviderManifest } from "@aigne/afs";
|
|
1
|
+
import { AFSAccessMode, AFSEntry, AFSExplainResult, AFSListResult, AFSModuleLoadParams, AFSSearchOptions, AFSStatResult, AFSWriteEntryPayload, ProviderManifest, ProviderTreeSchema } from "@aigne/afs";
|
|
2
2
|
import { AFSBaseProvider, RouteContext } from "@aigne/afs/provider";
|
|
3
3
|
import { z } from "zod";
|
|
4
4
|
|
|
@@ -47,6 +47,7 @@ declare class AFSJSON extends AFSBaseProvider {
|
|
|
47
47
|
agentSkills: boolean | undefined;
|
|
48
48
|
}, unknown>>;
|
|
49
49
|
static manifest(): ProviderManifest;
|
|
50
|
+
static treeSchema(): ProviderTreeSchema;
|
|
50
51
|
static load({
|
|
51
52
|
basePath,
|
|
52
53
|
config
|
|
@@ -153,6 +154,11 @@ declare class AFSJSON extends AFSBaseProvider {
|
|
|
153
154
|
/**
|
|
154
155
|
* Get path segments from normalized path
|
|
155
156
|
*/
|
|
157
|
+
/**
|
|
158
|
+
* Dangerous property names that must never be used as object keys.
|
|
159
|
+
* Prevents prototype pollution attacks (e.g., writing to /__proto__/polluted).
|
|
160
|
+
*/
|
|
161
|
+
private static readonly DANGEROUS_KEYS;
|
|
156
162
|
private getPathSegments;
|
|
157
163
|
/**
|
|
158
164
|
* Navigate to a value in the JSON structure using path segments
|
package/dist/index.d.cts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;
|
|
1
|
+
{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;UAoDiB,cAAA;EACf,IAAA;EACA,QAAA;EACA,WAAA;;;;;;;EAOA,UAAA,GAAa,aAAA;EAMb;;;AAuBF;;EAvBE,WAAA;AAAA;;;;;;;cAuBW,OAAA,SAAgB,eAAA;EAwDR,OAAA,EAAS,cAAA;IAAmB,GAAA;IAAc,SAAA;IAAoB,GAAA;EAAA;EAAA,OAvD1E,MAAA,CAAA,GAAM,CAAA,CAAA,OAAA;;;;;;;;;;;;;SAIN,QAAA,CAAA,GAAY,gBAAA;EAAA,OAoBZ,UAAA,CAAA,GAAc,kBAAA;EAAA,OAaR,IAAA,CAAA;IAAO,QAAA;IAAU;EAAA,IAAU,mBAAA,GAAwB,OAAA,CAAA,OAAA;EAAA,SAKvD,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA,EAAY,aAAA;EAAA,SACZ,WAAA;EAAA,QAED,QAAA;EAAA,QACA,SAAA;EAAA,QAIA,UAAA;EAAA,QACA,gBAAA;cAEW,OAAA,EAAS,cAAA;IAAmB,GAAA;IAAc,SAAA;IAAoB,GAAA;EAAA;EAxDtD;;;;;EA0HrB,eAAA,CAAgB,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,QAAA;EAmE/D,WAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KACnB,OAAA,CAAQ,aAAA;IAAkB,QAAA;EAAA;EAiFvB,WAAA,CAAY,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,QAAA;;;;;;;;;;EAwB3D,YAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,OAAA,EAAS,oBAAA,GACR,OAAA;IAAU,IAAA,EAAM,QAAA;EAAA;EAgDb,aAAA,CAAc,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA;IAAU,OAAA;EAAA;EA0B/D,aAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,OAAA,WACC,OAAA;IAAU,OAAA;EAAA;EAiCP,aAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,KAAA,UACA,OAAA,GAAU,gBAAA,GACT,OAAA;IAAU,IAAA,EAAM,QAAA;IAAY,OAAA;EAAA;EAuDzB,WAAA,CAAY,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,aAAA;EAmC3D,uBAAA,CAAwB,IAAA,EAAM,YAAA,GAAe,OAAA,CAAQ,QAAA;EA0BrD,cAAA,CAAe,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,gBAAA;EAvZzC;;;EAAA,QAmgBnB,YAAA;EAngB6D;;;EAAA,QAkhB7D,SAAA;EA9cN;;;;;;;EAAA,QAydM,QAAA;EAvYiD;;;;;;;EAAA,QAucjD,QAAA;EA5aL;;;;EAAA,QAseW,YAAA;EAtb0B;;;EAAA,QAid1B,UAAA;EAvbR;;;EACJ;;;;EAAA,wBAidsB,cAAA;EAAA,QAEhB,eAAA;EA/ac;;;EAAA,QAicd,cAAA;EA/bN;;;EAAA,QAudM,cAAA;EAtduB;;;EAAA,QAghBvB,iBAAA;EAzdU;;;EAAA,QAogBV,gBAAA;EAje4B;;;EAAA,QA0e5B,WAAA;EAhdF;;;EAAA,QA+dE,eAAA;AAAA"}
|
package/dist/index.d.mts
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { AFSAccessMode, AFSEntry, AFSExplainResult, AFSListResult, AFSModuleLoadParams, AFSSearchOptions, AFSStatResult, AFSWriteEntryPayload, ProviderManifest } from "@aigne/afs";
|
|
1
|
+
import { AFSAccessMode, AFSEntry, AFSExplainResult, AFSListResult, AFSModuleLoadParams, AFSSearchOptions, AFSStatResult, AFSWriteEntryPayload, ProviderManifest, ProviderTreeSchema } from "@aigne/afs";
|
|
2
2
|
import { AFSBaseProvider, RouteContext } from "@aigne/afs/provider";
|
|
3
3
|
import { z } from "zod";
|
|
4
4
|
|
|
@@ -47,6 +47,7 @@ declare class AFSJSON extends AFSBaseProvider {
|
|
|
47
47
|
agentSkills: boolean | undefined;
|
|
48
48
|
}, unknown>>;
|
|
49
49
|
static manifest(): ProviderManifest;
|
|
50
|
+
static treeSchema(): ProviderTreeSchema;
|
|
50
51
|
static load({
|
|
51
52
|
basePath,
|
|
52
53
|
config
|
|
@@ -153,6 +154,11 @@ declare class AFSJSON extends AFSBaseProvider {
|
|
|
153
154
|
/**
|
|
154
155
|
* Get path segments from normalized path
|
|
155
156
|
*/
|
|
157
|
+
/**
|
|
158
|
+
* Dangerous property names that must never be used as object keys.
|
|
159
|
+
* Prevents prototype pollution attacks (e.g., writing to /__proto__/polluted).
|
|
160
|
+
*/
|
|
161
|
+
private static readonly DANGEROUS_KEYS;
|
|
156
162
|
private getPathSegments;
|
|
157
163
|
/**
|
|
158
164
|
* Navigate to a value in the JSON structure using path segments
|
package/dist/index.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;UAoDiB,cAAA;EACf,IAAA;EACA,QAAA;EACA,WAAA;;;;;;;EAOA,UAAA,GAAa,aAAA;EAMb;;;AAuBF;;EAvBE,WAAA;AAAA;;;;;;;cAuBW,OAAA,SAAgB,eAAA;EAwDR,OAAA,EAAS,cAAA;IAAmB,GAAA;IAAc,SAAA;IAAoB,GAAA;EAAA;EAAA,OAvD1E,MAAA,CAAA,GAAM,CAAA,CAAA,OAAA;;;;;;;;;;;;;SAIN,QAAA,CAAA,GAAY,gBAAA;EAAA,OAoBZ,UAAA,CAAA,GAAc,kBAAA;EAAA,OAaR,IAAA,CAAA;IAAO,QAAA;IAAU;EAAA,IAAU,mBAAA,GAAwB,OAAA,CAAA,OAAA;EAAA,SAKvD,IAAA;EAAA,SACA,WAAA;EAAA,SACA,UAAA,EAAY,aAAA;EAAA,SACZ,WAAA;EAAA,QAED,QAAA;EAAA,QACA,SAAA;EAAA,QAIA,UAAA;EAAA,QACA,gBAAA;cAEW,OAAA,EAAS,cAAA;IAAmB,GAAA;IAAc,SAAA;IAAoB,GAAA;EAAA;EAxDtD;;;;;EA0HrB,eAAA,CAAgB,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,QAAA;EAmE/D,WAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KACnB,OAAA,CAAQ,aAAA;IAAkB,QAAA;EAAA;EAiFvB,WAAA,CAAY,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,QAAA;;;;;;;;;;EAwB3D,YAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,OAAA,EAAS,oBAAA,GACR,OAAA;IAAU,IAAA,EAAM,QAAA;EAAA;EAgDb,aAAA,CAAc,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA;IAAU,OAAA;EAAA;EA0B/D,aAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,OAAA,WACC,OAAA;IAAU,OAAA;EAAA;EAiCP,aAAA,CACJ,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,IACpB,KAAA,UACA,OAAA,GAAU,gBAAA,GACT,OAAA;IAAU,IAAA,EAAM,QAAA;IAAY,OAAA;EAAA;EAuDzB,WAAA,CAAY,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,aAAA;EAmC3D,uBAAA,CAAwB,IAAA,EAAM,YAAA,GAAe,OAAA,CAAQ,QAAA;EA0BrD,cAAA,CAAe,GAAA,EAAK,YAAA;IAAe,IAAA;EAAA,KAAmB,OAAA,CAAQ,gBAAA;EAvZzC;;;EAAA,QAmgBnB,YAAA;EAngB6D;;;EAAA,QAkhB7D,SAAA;EA9cN;;;;;;;EAAA,QAydM,QAAA;EAvYiD;;;;;;;EAAA,QAucjD,QAAA;EA5aL;;;;EAAA,QAseW,YAAA;EAtb0B;;;EAAA,QAid1B,UAAA;EAvbR;;;EACJ;;;;EAAA,wBAidsB,cAAA;EAAA,QAEhB,eAAA;EA/ac;;;EAAA,QAicd,cAAA;EA/bN;;;EAAA,QAudM,cAAA;EAtduB;;;EAAA,QAghBvB,iBAAA;EAzdU;;;EAAA,QAogBV,gBAAA;EAje4B;;;EAAA,QA0e5B,WAAA;EAhdF;;;EAAA,QA+dE,eAAA;AAAA"}
|
package/dist/index.mjs
CHANGED
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
import { __decorate } from "./_virtual/_@oxc-project_runtime@0.108.0/helpers/decorate.mjs";
|
|
2
2
|
import { existsSync, mkdirSync, writeFileSync } from "node:fs";
|
|
3
3
|
import { readFile, stat, writeFile } from "node:fs/promises";
|
|
4
|
-
import { basename, dirname, extname
|
|
4
|
+
import { basename, dirname, extname } from "node:path";
|
|
5
5
|
import { AFSNotFoundError } from "@aigne/afs";
|
|
6
6
|
import { AFSBaseProvider, Delete, Explain, List, Meta, Read, Rename, Search, Stat, Write } from "@aigne/afs/provider";
|
|
7
7
|
import { camelize, optionalize, zodParse } from "@aigne/afs/utils/zod";
|
|
8
|
+
import { resolveLocalPath } from "@aigne/afs-provider-utils";
|
|
8
9
|
import { joinURL } from "ufo";
|
|
9
10
|
import { parse, stringify } from "yaml";
|
|
10
11
|
import { z } from "zod";
|
|
@@ -45,7 +46,46 @@ var AFSJSON = class AFSJSON extends AFSBaseProvider {
|
|
|
45
46
|
"json",
|
|
46
47
|
"yaml",
|
|
47
48
|
"structured-data"
|
|
48
|
-
]
|
|
49
|
+
],
|
|
50
|
+
capabilityTags: [
|
|
51
|
+
"read-write",
|
|
52
|
+
"crud",
|
|
53
|
+
"search",
|
|
54
|
+
"auth:none",
|
|
55
|
+
"local"
|
|
56
|
+
],
|
|
57
|
+
security: {
|
|
58
|
+
riskLevel: "sandboxed",
|
|
59
|
+
resourceAccess: []
|
|
60
|
+
},
|
|
61
|
+
capabilities: { filesystem: {
|
|
62
|
+
read: true,
|
|
63
|
+
write: true
|
|
64
|
+
} }
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
static treeSchema() {
|
|
68
|
+
return {
|
|
69
|
+
operations: [
|
|
70
|
+
"list",
|
|
71
|
+
"read",
|
|
72
|
+
"write",
|
|
73
|
+
"delete",
|
|
74
|
+
"search",
|
|
75
|
+
"stat",
|
|
76
|
+
"explain"
|
|
77
|
+
],
|
|
78
|
+
tree: {
|
|
79
|
+
"/": { kind: "json:root" },
|
|
80
|
+
"/{key}": { kind: "json:value" }
|
|
81
|
+
},
|
|
82
|
+
auth: { type: "none" },
|
|
83
|
+
bestFor: [
|
|
84
|
+
"JSON/YAML navigation",
|
|
85
|
+
"structured data editing",
|
|
86
|
+
"config files"
|
|
87
|
+
],
|
|
88
|
+
notFor: ["binary files", "large datasets"]
|
|
49
89
|
};
|
|
50
90
|
}
|
|
51
91
|
static async load({ basePath, config } = {}) {
|
|
@@ -67,10 +107,7 @@ var AFSJSON = class AFSJSON extends AFSBaseProvider {
|
|
|
67
107
|
this.options = options;
|
|
68
108
|
if (options.localPath && !options.jsonPath) options.jsonPath = options.localPath;
|
|
69
109
|
zodParse(afsJSONOptionsSchema, options);
|
|
70
|
-
|
|
71
|
-
jsonPath = options.jsonPath.replaceAll("${CWD}", process.cwd());
|
|
72
|
-
if (jsonPath.startsWith("~/")) jsonPath = join(process.env.HOME || "", jsonPath.slice(2));
|
|
73
|
-
if (!isAbsolute(jsonPath)) jsonPath = join(options.cwd || process.cwd(), jsonPath);
|
|
110
|
+
const jsonPath = resolveLocalPath(options.jsonPath, { cwd: options.cwd });
|
|
74
111
|
if (!existsSync(jsonPath)) {
|
|
75
112
|
mkdirSync(dirname(jsonPath), { recursive: true });
|
|
76
113
|
writeFileSync(jsonPath, "{}", "utf8");
|
|
@@ -520,10 +557,21 @@ var AFSJSON = class AFSJSON extends AFSBaseProvider {
|
|
|
520
557
|
/**
|
|
521
558
|
* Get path segments from normalized path
|
|
522
559
|
*/
|
|
560
|
+
/**
|
|
561
|
+
* Dangerous property names that must never be used as object keys.
|
|
562
|
+
* Prevents prototype pollution attacks (e.g., writing to /__proto__/polluted).
|
|
563
|
+
*/
|
|
564
|
+
static DANGEROUS_KEYS = new Set([
|
|
565
|
+
"__proto__",
|
|
566
|
+
"constructor",
|
|
567
|
+
"prototype"
|
|
568
|
+
]);
|
|
523
569
|
getPathSegments(path) {
|
|
524
570
|
const normalized = this.normalizePath(path);
|
|
525
571
|
if (normalized === "/") return [];
|
|
526
|
-
|
|
572
|
+
const segments = normalized.slice(1).split("/");
|
|
573
|
+
for (const segment of segments) if (AFSJSON.DANGEROUS_KEYS.has(segment)) throw new Error(`Path segment "${segment}" is not allowed (prototype pollution guard)`);
|
|
574
|
+
return segments;
|
|
527
575
|
}
|
|
528
576
|
/**
|
|
529
577
|
* Navigate to a value in the JSON structure using path segments
|
package/dist/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.mjs","names":["afs","meta","parseYAML","stringifyYAML"],"sources":["../src/index.ts"],"sourcesContent":["import { existsSync, mkdirSync, writeFileSync } from \"node:fs\";\nimport { readFile, stat, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, extname, isAbsolute, join } from \"node:path\";\nimport {\n type AFSAccessMode,\n type AFSDeleteOptions,\n type AFSEntry,\n type AFSEntryMetadata,\n type AFSExplainOptions,\n type AFSExplainResult,\n type AFSListResult,\n type AFSModuleClass,\n type AFSModuleLoadParams,\n AFSNotFoundError,\n type AFSRenameOptions,\n type AFSSearchOptions,\n type AFSStatResult,\n type AFSWriteEntryPayload,\n type CapabilitiesManifest,\n type ProviderManifest,\n} from \"@aigne/afs\";\nimport {\n AFSBaseProvider,\n Delete,\n Explain,\n List,\n Meta,\n Read,\n Rename,\n type RouteContext,\n Search,\n Stat,\n Write,\n} from \"@aigne/afs/provider\";\nimport { camelize, optionalize, zodParse } from \"@aigne/afs/utils/zod\";\nimport { joinURL } from \"ufo\";\nimport { parse as parseYAML, stringify as stringifyYAML } from \"yaml\";\nimport { z } from \"zod\";\n\nconst LIST_MAX_LIMIT = 1000;\n\n/** Hidden key for storing AFS metadata (mirrors FS provider's .afs directory) */\nconst AFS_KEY = \".afs\";\n\n/** Subkey for storing metadata (mirrors FS provider's meta.yaml file) */\nconst META_KEY = \"meta\";\n\n/** Subkey for storing child node metadata (mirrors FS provider's .nodes directory) */\nconst NODES_KEY = \".nodes\";\n\nexport interface AFSJSONOptions {\n name?: string;\n jsonPath: string;\n description?: string;\n /**\n * Access mode for this module.\n * - \"readonly\": Only read operations are allowed\n * - \"readwrite\": All operations are allowed (default, unless agentSkills is enabled)\n * @default \"readwrite\" (or \"readonly\" when agentSkills is true)\n */\n accessMode?: AFSAccessMode;\n /**\n * Enable automatic agent skill scanning for this module.\n * When enabled, defaults accessMode to \"readonly\" if not explicitly set.\n * @default false\n */\n agentSkills?: boolean;\n}\n\nconst afsJSONOptionsSchema = camelize(\n z.object({\n name: optionalize(z.string()),\n jsonPath: z.string().describe(\"The path to the JSON/YAML file to mount\"),\n description: optionalize(z.string().describe(\"A description of the JSON module\")),\n accessMode: optionalize(\n z.enum([\"readonly\", \"readwrite\"]).describe(\"Access mode for this module\"),\n ),\n agentSkills: optionalize(\n z.boolean().describe(\"Enable automatic agent skill scanning for this module\"),\n ),\n }),\n);\n\n/**\n * AFS module for mounting JSON/YAML files as virtual file systems.\n *\n * JSON/YAML objects are treated as directories, and properties/array items as files.\n * Supports nested structures and path-based access to data values.\n */\nexport class AFSJSON extends AFSBaseProvider {\n static schema() {\n return afsJSONOptionsSchema;\n }\n\n static manifest(): ProviderManifest {\n return {\n name: \"json\",\n description:\n \"JSON or YAML file — navigate and edit structured data as a tree.\\n- Objects and arrays become directories, primitives become leaf nodes\\n- Read/write individual values, search across structure\\n- Path structure: `/{key}/{nested-key}` (arrays indexed by position)\",\n uriTemplate: \"json://{localPath+}\",\n category: \"structured-data\",\n schema: z.object({ localPath: z.string() }),\n tags: [\"json\", \"yaml\", \"structured-data\"],\n };\n }\n\n static async load({ basePath, config }: AFSModuleLoadParams = {}) {\n const valid = await AFSJSON.schema().parseAsync(config);\n return new AFSJSON({ ...valid, cwd: basePath });\n }\n\n readonly name: string;\n readonly description?: string;\n readonly accessMode: AFSAccessMode;\n readonly agentSkills?: boolean;\n\n private jsonData: any = null;\n private fileStats: {\n birthtime?: Date;\n mtime?: Date;\n } = {};\n private fileFormat: \"json\" | \"yaml\" = \"json\";\n private resolvedJsonPath: string;\n\n constructor(public options: AFSJSONOptions & { cwd?: string; localPath?: string; uri?: string }) {\n super();\n\n // Normalize registry-passed template vars: localPath → jsonPath\n if ((options as any).localPath && !options.jsonPath) {\n options.jsonPath = (options as any).localPath;\n }\n\n zodParse(afsJSONOptionsSchema, options);\n\n let jsonPath: string;\n\n jsonPath = options.jsonPath.replaceAll(\"${CWD}\", process.cwd());\n if (jsonPath.startsWith(\"~/\")) {\n jsonPath = join(process.env.HOME || \"\", jsonPath.slice(2));\n }\n if (!isAbsolute(jsonPath)) {\n jsonPath = join(options.cwd || process.cwd(), jsonPath);\n }\n\n // Auto-create JSON file if it doesn't exist\n if (!existsSync(jsonPath)) {\n mkdirSync(dirname(jsonPath), { recursive: true });\n writeFileSync(jsonPath, \"{}\", \"utf8\");\n }\n\n // Detect file format based on extension for writing\n const ext = extname(jsonPath).toLowerCase();\n this.fileFormat = ext === \".yaml\" || ext === \".yml\" ? \"yaml\" : \"json\";\n\n // Extract name without extension\n const extensions = [\".json\", \".yaml\", \".yml\"];\n let name = basename(jsonPath);\n for (const e of extensions) {\n if (name.endsWith(e)) {\n name = name.slice(0, -e.length);\n break;\n }\n }\n\n this.name = options.name || name || \"json\";\n this.description = options.description;\n this.agentSkills = options.agentSkills;\n // Default to \"readwrite\", but \"readonly\" if agentSkills is enabled\n this.accessMode = options.accessMode ?? (options.agentSkills ? \"readonly\" : \"readwrite\");\n this.resolvedJsonPath = jsonPath;\n }\n\n // ========== Meta Handlers ==========\n // Meta is read-only introspection. Metadata writes are handled by @Write via payload.meta.\n //\n // Meta storage strategy (mirrors FS provider's .afs directory):\n // - For objects (directories): metadata stored in `.afs.meta` key within the object\n // - For primitives (files): metadata stored in parent's `.afs[\".nodes\"][key].meta` structure\n //\n // Example JSON structure:\n // {\n // \"database\": {\n // \"host\": \"localhost\",\n // \".afs\": {\n // \"meta\": { \"description\": \"Database config\" }, // object's own meta\n // \".nodes\": {\n // \"host\": { \"meta\": { \"description\": \"DB hostname\" } } // primitive's meta\n // }\n // }\n // }\n // }\n\n /**\n * Read metadata for a JSON node via /.meta or /path/.meta\n * Returns stored metadata merged with computed type information\n * Note: Meta is read-only. To write metadata, use write() with payload.meta.\n */\n @Meta(\"/:path*\")\n async readMetaHandler(ctx: RouteContext<{ path?: string }>): Promise<AFSEntry | undefined> {\n await this.ensureLoaded();\n\n const nodePath = joinURL(\"/\", ctx.params.path ?? \"\");\n const segments = this.getPathSegments(nodePath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(nodePath);\n }\n\n const isDir = this.isDirectoryValue(value);\n const children = isDir ? this.getChildren(value) : [];\n\n // Determine the JSON type\n let type: string;\n if (Array.isArray(value)) {\n type = \"array\";\n } else if (value === null) {\n type = \"null\";\n } else if (typeof value === \"object\") {\n type = \"object\";\n } else {\n type = typeof value;\n }\n\n // Load stored user-defined metadata\n const storedMeta = this.loadMeta(nodePath) || {};\n\n // Build computed metadata (type info, etc.)\n const computedMeta: Record<string, unknown> = {\n type,\n path: nodePath,\n };\n\n if (isDir) {\n computedMeta.childrenCount = children.length;\n if (Array.isArray(value)) {\n computedMeta.length = value.length;\n } else {\n // Filter out internal keys from keys list\n computedMeta.keys = Object.keys(value).filter((k) => !this.isMetaKey(k));\n }\n } else {\n computedMeta.value = value;\n }\n\n if (this.fileStats.birthtime) {\n computedMeta.created = this.fileStats.birthtime;\n }\n if (this.fileStats.mtime) {\n computedMeta.modified = this.fileStats.mtime;\n }\n\n return this.buildEntry(joinURL(nodePath, \".meta\"), {\n // User-defined metadata goes in metadata field (for conformance)\n meta: storedMeta as AFSEntryMetadata,\n // Computed type info goes in content (JSON-specific)\n content: computedMeta,\n createdAt: this.fileStats.birthtime,\n updatedAt: this.fileStats.mtime,\n });\n }\n\n // ========== Route Handlers ==========\n\n @List(\"/:path*\", { handleDepth: true })\n async listHandler(\n ctx: RouteContext<{ path?: string }>,\n ): Promise<AFSListResult & { noExpand?: string[] }> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const options = ctx.options as { limit?: number; maxChildren?: number; maxDepth?: number };\n const limit = Math.min(options?.limit || LIST_MAX_LIMIT, LIST_MAX_LIMIT);\n const maxChildren =\n typeof options?.maxChildren === \"number\" ? options.maxChildren : Number.MAX_SAFE_INTEGER;\n const maxDepth = options?.maxDepth ?? 1;\n\n const segments = this.getPathSegments(normalizedPath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n // Note: list() returns only children, never the path itself (per new semantics)\n // maxDepth=0 means no children, maxDepth=1 means immediate children only, etc.\n if (maxDepth === 0) {\n return { data: [] };\n }\n\n // If the value is not a directory, it has no children\n if (!this.isDirectoryValue(value)) {\n return { data: [] };\n }\n\n const entries: AFSEntry[] = [];\n\n interface QueueItem {\n path: string;\n value: any;\n depth: number;\n }\n\n // Start with immediate children at depth 1 (not the path itself at depth 0)\n const rootChildren = this.getChildren(value);\n const rootChildrenToProcess =\n rootChildren.length > maxChildren ? rootChildren.slice(0, maxChildren) : rootChildren;\n\n const queue: QueueItem[] = rootChildrenToProcess.map((child) => ({\n path: normalizedPath === \"/\" ? `/${child.key}` : `${normalizedPath}/${child.key}`,\n value: child.value,\n depth: 1,\n }));\n\n while (queue.length > 0) {\n const item = queue.shift();\n if (!item) break;\n\n const { path: itemPath, value: itemValue, depth } = item;\n\n const entry = this.valueToAFSEntry(itemPath, itemValue);\n entries.push(entry);\n\n if (entries.length >= limit) {\n break;\n }\n\n // Process children if within depth limit\n if (this.isDirectoryValue(itemValue) && depth < maxDepth) {\n const children = this.getChildren(itemValue);\n const childrenToProcess =\n children.length > maxChildren ? children.slice(0, maxChildren) : children;\n\n for (const child of childrenToProcess) {\n const childPath = itemPath === \"/\" ? `/${child.key}` : `${itemPath}/${child.key}`;\n queue.push({\n path: childPath,\n value: child.value,\n depth: depth + 1,\n });\n }\n }\n }\n\n return { data: entries };\n }\n\n @Read(\"/:path*\")\n async readHandler(ctx: RouteContext<{ path?: string }>): Promise<AFSEntry | undefined> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const segments = this.getPathSegments(normalizedPath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n return this.valueToAFSEntry(normalizedPath, value);\n }\n\n /**\n * Write handler - supports writing content and/or metadata\n *\n * | payload | behavior |\n * |---------|----------|\n * | { content } | write content only |\n * | { metadata } | write metadata only (to .afs storage) |\n * | { content, metadata } | write both |\n */\n @Write(\"/:path*\")\n async writeHandler(\n ctx: RouteContext<{ path?: string }>,\n payload: AFSWriteEntryPayload,\n ): Promise<{ data: AFSEntry }> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const segments = this.getPathSegments(normalizedPath);\n\n // Write content if provided\n if (payload.content !== undefined) {\n this.setValueAtPath(this.jsonData, segments, payload.content);\n }\n\n // Write metadata if provided (merge with existing)\n if (payload.meta !== undefined && typeof payload.meta === \"object\") {\n const existingMeta = this.loadMeta(normalizedPath) || {};\n const finalMeta = { ...existingMeta, ...payload.meta };\n this.saveMeta(normalizedPath, finalMeta);\n }\n\n // Save back to file\n await this.saveToFile();\n\n const newValue = this.getValueAtPath(this.jsonData, segments);\n const isDir = this.isDirectoryValue(newValue);\n const children = isDir ? this.getChildren(newValue) : [];\n\n // Load stored metadata for response\n const storedMeta = this.loadMeta(normalizedPath) || {};\n\n const writtenEntry: AFSEntry = {\n id: normalizedPath,\n path: normalizedPath,\n content: payload.content !== undefined ? payload.content : newValue,\n summary: payload.summary,\n createdAt: this.fileStats.birthtime,\n updatedAt: this.fileStats.mtime,\n meta: {\n ...storedMeta,\n childrenCount: isDir ? children.length : undefined,\n } as AFSEntryMetadata,\n userId: payload.userId,\n sessionId: payload.sessionId,\n linkTo: payload.linkTo,\n };\n\n return { data: writtenEntry };\n }\n\n @Delete(\"/:path*\")\n async deleteHandler(ctx: RouteContext<{ path?: string }>): Promise<{ message: string }> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const options = ctx.options as AFSDeleteOptions | undefined;\n const segments = this.getPathSegments(normalizedPath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n const hasChildren = this.isDirectoryValue(value) && this.getChildren(value).length > 0;\n if (hasChildren && !options?.recursive) {\n throw new Error(\n `Cannot delete directory '${normalizedPath}' without recursive option. Set recursive: true to delete directories.`,\n );\n }\n\n this.deleteValueAtPath(this.jsonData, segments);\n await this.saveToFile();\n\n return { message: `Successfully deleted: ${normalizedPath}` };\n }\n\n @Rename(\"/:path*\")\n async renameHandler(\n ctx: RouteContext<{ path?: string }>,\n newPath: string,\n ): Promise<{ message: string }> {\n await this.ensureLoaded();\n\n const normalizedOldPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const normalizedNewPath = this.normalizePath(newPath);\n const options = ctx.options as AFSRenameOptions | undefined;\n\n const oldSegments = this.getPathSegments(normalizedOldPath);\n const newSegments = this.getPathSegments(normalizedNewPath);\n\n const oldValue = this.getValueAtPath(this.jsonData, oldSegments);\n if (oldValue === undefined) {\n throw new AFSNotFoundError(normalizedOldPath);\n }\n\n const existingNewValue = this.getValueAtPath(this.jsonData, newSegments);\n if (existingNewValue !== undefined && !options?.overwrite) {\n throw new Error(\n `Destination '${normalizedNewPath}' already exists. Set overwrite: true to replace it.`,\n );\n }\n\n // Copy to new location and delete old\n this.setValueAtPath(this.jsonData, newSegments, oldValue);\n this.deleteValueAtPath(this.jsonData, oldSegments);\n await this.saveToFile();\n\n return {\n message: `Successfully renamed '${normalizedOldPath}' to '${normalizedNewPath}'`,\n };\n }\n\n @Search(\"/:path*\")\n async searchHandler(\n ctx: RouteContext<{ path?: string }>,\n query: string,\n options?: AFSSearchOptions,\n ): Promise<{ data: AFSEntry[]; message?: string }> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const limit = Math.min(options?.limit || LIST_MAX_LIMIT, LIST_MAX_LIMIT);\n const caseSensitive = options?.caseSensitive ?? false;\n\n const segments = this.getPathSegments(normalizedPath);\n const rootValue = this.getValueAtPath(this.jsonData, segments);\n\n if (rootValue === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n const entries: AFSEntry[] = [];\n const searchQuery = caseSensitive ? query : query.toLowerCase();\n\n const searchInValue = (valuePath: string, value: any): void => {\n if (entries.length >= limit) return;\n\n let matched = false;\n\n // Search in the value itself\n if (!this.isDirectoryValue(value)) {\n const valueStr = typeof value === \"string\" ? value : JSON.stringify(value);\n const searchValue = caseSensitive ? valueStr : valueStr.toLowerCase();\n if (searchValue.includes(searchQuery)) {\n matched = true;\n }\n }\n\n if (matched) {\n entries.push(this.valueToAFSEntry(valuePath, value));\n }\n\n // Recursively search children\n if (this.isDirectoryValue(value)) {\n const children = this.getChildren(value);\n for (const child of children) {\n if (entries.length >= limit) break;\n const childPath = valuePath === \"/\" ? `/${child.key}` : `${valuePath}/${child.key}`;\n searchInValue(childPath, child.value);\n }\n }\n };\n\n searchInValue(normalizedPath, rootValue);\n\n return {\n data: entries,\n message: entries.length >= limit ? `Results truncated to limit ${limit}` : undefined,\n };\n }\n\n @Stat(\"/:path*\")\n async statHandler(ctx: RouteContext<{ path?: string }>): Promise<AFSStatResult> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const segments = this.getPathSegments(normalizedPath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n const isDir = this.isDirectoryValue(value);\n const children = isDir ? this.getChildren(value) : [];\n const loadedMeta = this.loadMeta(normalizedPath);\n const meta: Record<string, unknown> = { ...loadedMeta };\n if (isDir) {\n meta.childrenCount = children.length;\n }\n\n const id = segments.length > 0 ? (segments[segments.length - 1] as string) : \"/\";\n\n return {\n data: {\n id,\n path: normalizedPath,\n createdAt: this.fileStats.birthtime,\n updatedAt: this.fileStats.mtime,\n meta,\n },\n };\n }\n\n // ========== Explain & Capabilities ==========\n\n @Read(\"/.meta/.capabilities\")\n async readCapabilitiesHandler(_ctx: RouteContext): Promise<AFSEntry | undefined> {\n await this.ensureLoaded();\n\n const operations = [\"list\", \"read\", \"stat\", \"explain\", \"search\"];\n if (this.accessMode === \"readwrite\") {\n operations.push(\"write\", \"delete\", \"rename\");\n }\n\n const manifest: CapabilitiesManifest = {\n schemaVersion: 1,\n provider: this.name,\n description: this.description || `JSON/YAML virtual filesystem (${this.fileFormat} format)`,\n tools: [],\n actions: [],\n operations: this.getOperationsDeclaration(),\n };\n\n return {\n id: \"/.meta/.capabilities\",\n path: \"/.meta/.capabilities\",\n content: manifest,\n meta: { kind: \"afs:capabilities\", operations },\n };\n }\n\n @Explain(\"/:path*\")\n async explainHandler(ctx: RouteContext<{ path?: string }>): Promise<AFSExplainResult> {\n await this.ensureLoaded();\n\n const normalizedPath = joinURL(\"/\", ctx.params.path ?? \"\");\n const format = (ctx.options as AFSExplainOptions)?.format || \"markdown\";\n const segments = this.getPathSegments(normalizedPath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n const nodeName = segments.length > 0 ? segments[segments.length - 1]! : \"/\";\n const isDir = this.isDirectoryValue(value);\n const storedMeta = this.loadMeta(normalizedPath);\n const lines: string[] = [];\n\n if (format === \"markdown\") {\n lines.push(`# ${nodeName}`);\n lines.push(\"\");\n lines.push(`**Path:** \\`${normalizedPath}\\``);\n lines.push(`**Format:** ${this.fileFormat.toUpperCase()}`);\n\n if (normalizedPath === \"/\") {\n // Root: describe file path, format, top-level structure\n const topType = Array.isArray(this.jsonData) ? \"array\" : \"object\";\n const children = this.getChildren(this.jsonData);\n lines.push(`**Structure:** ${topType}`);\n lines.push(`**Top-level keys:** ${children.length}`);\n if (children.length > 0) {\n lines.push(\"\");\n lines.push(\"## Keys\");\n lines.push(\"\");\n for (const child of children.slice(0, 30)) {\n const childVal = child.value;\n const childType = this.describeType(childVal);\n lines.push(`- \\`${child.key}\\` — ${childType}`);\n }\n if (children.length > 30) {\n lines.push(`- ... and ${children.length - 30} more`);\n }\n }\n } else if (Array.isArray(value)) {\n // Array node\n lines.push(`**Type:** array`);\n lines.push(`**Elements:** ${value.length}`);\n if (value.length > 0) {\n const elementType = this.describeType(value[0]);\n const isHomogeneous = value.every((v: unknown) => this.describeType(v) === elementType);\n lines.push(`**Element type:** ${isHomogeneous ? elementType : \"mixed\"}`);\n }\n } else if (typeof value === \"object\" && value !== null) {\n // Object node\n const children = this.getChildren(value);\n lines.push(`**Type:** object`);\n lines.push(`**Keys:** ${children.length}`);\n if (children.length > 0) {\n lines.push(\"\");\n lines.push(\"## Keys\");\n lines.push(\"\");\n for (const child of children.slice(0, 30)) {\n const childType = this.describeType(child.value);\n lines.push(`- \\`${child.key}\\` — ${childType}`);\n }\n if (children.length > 30) {\n lines.push(`- ... and ${children.length - 30} more`);\n }\n }\n } else {\n // Primitive node\n const valType = value === null ? \"null\" : typeof value;\n lines.push(`**Type:** ${valType}`);\n const valStr = String(value);\n if (valStr.length > 200) {\n lines.push(`**Value:** ${valStr.slice(0, 200)}...`);\n } else {\n lines.push(`**Value:** ${valStr}`);\n }\n }\n\n if (storedMeta) {\n lines.push(\"\");\n lines.push(\"## Metadata\");\n for (const [key, val] of Object.entries(storedMeta)) {\n lines.push(`- **${key}:** ${JSON.stringify(val)}`);\n }\n }\n } else {\n // text format\n lines.push(`${nodeName} (${isDir ? \"directory\" : \"value\"})`);\n lines.push(`Path: ${normalizedPath}`);\n lines.push(`Format: ${this.fileFormat}`);\n if (isDir) {\n const children = this.getChildren(value);\n lines.push(`Children: ${children.length}`);\n } else {\n const valStr = String(value);\n lines.push(`Type: ${value === null ? \"null\" : typeof value}`);\n lines.push(`Value: ${valStr.length > 200 ? `${valStr.slice(0, 200)}...` : valStr}`);\n }\n }\n\n return { content: lines.join(\"\\n\"), format };\n }\n\n /**\n * Get a human-readable type description for a JSON value.\n */\n private describeType(value: unknown): string {\n if (value === null) return \"null\";\n if (Array.isArray(value)) return `array[${value.length}]`;\n if (typeof value === \"object\") {\n const keys = Object.keys(value).filter((k) => !this.isMetaKey(k));\n return `object{${keys.length} keys}`;\n }\n return typeof value;\n }\n\n // ========== Private Helper Methods ==========\n\n /**\n * Check if a key is a hidden meta key that should be filtered from listings\n */\n private isMetaKey(key: string): boolean {\n return key === AFS_KEY;\n }\n\n /**\n * Load metadata for a node.\n *\n * Storage location depends on node type (mirrors FS provider's .afs structure):\n * - Objects: `.afs.meta` key within the object itself\n * - Primitives: parent's `.afs[\".nodes\"][key].meta`\n */\n private loadMeta(nodePath: string): Record<string, unknown> | null {\n const segments = this.getPathSegments(nodePath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n return null;\n }\n\n if (this.isDirectoryValue(value) && !Array.isArray(value)) {\n // Object: meta is in value[\".afs\"].meta\n const afs = value[AFS_KEY];\n if (afs && typeof afs === \"object\" && !Array.isArray(afs)) {\n const meta = afs[META_KEY];\n if (meta && typeof meta === \"object\" && !Array.isArray(meta)) {\n return meta as Record<string, unknown>;\n }\n }\n return null;\n }\n\n // Primitive or array: meta is in parent's .afs[\".nodes\"][key].meta\n if (segments.length === 0) {\n // Root is always an object, handled above\n return null;\n }\n\n const parentSegments = segments.slice(0, -1);\n const nodeKey = segments[segments.length - 1]!;\n const parentValue = this.getValueAtPath(this.jsonData, parentSegments);\n\n if (!parentValue || Array.isArray(parentValue) || typeof parentValue !== \"object\") {\n return null;\n }\n\n const afs = parentValue[AFS_KEY];\n if (!afs || typeof afs !== \"object\" || Array.isArray(afs)) {\n return null;\n }\n\n const nodes = afs[NODES_KEY];\n if (!nodes || typeof nodes !== \"object\" || Array.isArray(nodes)) {\n return null;\n }\n\n const nodeEntry = nodes[nodeKey];\n if (!nodeEntry || typeof nodeEntry !== \"object\" || Array.isArray(nodeEntry)) {\n return null;\n }\n\n const meta = nodeEntry[META_KEY];\n if (!meta || typeof meta !== \"object\" || Array.isArray(meta)) {\n return null;\n }\n\n return meta as Record<string, unknown>;\n }\n\n /**\n * Save metadata for a node.\n *\n * Storage location depends on node type (mirrors FS provider's .afs structure):\n * - Objects: `.afs.meta` key within the object itself\n * - Primitives: parent's `.afs[\".nodes\"][key].meta`\n */\n private saveMeta(nodePath: string, meta: Record<string, unknown>): void {\n const segments = this.getPathSegments(nodePath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(nodePath);\n }\n\n if (this.isDirectoryValue(value) && !Array.isArray(value)) {\n // Object: store in value[\".afs\"].meta\n if (!value[AFS_KEY]) {\n value[AFS_KEY] = {};\n }\n // Store in .meta key\n value[AFS_KEY][META_KEY] = meta;\n return;\n }\n\n // Primitive or array: store in parent's .afs[\".nodes\"][key].meta\n if (segments.length === 0) {\n throw new Error(\"Cannot save meta for root when root is not an object\");\n }\n\n const parentSegments = segments.slice(0, -1);\n const nodeKey = segments[segments.length - 1]!;\n const parentValue = this.getValueAtPath(this.jsonData, parentSegments);\n\n if (!parentValue || typeof parentValue !== \"object\") {\n throw new Error(`Parent path is not an object`);\n }\n\n if (Array.isArray(parentValue)) {\n throw new Error(`Cannot save meta for array elements`);\n }\n\n // Ensure .afs exists\n if (!parentValue[AFS_KEY]) {\n parentValue[AFS_KEY] = {};\n }\n\n // Ensure .afs[\".nodes\"] exists\n if (!parentValue[AFS_KEY][NODES_KEY]) {\n parentValue[AFS_KEY][NODES_KEY] = {};\n }\n\n // Ensure .afs[\".nodes\"][nodeKey] exists\n if (!parentValue[AFS_KEY][NODES_KEY][nodeKey]) {\n parentValue[AFS_KEY][NODES_KEY][nodeKey] = {};\n }\n\n // Store the meta in .meta key\n parentValue[AFS_KEY][NODES_KEY][nodeKey][META_KEY] = meta;\n }\n\n /**\n * Load JSON/YAML data from file. Called lazily on first access.\n * Uses YAML parser which can handle both JSON and YAML formats.\n */\n private async ensureLoaded(): Promise<void> {\n if (this.jsonData !== null) return;\n\n try {\n const stats = await stat(this.resolvedJsonPath);\n this.fileStats = {\n birthtime: stats.birthtime,\n mtime: stats.mtime,\n };\n\n const content = await readFile(this.resolvedJsonPath, \"utf8\");\n\n // YAML parser can handle both JSON and YAML formats\n this.jsonData = parseYAML(content);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n // File doesn't exist yet, start with empty object\n this.jsonData = {};\n } else {\n throw error;\n }\n }\n }\n\n /**\n * Save JSON/YAML data back to file. Only called in readwrite mode.\n */\n private async saveToFile(): Promise<void> {\n let content: string;\n\n // Serialize based on file format\n if (this.fileFormat === \"yaml\") {\n content = stringifyYAML(this.jsonData);\n } else {\n content = JSON.stringify(this.jsonData, null, 2);\n }\n\n await writeFile(this.resolvedJsonPath, content, \"utf8\");\n\n // Update file stats\n const stats = await stat(this.resolvedJsonPath);\n this.fileStats = {\n birthtime: this.fileStats.birthtime || stats.birthtime,\n mtime: stats.mtime,\n };\n }\n\n /**\n * Get path segments from normalized path\n */\n private getPathSegments(path: string): string[] {\n const normalized = this.normalizePath(path);\n if (normalized === \"/\") return [];\n return normalized.slice(1).split(\"/\");\n }\n\n /**\n * Navigate to a value in the JSON structure using path segments\n */\n private getValueAtPath(data: any, segments: string[]): any {\n let current = data;\n for (const segment of segments) {\n if (current == null) return undefined;\n\n // Handle array indices\n if (Array.isArray(current)) {\n const index = Number.parseInt(segment, 10);\n if (Number.isNaN(index) || index < 0 || index >= current.length) {\n return undefined;\n }\n current = current[index];\n } else if (typeof current === \"object\") {\n current = current[segment as keyof typeof current];\n } else {\n return undefined;\n }\n }\n return current;\n }\n\n /**\n * Set a value in the JSON structure at the given path\n */\n private setValueAtPath(data: any, segments: string[], value: any): void {\n if (segments.length === 0) {\n throw new Error(\"Cannot set value at root path\");\n }\n\n let current = data;\n for (let i = 0; i < segments.length - 1; i++) {\n const segment = segments[i]!;\n const nextSegment = segments[i + 1]!;\n\n if (Array.isArray(current)) {\n const index = Number.parseInt(segment, 10);\n if (Number.isNaN(index) || index < 0) {\n throw new Error(`Invalid array index: ${segment}`);\n }\n\n // Extend array if necessary\n while (current.length <= index) {\n current.push(null);\n }\n\n if (current[index] == null) {\n // Determine if next level should be array or object\n const isNextArray = !Number.isNaN(Number.parseInt(nextSegment, 10));\n current[index] = isNextArray ? [] : {};\n }\n current = current[index];\n } else if (typeof current === \"object\") {\n if (current[segment] == null) {\n // Determine if next level should be array or object\n const isNextArray = !Number.isNaN(Number.parseInt(nextSegment, 10));\n current[segment] = isNextArray ? [] : {};\n }\n current = current[segment];\n } else {\n throw new Error(\n `Cannot set property on non-object at ${segments.slice(0, i + 1).join(\"/\")}`,\n );\n }\n }\n\n const lastSegment = segments[segments.length - 1]!;\n if (Array.isArray(current)) {\n const index = Number.parseInt(lastSegment, 10);\n if (Number.isNaN(index) || index < 0) {\n throw new Error(`Invalid array index: ${lastSegment}`);\n }\n current[index] = value;\n } else if (typeof current === \"object\") {\n current[lastSegment] = value;\n } else {\n throw new Error(\"Cannot set property on non-object\");\n }\n }\n\n /**\n * Delete a value from the JSON structure at the given path\n */\n private deleteValueAtPath(data: any, segments: string[]): boolean {\n if (segments.length === 0) {\n throw new Error(\"Cannot delete root path\");\n }\n\n let current = data;\n for (let i = 0; i < segments.length - 1; i++) {\n const segment = segments[i]!;\n\n if (Array.isArray(current)) {\n const index = Number.parseInt(segment, 10);\n if (Number.isNaN(index) || index < 0 || index >= current.length) {\n return false;\n }\n current = current[index];\n } else if (typeof current === \"object\") {\n if (!(segment in current)) return false;\n current = current[segment];\n } else {\n return false;\n }\n }\n\n const lastSegment = segments[segments.length - 1]!;\n if (Array.isArray(current)) {\n const index = Number.parseInt(lastSegment, 10);\n if (Number.isNaN(index) || index < 0 || index >= current.length) {\n return false;\n }\n current.splice(index, 1);\n return true;\n }\n if (typeof current === \"object\") {\n if (!(lastSegment in current)) return false;\n delete current[lastSegment];\n return true;\n }\n return false;\n }\n\n /**\n * Check if a value is a \"directory\" (object or array with children)\n */\n private isDirectoryValue(value: any): boolean {\n if (Array.isArray(value)) return true;\n if (typeof value === \"object\" && value !== null) return true;\n return false;\n }\n\n /**\n * Get children of a directory value (filters out .afs meta key)\n */\n private getChildren(value: any): Array<{ key: string; value: any }> {\n if (Array.isArray(value)) {\n return value.map((item, index) => ({ key: String(index), value: item }));\n }\n if (typeof value === \"object\" && value !== null) {\n return Object.entries(value)\n .filter(([key]) => !this.isMetaKey(key))\n .map(([key, val]) => ({ key, value: val }));\n }\n return [];\n }\n\n /**\n * Convert a JSON value to an AFSEntry\n */\n private valueToAFSEntry(path: string, value: any): AFSEntry {\n const isDir = this.isDirectoryValue(value);\n const children = isDir ? this.getChildren(value) : [];\n const kind = Array.isArray(value) ? \"json:array\" : isDir ? \"json:object\" : \"json:value\";\n\n return this.buildEntry(path, {\n content: isDir ? undefined : value,\n meta: {\n kind,\n childrenCount: isDir ? children.length : undefined,\n },\n createdAt: this.fileStats.birthtime,\n updatedAt: this.fileStats.mtime,\n });\n }\n}\n\nconst _typeCheck: AFSModuleClass<AFSJSON, AFSJSONOptions> = AFSJSON;\n\nexport default AFSJSON;\n"],"mappings":";;;;;;;;;;;;AAuCA,MAAM,iBAAiB;;AAGvB,MAAM,UAAU;;AAGhB,MAAM,WAAW;;AAGjB,MAAM,YAAY;AAqBlB,MAAM,uBAAuB,SAC3B,EAAE,OAAO;CACP,MAAM,YAAY,EAAE,QAAQ,CAAC;CAC7B,UAAU,EAAE,QAAQ,CAAC,SAAS,0CAA0C;CACxE,aAAa,YAAY,EAAE,QAAQ,CAAC,SAAS,mCAAmC,CAAC;CACjF,YAAY,YACV,EAAE,KAAK,CAAC,YAAY,YAAY,CAAC,CAAC,SAAS,8BAA8B,CAC1E;CACD,aAAa,YACX,EAAE,SAAS,CAAC,SAAS,wDAAwD,CAC9E;CACF,CAAC,CACH;;;;;;;AAQD,IAAa,UAAb,MAAa,gBAAgB,gBAAgB;CAC3C,OAAO,SAAS;AACd,SAAO;;CAGT,OAAO,WAA6B;AAClC,SAAO;GACL,MAAM;GACN,aACE;GACF,aAAa;GACb,UAAU;GACV,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;GAC3C,MAAM;IAAC;IAAQ;IAAQ;IAAkB;GAC1C;;CAGH,aAAa,KAAK,EAAE,UAAU,WAAgC,EAAE,EAAE;AAEhE,SAAO,IAAI,QAAQ;GAAE,GADP,MAAM,QAAQ,QAAQ,CAAC,WAAW,OAAO;GACxB,KAAK;GAAU,CAAC;;CAGjD,AAAS;CACT,AAAS;CACT,AAAS;CACT,AAAS;CAET,AAAQ,WAAgB;CACxB,AAAQ,YAGJ,EAAE;CACN,AAAQ,aAA8B;CACtC,AAAQ;CAER,YAAY,AAAO,SAA8E;AAC/F,SAAO;EADU;AAIjB,MAAK,QAAgB,aAAa,CAAC,QAAQ,SACzC,SAAQ,WAAY,QAAgB;AAGtC,WAAS,sBAAsB,QAAQ;EAEvC,IAAI;AAEJ,aAAW,QAAQ,SAAS,WAAW,UAAU,QAAQ,KAAK,CAAC;AAC/D,MAAI,SAAS,WAAW,KAAK,CAC3B,YAAW,KAAK,QAAQ,IAAI,QAAQ,IAAI,SAAS,MAAM,EAAE,CAAC;AAE5D,MAAI,CAAC,WAAW,SAAS,CACvB,YAAW,KAAK,QAAQ,OAAO,QAAQ,KAAK,EAAE,SAAS;AAIzD,MAAI,CAAC,WAAW,SAAS,EAAE;AACzB,aAAU,QAAQ,SAAS,EAAE,EAAE,WAAW,MAAM,CAAC;AACjD,iBAAc,UAAU,MAAM,OAAO;;EAIvC,MAAM,MAAM,QAAQ,SAAS,CAAC,aAAa;AAC3C,OAAK,aAAa,QAAQ,WAAW,QAAQ,SAAS,SAAS;EAG/D,MAAM,aAAa;GAAC;GAAS;GAAS;GAAO;EAC7C,IAAI,OAAO,SAAS,SAAS;AAC7B,OAAK,MAAM,KAAK,WACd,KAAI,KAAK,SAAS,EAAE,EAAE;AACpB,UAAO,KAAK,MAAM,GAAG,CAAC,EAAE,OAAO;AAC/B;;AAIJ,OAAK,OAAO,QAAQ,QAAQ,QAAQ;AACpC,OAAK,cAAc,QAAQ;AAC3B,OAAK,cAAc,QAAQ;AAE3B,OAAK,aAAa,QAAQ,eAAe,QAAQ,cAAc,aAAa;AAC5E,OAAK,mBAAmB;;;;;;;CA4B1B,MACM,gBAAgB,KAAqE;AACzF,QAAM,KAAK,cAAc;EAEzB,MAAM,WAAW,QAAQ,KAAK,IAAI,OAAO,QAAQ,GAAG;EACpD,MAAM,WAAW,KAAK,gBAAgB,SAAS;EAC/C,MAAM,QAAQ,KAAK,eAAe,KAAK,UAAU,SAAS;AAE1D,MAAI,UAAU,OACZ,OAAM,IAAI,iBAAiB,SAAS;EAGtC,MAAM,QAAQ,KAAK,iBAAiB,MAAM;EAC1C,MAAM,WAAW,QAAQ,KAAK,YAAY,MAAM,GAAG,EAAE;EAGrD,IAAI;AACJ,MAAI,MAAM,QAAQ,MAAM,CACtB,QAAO;WACE,UAAU,KACnB,QAAO;WACE,OAAO,UAAU,SAC1B,QAAO;MAEP,QAAO,OAAO;EAIhB,MAAM,aAAa,KAAK,SAAS,SAAS,IAAI,EAAE;EAGhD,MAAM,eAAwC;GAC5C;GACA,MAAM;GACP;AAED,MAAI,OAAO;AACT,gBAAa,gBAAgB,SAAS;AACtC,OAAI,MAAM,QAAQ,MAAM,CACtB,cAAa,SAAS,MAAM;OAG5B,cAAa,OAAO,OAAO,KAAK,MAAM,CAAC,QAAQ,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC;QAG1E,cAAa,QAAQ;AAGvB,MAAI,KAAK,UAAU,UACjB,cAAa,UAAU,KAAK,UAAU;AAExC,MAAI,KAAK,UAAU,MACjB,cAAa,WAAW,KAAK,UAAU;AAGzC,SAAO,KAAK,WAAW,QAAQ,UAAU,QAAQ,EAAE;GAEjD,MAAM;GAEN,SAAS;GACT,WAAW,KAAK,UAAU;GAC1B,WAAW,KAAK,UAAU;GAC3B,CAAC;;CAKJ,MACM,YACJ,KACkD;AAClD,QAAM,KAAK,cAAc;EAEzB,MAAM,iBAAiB,IAAI,OAAO,OAAO,IAAI,IAAI,OAAO,SAAS;EACjE,MAAM,UAAU,IAAI;EACpB,MAAM,QAAQ,KAAK,IAAI,SAAS,SAAS,gBAAgB,eAAe;EACxE,MAAM,cACJ,OAAO,SAAS,gBAAgB,WAAW,QAAQ,cAAc,OAAO;EAC1E,MAAM,WAAW,SAAS,YAAY;EAEtC,MAAM,WAAW,KAAK,gBAAgB,eAAe;EACrD,MAAM,QAAQ,KAAK,eAAe,KAAK,UAAU,SAAS;AAE1D,MAAI,UAAU,OACZ,OAAM,IAAI,iBAAiB,eAAe;AAK5C,MAAI,aAAa,EACf,QAAO,EAAE,MAAM,EAAE,EAAE;AAIrB,MAAI,CAAC,KAAK,iBAAiB,MAAM,CAC/B,QAAO,EAAE,MAAM,EAAE,EAAE;EAGrB,MAAM,UAAsB,EAAE;EAS9B,MAAM,eAAe,KAAK,YAAY,MAAM;EAI5C,MAAM,SAFJ,aAAa,SAAS,cAAc,aAAa,MAAM,GAAG,YAAY,GAAG,cAE1B,KAAK,WAAW;GAC/D,MAAM,mBAAmB,MAAM,IAAI,MAAM,QAAQ,GAAG,eAAe,GAAG,MAAM;GAC5E,OAAO,MAAM;GACb,OAAO;GACR,EAAE;AAEH,SAAO,MAAM,SAAS,GAAG;GACvB,MAAM,OAAO,MAAM,OAAO;AAC1B,OAAI,CAAC,KAAM;GAEX,MAAM,EAAE,MAAM,UAAU,OAAO,WAAW,UAAU;GAEpD,MAAM,QAAQ,KAAK,gBAAgB,UAAU,UAAU;AACvD,WAAQ,KAAK,MAAM;AAEnB,OAAI,QAAQ,UAAU,MACpB;AAIF,OAAI,KAAK,iBAAiB,UAAU,IAAI,QAAQ,UAAU;IACxD,MAAM,WAAW,KAAK,YAAY,UAAU;IAC5C,MAAM,oBACJ,SAAS,SAAS,cAAc,SAAS,MAAM,GAAG,YAAY,GAAG;AAEnE,SAAK,MAAM,SAAS,mBAAmB;KACrC,MAAM,YAAY,aAAa,MAAM,IAAI,MAAM,QAAQ,GAAG,SAAS,GAAG,MAAM;AAC5E,WAAM,KAAK;MACT,MAAM;MACN,OAAO,MAAM;MACb,OAAO,QAAQ;MAChB,CAAC;;;;AAKR,SAAO,EAAE,MAAM,SAAS;;CAG1B,MACM,YAAY,KAAqE;AACrF,QAAM,KAAK,cAAc;EAEzB,MAAM,iBAAiB,IAAI,OAAO,OAAO,IAAI,IAAI,OAAO,SAAS;EACjE,MAAM,WAAW,KAAK,gBAAgB,eAAe;EACrD,MAAM,QAAQ,KAAK,eAAe,KAAK,UAAU,SAAS;AAE1D,MAAI,UAAU,OACZ,OAAM,IAAI,iBAAiB,eAAe;AAG5C,SAAO,KAAK,gBAAgB,gBAAgB,MAAM;;;;;;;;;;;CAYpD,MACM,aACJ,KACA,SAC6B;AAC7B,QAAM,KAAK,cAAc;EAEzB,MAAM,iBAAiB,IAAI,OAAO,OAAO,IAAI,IAAI,OAAO,SAAS;EACjE,MAAM,WAAW,KAAK,gBAAgB,eAAe;AAGrD,MAAI,QAAQ,YAAY,OACtB,MAAK,eAAe,KAAK,UAAU,UAAU,QAAQ,QAAQ;AAI/D,MAAI,QAAQ,SAAS,UAAa,OAAO,QAAQ,SAAS,UAAU;GAElE,MAAM,YAAY;IAAE,GADC,KAAK,SAAS,eAAe,IAAI,EAAE;IACnB,GAAG,QAAQ;IAAM;AACtD,QAAK,SAAS,gBAAgB,UAAU;;AAI1C,QAAM,KAAK,YAAY;EAEvB,MAAM,WAAW,KAAK,eAAe,KAAK,UAAU,SAAS;EAC7D,MAAM,QAAQ,KAAK,iBAAiB,SAAS;EAC7C,MAAM,WAAW,QAAQ,KAAK,YAAY,SAAS,GAAG,EAAE;EAGxD,MAAM,aAAa,KAAK,SAAS,eAAe,IAAI,EAAE;AAkBtD,SAAO,EAAE,MAhBsB;GAC7B,IAAI;GACJ,MAAM;GACN,SAAS,QAAQ,YAAY,SAAY,QAAQ,UAAU;GAC3D,SAAS,QAAQ;GACjB,WAAW,KAAK,UAAU;GAC1B,WAAW,KAAK,UAAU;GAC1B,MAAM;IACJ,GAAG;IACH,eAAe,QAAQ,SAAS,SAAS;IAC1C;GACD,QAAQ,QAAQ;GAChB,WAAW,QAAQ;GACnB,QAAQ,QAAQ;GACjB,EAE4B;;CAG/B,MACM,cAAc,KAAoE;AACtF,QAAM,KAAK,cAAc;EAEzB,MAAM,iBAAiB,IAAI,OAAO,OAAO,IAAI,IAAI,OAAO,SAAS;EACjE,MAAM,UAAU,IAAI;EACpB,MAAM,WAAW,KAAK,gBAAgB,eAAe;EACrD,MAAM,QAAQ,KAAK,eAAe,KAAK,UAAU,SAAS;AAE1D,MAAI,UAAU,OACZ,OAAM,IAAI,iBAAiB,eAAe;AAI5C,MADoB,KAAK,iBAAiB,MAAM,IAAI,KAAK,YAAY,MAAM,CAAC,SAAS,KAClE,CAAC,SAAS,UAC3B,OAAM,IAAI,MACR,4BAA4B,eAAe,wEAC5C;AAGH,OAAK,kBAAkB,KAAK,UAAU,SAAS;AAC/C,QAAM,KAAK,YAAY;AAEvB,SAAO,EAAE,SAAS,yBAAyB,kBAAkB;;CAG/D,MACM,cACJ,KACA,SAC8B;AAC9B,QAAM,KAAK,cAAc;EAEzB,MAAM,oBAAoB,IAAI,OAAO,OAAO,IAAI,IAAI,OAAO,SAAS;EACpE,MAAM,oBAAoB,KAAK,cAAc,QAAQ;EACrD,MAAM,UAAU,IAAI;EAEpB,MAAM,cAAc,KAAK,gBAAgB,kBAAkB;EAC3D,MAAM,cAAc,KAAK,gBAAgB,kBAAkB;EAE3D,MAAM,WAAW,KAAK,eAAe,KAAK,UAAU,YAAY;AAChE,MAAI,aAAa,OACf,OAAM,IAAI,iBAAiB,kBAAkB;AAI/C,MADyB,KAAK,eAAe,KAAK,UAAU,YAAY,KAC/C,UAAa,CAAC,SAAS,UAC9C,OAAM,IAAI,MACR,gBAAgB,kBAAkB,sDACnC;AAIH,OAAK,eAAe,KAAK,UAAU,aAAa,SAAS;AACzD,OAAK,kBAAkB,KAAK,UAAU,YAAY;AAClD,QAAM,KAAK,YAAY;AAEvB,SAAO,EACL,SAAS,yBAAyB,kBAAkB,QAAQ,kBAAkB,IAC/E;;CAGH,MACM,cACJ,KACA,OACA,SACiD;AACjD,QAAM,KAAK,cAAc;EAEzB,MAAM,iBAAiB,IAAI,OAAO,OAAO,IAAI,IAAI,OAAO,SAAS;EACjE,MAAM,QAAQ,KAAK,IAAI,SAAS,SAAS,gBAAgB,eAAe;EACxE,MAAM,gBAAgB,SAAS,iBAAiB;EAEhD,MAAM,WAAW,KAAK,gBAAgB,eAAe;EACrD,MAAM,YAAY,KAAK,eAAe,KAAK,UAAU,SAAS;AAE9D,MAAI,cAAc,OAChB,OAAM,IAAI,iBAAiB,eAAe;EAG5C,MAAM,UAAsB,EAAE;EAC9B,MAAM,cAAc,gBAAgB,QAAQ,MAAM,aAAa;EAE/D,MAAM,iBAAiB,WAAmB,UAAqB;AAC7D,OAAI,QAAQ,UAAU,MAAO;GAE7B,IAAI,UAAU;AAGd,OAAI,CAAC,KAAK,iBAAiB,MAAM,EAAE;IACjC,MAAM,WAAW,OAAO,UAAU,WAAW,QAAQ,KAAK,UAAU,MAAM;AAE1E,SADoB,gBAAgB,WAAW,SAAS,aAAa,EACrD,SAAS,YAAY,CACnC,WAAU;;AAId,OAAI,QACF,SAAQ,KAAK,KAAK,gBAAgB,WAAW,MAAM,CAAC;AAItD,OAAI,KAAK,iBAAiB,MAAM,EAAE;IAChC,MAAM,WAAW,KAAK,YAAY,MAAM;AACxC,SAAK,MAAM,SAAS,UAAU;AAC5B,SAAI,QAAQ,UAAU,MAAO;AAE7B,mBADkB,cAAc,MAAM,IAAI,MAAM,QAAQ,GAAG,UAAU,GAAG,MAAM,OACrD,MAAM,MAAM;;;;AAK3C,gBAAc,gBAAgB,UAAU;AAExC,SAAO;GACL,MAAM;GACN,SAAS,QAAQ,UAAU,QAAQ,8BAA8B,UAAU;GAC5E;;CAGH,MACM,YAAY,KAA8D;AAC9E,QAAM,KAAK,cAAc;EAEzB,MAAM,iBAAiB,IAAI,OAAO,OAAO,IAAI,IAAI,OAAO,SAAS;EACjE,MAAM,WAAW,KAAK,gBAAgB,eAAe;EACrD,MAAM,QAAQ,KAAK,eAAe,KAAK,UAAU,SAAS;AAE1D,MAAI,UAAU,OACZ,OAAM,IAAI,iBAAiB,eAAe;EAG5C,MAAM,QAAQ,KAAK,iBAAiB,MAAM;EAC1C,MAAM,WAAW,QAAQ,KAAK,YAAY,MAAM,GAAG,EAAE;EAErD,MAAM,OAAgC,EAAE,GADrB,KAAK,SAAS,eAAe,EACO;AACvD,MAAI,MACF,MAAK,gBAAgB,SAAS;AAKhC,SAAO,EACL,MAAM;GACJ,IAJO,SAAS,SAAS,IAAK,SAAS,SAAS,SAAS,KAAgB;GAKzE,MAAM;GACN,WAAW,KAAK,UAAU;GAC1B,WAAW,KAAK,UAAU;GAC1B;GACD,EACF;;CAKH,MACM,wBAAwB,MAAmD;AAC/E,QAAM,KAAK,cAAc;EAEzB,MAAM,aAAa;GAAC;GAAQ;GAAQ;GAAQ;GAAW;GAAS;AAChE,MAAI,KAAK,eAAe,YACtB,YAAW,KAAK,SAAS,UAAU,SAAS;AAY9C,SAAO;GACL,IAAI;GACJ,MAAM;GACN,SAZqC;IACrC,eAAe;IACf,UAAU,KAAK;IACf,aAAa,KAAK,eAAe,iCAAiC,KAAK,WAAW;IAClF,OAAO,EAAE;IACT,SAAS,EAAE;IACX,YAAY,KAAK,0BAA0B;IAC5C;GAMC,MAAM;IAAE,MAAM;IAAoB;IAAY;GAC/C;;CAGH,MACM,eAAe,KAAiE;AACpF,QAAM,KAAK,cAAc;EAEzB,MAAM,iBAAiB,QAAQ,KAAK,IAAI,OAAO,QAAQ,GAAG;EAC1D,MAAM,SAAU,IAAI,SAA+B,UAAU;EAC7D,MAAM,WAAW,KAAK,gBAAgB,eAAe;EACrD,MAAM,QAAQ,KAAK,eAAe,KAAK,UAAU,SAAS;AAE1D,MAAI,UAAU,OACZ,OAAM,IAAI,iBAAiB,eAAe;EAG5C,MAAM,WAAW,SAAS,SAAS,IAAI,SAAS,SAAS,SAAS,KAAM;EACxE,MAAM,QAAQ,KAAK,iBAAiB,MAAM;EAC1C,MAAM,aAAa,KAAK,SAAS,eAAe;EAChD,MAAM,QAAkB,EAAE;AAE1B,MAAI,WAAW,YAAY;AACzB,SAAM,KAAK,KAAK,WAAW;AAC3B,SAAM,KAAK,GAAG;AACd,SAAM,KAAK,eAAe,eAAe,IAAI;AAC7C,SAAM,KAAK,eAAe,KAAK,WAAW,aAAa,GAAG;AAE1D,OAAI,mBAAmB,KAAK;IAE1B,MAAM,UAAU,MAAM,QAAQ,KAAK,SAAS,GAAG,UAAU;IACzD,MAAM,WAAW,KAAK,YAAY,KAAK,SAAS;AAChD,UAAM,KAAK,kBAAkB,UAAU;AACvC,UAAM,KAAK,uBAAuB,SAAS,SAAS;AACpD,QAAI,SAAS,SAAS,GAAG;AACvB,WAAM,KAAK,GAAG;AACd,WAAM,KAAK,UAAU;AACrB,WAAM,KAAK,GAAG;AACd,UAAK,MAAM,SAAS,SAAS,MAAM,GAAG,GAAG,EAAE;MACzC,MAAM,WAAW,MAAM;MACvB,MAAM,YAAY,KAAK,aAAa,SAAS;AAC7C,YAAM,KAAK,OAAO,MAAM,IAAI,OAAO,YAAY;;AAEjD,SAAI,SAAS,SAAS,GACpB,OAAM,KAAK,aAAa,SAAS,SAAS,GAAG,OAAO;;cAG/C,MAAM,QAAQ,MAAM,EAAE;AAE/B,UAAM,KAAK,kBAAkB;AAC7B,UAAM,KAAK,iBAAiB,MAAM,SAAS;AAC3C,QAAI,MAAM,SAAS,GAAG;KACpB,MAAM,cAAc,KAAK,aAAa,MAAM,GAAG;KAC/C,MAAM,gBAAgB,MAAM,OAAO,MAAe,KAAK,aAAa,EAAE,KAAK,YAAY;AACvF,WAAM,KAAK,qBAAqB,gBAAgB,cAAc,UAAU;;cAEjE,OAAO,UAAU,YAAY,UAAU,MAAM;IAEtD,MAAM,WAAW,KAAK,YAAY,MAAM;AACxC,UAAM,KAAK,mBAAmB;AAC9B,UAAM,KAAK,aAAa,SAAS,SAAS;AAC1C,QAAI,SAAS,SAAS,GAAG;AACvB,WAAM,KAAK,GAAG;AACd,WAAM,KAAK,UAAU;AACrB,WAAM,KAAK,GAAG;AACd,UAAK,MAAM,SAAS,SAAS,MAAM,GAAG,GAAG,EAAE;MACzC,MAAM,YAAY,KAAK,aAAa,MAAM,MAAM;AAChD,YAAM,KAAK,OAAO,MAAM,IAAI,OAAO,YAAY;;AAEjD,SAAI,SAAS,SAAS,GACpB,OAAM,KAAK,aAAa,SAAS,SAAS,GAAG,OAAO;;UAGnD;IAEL,MAAM,UAAU,UAAU,OAAO,SAAS,OAAO;AACjD,UAAM,KAAK,aAAa,UAAU;IAClC,MAAM,SAAS,OAAO,MAAM;AAC5B,QAAI,OAAO,SAAS,IAClB,OAAM,KAAK,cAAc,OAAO,MAAM,GAAG,IAAI,CAAC,KAAK;QAEnD,OAAM,KAAK,cAAc,SAAS;;AAItC,OAAI,YAAY;AACd,UAAM,KAAK,GAAG;AACd,UAAM,KAAK,cAAc;AACzB,SAAK,MAAM,CAAC,KAAK,QAAQ,OAAO,QAAQ,WAAW,CACjD,OAAM,KAAK,OAAO,IAAI,MAAM,KAAK,UAAU,IAAI,GAAG;;SAGjD;AAEL,SAAM,KAAK,GAAG,SAAS,IAAI,QAAQ,cAAc,QAAQ,GAAG;AAC5D,SAAM,KAAK,SAAS,iBAAiB;AACrC,SAAM,KAAK,WAAW,KAAK,aAAa;AACxC,OAAI,OAAO;IACT,MAAM,WAAW,KAAK,YAAY,MAAM;AACxC,UAAM,KAAK,aAAa,SAAS,SAAS;UACrC;IACL,MAAM,SAAS,OAAO,MAAM;AAC5B,UAAM,KAAK,SAAS,UAAU,OAAO,SAAS,OAAO,QAAQ;AAC7D,UAAM,KAAK,UAAU,OAAO,SAAS,MAAM,GAAG,OAAO,MAAM,GAAG,IAAI,CAAC,OAAO,SAAS;;;AAIvF,SAAO;GAAE,SAAS,MAAM,KAAK,KAAK;GAAE;GAAQ;;;;;CAM9C,AAAQ,aAAa,OAAwB;AAC3C,MAAI,UAAU,KAAM,QAAO;AAC3B,MAAI,MAAM,QAAQ,MAAM,CAAE,QAAO,SAAS,MAAM,OAAO;AACvD,MAAI,OAAO,UAAU,SAEnB,QAAO,UADM,OAAO,KAAK,MAAM,CAAC,QAAQ,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,CAC3C,OAAO;AAE/B,SAAO,OAAO;;;;;CAQhB,AAAQ,UAAU,KAAsB;AACtC,SAAO,QAAQ;;;;;;;;;CAUjB,AAAQ,SAAS,UAAkD;EACjE,MAAM,WAAW,KAAK,gBAAgB,SAAS;EAC/C,MAAM,QAAQ,KAAK,eAAe,KAAK,UAAU,SAAS;AAE1D,MAAI,UAAU,OACZ,QAAO;AAGT,MAAI,KAAK,iBAAiB,MAAM,IAAI,CAAC,MAAM,QAAQ,MAAM,EAAE;GAEzD,MAAMA,QAAM,MAAM;AAClB,OAAIA,SAAO,OAAOA,UAAQ,YAAY,CAAC,MAAM,QAAQA,MAAI,EAAE;IACzD,MAAMC,SAAOD,MAAI;AACjB,QAAIC,UAAQ,OAAOA,WAAS,YAAY,CAAC,MAAM,QAAQA,OAAK,CAC1D,QAAOA;;AAGX,UAAO;;AAIT,MAAI,SAAS,WAAW,EAEtB,QAAO;EAGT,MAAM,iBAAiB,SAAS,MAAM,GAAG,GAAG;EAC5C,MAAM,UAAU,SAAS,SAAS,SAAS;EAC3C,MAAM,cAAc,KAAK,eAAe,KAAK,UAAU,eAAe;AAEtE,MAAI,CAAC,eAAe,MAAM,QAAQ,YAAY,IAAI,OAAO,gBAAgB,SACvE,QAAO;EAGT,MAAM,MAAM,YAAY;AACxB,MAAI,CAAC,OAAO,OAAO,QAAQ,YAAY,MAAM,QAAQ,IAAI,CACvD,QAAO;EAGT,MAAM,QAAQ,IAAI;AAClB,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,MAAM,CAC7D,QAAO;EAGT,MAAM,YAAY,MAAM;AACxB,MAAI,CAAC,aAAa,OAAO,cAAc,YAAY,MAAM,QAAQ,UAAU,CACzE,QAAO;EAGT,MAAM,OAAO,UAAU;AACvB,MAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,KAAK,CAC1D,QAAO;AAGT,SAAO;;;;;;;;;CAUT,AAAQ,SAAS,UAAkB,MAAqC;EACtE,MAAM,WAAW,KAAK,gBAAgB,SAAS;EAC/C,MAAM,QAAQ,KAAK,eAAe,KAAK,UAAU,SAAS;AAE1D,MAAI,UAAU,OACZ,OAAM,IAAI,iBAAiB,SAAS;AAGtC,MAAI,KAAK,iBAAiB,MAAM,IAAI,CAAC,MAAM,QAAQ,MAAM,EAAE;AAEzD,OAAI,CAAC,MAAM,SACT,OAAM,WAAW,EAAE;AAGrB,SAAM,SAAS,YAAY;AAC3B;;AAIF,MAAI,SAAS,WAAW,EACtB,OAAM,IAAI,MAAM,uDAAuD;EAGzE,MAAM,iBAAiB,SAAS,MAAM,GAAG,GAAG;EAC5C,MAAM,UAAU,SAAS,SAAS,SAAS;EAC3C,MAAM,cAAc,KAAK,eAAe,KAAK,UAAU,eAAe;AAEtE,MAAI,CAAC,eAAe,OAAO,gBAAgB,SACzC,OAAM,IAAI,MAAM,+BAA+B;AAGjD,MAAI,MAAM,QAAQ,YAAY,CAC5B,OAAM,IAAI,MAAM,sCAAsC;AAIxD,MAAI,CAAC,YAAY,SACf,aAAY,WAAW,EAAE;AAI3B,MAAI,CAAC,YAAY,SAAS,WACxB,aAAY,SAAS,aAAa,EAAE;AAItC,MAAI,CAAC,YAAY,SAAS,WAAW,SACnC,aAAY,SAAS,WAAW,WAAW,EAAE;AAI/C,cAAY,SAAS,WAAW,SAAS,YAAY;;;;;;CAOvD,MAAc,eAA8B;AAC1C,MAAI,KAAK,aAAa,KAAM;AAE5B,MAAI;GACF,MAAM,QAAQ,MAAM,KAAK,KAAK,iBAAiB;AAC/C,QAAK,YAAY;IACf,WAAW,MAAM;IACjB,OAAO,MAAM;IACd;AAKD,QAAK,WAAWC,MAHA,MAAM,SAAS,KAAK,kBAAkB,OAAO,CAG3B;WAC3B,OAAO;AACd,OAAK,MAAgC,SAAS,SAE5C,MAAK,WAAW,EAAE;OAElB,OAAM;;;;;;CAQZ,MAAc,aAA4B;EACxC,IAAI;AAGJ,MAAI,KAAK,eAAe,OACtB,WAAUC,UAAc,KAAK,SAAS;MAEtC,WAAU,KAAK,UAAU,KAAK,UAAU,MAAM,EAAE;AAGlD,QAAM,UAAU,KAAK,kBAAkB,SAAS,OAAO;EAGvD,MAAM,QAAQ,MAAM,KAAK,KAAK,iBAAiB;AAC/C,OAAK,YAAY;GACf,WAAW,KAAK,UAAU,aAAa,MAAM;GAC7C,OAAO,MAAM;GACd;;;;;CAMH,AAAQ,gBAAgB,MAAwB;EAC9C,MAAM,aAAa,KAAK,cAAc,KAAK;AAC3C,MAAI,eAAe,IAAK,QAAO,EAAE;AACjC,SAAO,WAAW,MAAM,EAAE,CAAC,MAAM,IAAI;;;;;CAMvC,AAAQ,eAAe,MAAW,UAAyB;EACzD,IAAI,UAAU;AACd,OAAK,MAAM,WAAW,UAAU;AAC9B,OAAI,WAAW,KAAM,QAAO;AAG5B,OAAI,MAAM,QAAQ,QAAQ,EAAE;IAC1B,MAAM,QAAQ,OAAO,SAAS,SAAS,GAAG;AAC1C,QAAI,OAAO,MAAM,MAAM,IAAI,QAAQ,KAAK,SAAS,QAAQ,OACvD;AAEF,cAAU,QAAQ;cACT,OAAO,YAAY,SAC5B,WAAU,QAAQ;OAElB;;AAGJ,SAAO;;;;;CAMT,AAAQ,eAAe,MAAW,UAAoB,OAAkB;AACtE,MAAI,SAAS,WAAW,EACtB,OAAM,IAAI,MAAM,gCAAgC;EAGlD,IAAI,UAAU;AACd,OAAK,IAAI,IAAI,GAAG,IAAI,SAAS,SAAS,GAAG,KAAK;GAC5C,MAAM,UAAU,SAAS;GACzB,MAAM,cAAc,SAAS,IAAI;AAEjC,OAAI,MAAM,QAAQ,QAAQ,EAAE;IAC1B,MAAM,QAAQ,OAAO,SAAS,SAAS,GAAG;AAC1C,QAAI,OAAO,MAAM,MAAM,IAAI,QAAQ,EACjC,OAAM,IAAI,MAAM,wBAAwB,UAAU;AAIpD,WAAO,QAAQ,UAAU,MACvB,SAAQ,KAAK,KAAK;AAGpB,QAAI,QAAQ,UAAU,KAGpB,SAAQ,SADY,CAAC,OAAO,MAAM,OAAO,SAAS,aAAa,GAAG,CAAC,GACpC,EAAE,GAAG,EAAE;AAExC,cAAU,QAAQ;cACT,OAAO,YAAY,UAAU;AACtC,QAAI,QAAQ,YAAY,KAGtB,SAAQ,WADY,CAAC,OAAO,MAAM,OAAO,SAAS,aAAa,GAAG,CAAC,GAClC,EAAE,GAAG,EAAE;AAE1C,cAAU,QAAQ;SAElB,OAAM,IAAI,MACR,wCAAwC,SAAS,MAAM,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,GAC3E;;EAIL,MAAM,cAAc,SAAS,SAAS,SAAS;AAC/C,MAAI,MAAM,QAAQ,QAAQ,EAAE;GAC1B,MAAM,QAAQ,OAAO,SAAS,aAAa,GAAG;AAC9C,OAAI,OAAO,MAAM,MAAM,IAAI,QAAQ,EACjC,OAAM,IAAI,MAAM,wBAAwB,cAAc;AAExD,WAAQ,SAAS;aACR,OAAO,YAAY,SAC5B,SAAQ,eAAe;MAEvB,OAAM,IAAI,MAAM,oCAAoC;;;;;CAOxD,AAAQ,kBAAkB,MAAW,UAA6B;AAChE,MAAI,SAAS,WAAW,EACtB,OAAM,IAAI,MAAM,0BAA0B;EAG5C,IAAI,UAAU;AACd,OAAK,IAAI,IAAI,GAAG,IAAI,SAAS,SAAS,GAAG,KAAK;GAC5C,MAAM,UAAU,SAAS;AAEzB,OAAI,MAAM,QAAQ,QAAQ,EAAE;IAC1B,MAAM,QAAQ,OAAO,SAAS,SAAS,GAAG;AAC1C,QAAI,OAAO,MAAM,MAAM,IAAI,QAAQ,KAAK,SAAS,QAAQ,OACvD,QAAO;AAET,cAAU,QAAQ;cACT,OAAO,YAAY,UAAU;AACtC,QAAI,EAAE,WAAW,SAAU,QAAO;AAClC,cAAU,QAAQ;SAElB,QAAO;;EAIX,MAAM,cAAc,SAAS,SAAS,SAAS;AAC/C,MAAI,MAAM,QAAQ,QAAQ,EAAE;GAC1B,MAAM,QAAQ,OAAO,SAAS,aAAa,GAAG;AAC9C,OAAI,OAAO,MAAM,MAAM,IAAI,QAAQ,KAAK,SAAS,QAAQ,OACvD,QAAO;AAET,WAAQ,OAAO,OAAO,EAAE;AACxB,UAAO;;AAET,MAAI,OAAO,YAAY,UAAU;AAC/B,OAAI,EAAE,eAAe,SAAU,QAAO;AACtC,UAAO,QAAQ;AACf,UAAO;;AAET,SAAO;;;;;CAMT,AAAQ,iBAAiB,OAAqB;AAC5C,MAAI,MAAM,QAAQ,MAAM,CAAE,QAAO;AACjC,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,SAAO;;;;;CAMT,AAAQ,YAAY,OAAgD;AAClE,MAAI,MAAM,QAAQ,MAAM,CACtB,QAAO,MAAM,KAAK,MAAM,WAAW;GAAE,KAAK,OAAO,MAAM;GAAE,OAAO;GAAM,EAAE;AAE1E,MAAI,OAAO,UAAU,YAAY,UAAU,KACzC,QAAO,OAAO,QAAQ,MAAM,CACzB,QAAQ,CAAC,SAAS,CAAC,KAAK,UAAU,IAAI,CAAC,CACvC,KAAK,CAAC,KAAK,UAAU;GAAE;GAAK,OAAO;GAAK,EAAE;AAE/C,SAAO,EAAE;;;;;CAMX,AAAQ,gBAAgB,MAAc,OAAsB;EAC1D,MAAM,QAAQ,KAAK,iBAAiB,MAAM;EAC1C,MAAM,WAAW,QAAQ,KAAK,YAAY,MAAM,GAAG,EAAE;EACrD,MAAM,OAAO,MAAM,QAAQ,MAAM,GAAG,eAAe,QAAQ,gBAAgB;AAE3E,SAAO,KAAK,WAAW,MAAM;GAC3B,SAAS,QAAQ,SAAY;GAC7B,MAAM;IACJ;IACA,eAAe,QAAQ,SAAS,SAAS;IAC1C;GACD,WAAW,KAAK,UAAU;GAC1B,WAAW,KAAK,UAAU;GAC3B,CAAC;;;YAr3BH,KAAK,UAAU;YAmEf,KAAK,WAAW,EAAE,aAAa,MAAM,CAAC;YAmFtC,KAAK,UAAU;YAwBf,MAAM,UAAU;YAmDhB,OAAO,UAAU;YA0BjB,OAAO,UAAU;YAoCjB,OAAO,UAAU;YA2DjB,KAAK,UAAU;YAmCf,KAAK,uBAAuB;YA0B5B,QAAQ,UAAU;AAoerB,kBAAe"}
|
|
1
|
+
{"version":3,"file":"index.mjs","names":["afs","meta","parseYAML","stringifyYAML"],"sources":["../src/index.ts"],"sourcesContent":["import { existsSync, mkdirSync, writeFileSync } from \"node:fs\";\nimport { readFile, stat, writeFile } from \"node:fs/promises\";\nimport { basename, dirname, extname } from \"node:path\";\nimport {\n type AFSAccessMode,\n type AFSDeleteOptions,\n type AFSEntry,\n type AFSEntryMetadata,\n type AFSExplainOptions,\n type AFSExplainResult,\n type AFSListResult,\n type AFSModuleClass,\n type AFSModuleLoadParams,\n AFSNotFoundError,\n type AFSRenameOptions,\n type AFSSearchOptions,\n type AFSStatResult,\n type AFSWriteEntryPayload,\n type CapabilitiesManifest,\n type ProviderManifest,\n type ProviderTreeSchema,\n} from \"@aigne/afs\";\nimport {\n AFSBaseProvider,\n Delete,\n Explain,\n List,\n Meta,\n Read,\n Rename,\n type RouteContext,\n Search,\n Stat,\n Write,\n} from \"@aigne/afs/provider\";\nimport { camelize, optionalize, zodParse } from \"@aigne/afs/utils/zod\";\nimport { resolveLocalPath } from \"@aigne/afs-provider-utils\";\nimport { joinURL } from \"ufo\";\nimport { parse as parseYAML, stringify as stringifyYAML } from \"yaml\";\nimport { z } from \"zod\";\n\nconst LIST_MAX_LIMIT = 1000;\n\n/** Hidden key for storing AFS metadata (mirrors FS provider's .afs directory) */\nconst AFS_KEY = \".afs\";\n\n/** Subkey for storing metadata (mirrors FS provider's meta.yaml file) */\nconst META_KEY = \"meta\";\n\n/** Subkey for storing child node metadata (mirrors FS provider's .nodes directory) */\nconst NODES_KEY = \".nodes\";\n\nexport interface AFSJSONOptions {\n name?: string;\n jsonPath: string;\n description?: string;\n /**\n * Access mode for this module.\n * - \"readonly\": Only read operations are allowed\n * - \"readwrite\": All operations are allowed (default, unless agentSkills is enabled)\n * @default \"readwrite\" (or \"readonly\" when agentSkills is true)\n */\n accessMode?: AFSAccessMode;\n /**\n * Enable automatic agent skill scanning for this module.\n * When enabled, defaults accessMode to \"readonly\" if not explicitly set.\n * @default false\n */\n agentSkills?: boolean;\n}\n\nconst afsJSONOptionsSchema = camelize(\n z.object({\n name: optionalize(z.string()),\n jsonPath: z.string().describe(\"The path to the JSON/YAML file to mount\"),\n description: optionalize(z.string().describe(\"A description of the JSON module\")),\n accessMode: optionalize(\n z.enum([\"readonly\", \"readwrite\"]).describe(\"Access mode for this module\"),\n ),\n agentSkills: optionalize(\n z.boolean().describe(\"Enable automatic agent skill scanning for this module\"),\n ),\n }),\n);\n\n/**\n * AFS module for mounting JSON/YAML files as virtual file systems.\n *\n * JSON/YAML objects are treated as directories, and properties/array items as files.\n * Supports nested structures and path-based access to data values.\n */\nexport class AFSJSON extends AFSBaseProvider {\n static schema() {\n return afsJSONOptionsSchema;\n }\n\n static manifest(): ProviderManifest {\n return {\n name: \"json\",\n description:\n \"JSON or YAML file — navigate and edit structured data as a tree.\\n- Objects and arrays become directories, primitives become leaf nodes\\n- Read/write individual values, search across structure\\n- Path structure: `/{key}/{nested-key}` (arrays indexed by position)\",\n uriTemplate: \"json://{localPath+}\",\n category: \"structured-data\",\n schema: z.object({ localPath: z.string() }),\n tags: [\"json\", \"yaml\", \"structured-data\"],\n capabilityTags: [\"read-write\", \"crud\", \"search\", \"auth:none\", \"local\"],\n security: {\n riskLevel: \"sandboxed\",\n resourceAccess: [],\n },\n capabilities: {\n filesystem: { read: true, write: true },\n },\n };\n }\n\n static treeSchema(): ProviderTreeSchema {\n return {\n operations: [\"list\", \"read\", \"write\", \"delete\", \"search\", \"stat\", \"explain\"],\n tree: {\n \"/\": { kind: \"json:root\" },\n \"/{key}\": { kind: \"json:value\" },\n },\n auth: { type: \"none\" },\n bestFor: [\"JSON/YAML navigation\", \"structured data editing\", \"config files\"],\n notFor: [\"binary files\", \"large datasets\"],\n };\n }\n\n static async load({ basePath, config }: AFSModuleLoadParams = {}) {\n const valid = await AFSJSON.schema().parseAsync(config);\n return new AFSJSON({ ...valid, cwd: basePath });\n }\n\n readonly name: string;\n readonly description?: string;\n readonly accessMode: AFSAccessMode;\n readonly agentSkills?: boolean;\n\n private jsonData: any = null;\n private fileStats: {\n birthtime?: Date;\n mtime?: Date;\n } = {};\n private fileFormat: \"json\" | \"yaml\" = \"json\";\n private resolvedJsonPath: string;\n\n constructor(public options: AFSJSONOptions & { cwd?: string; localPath?: string; uri?: string }) {\n super();\n\n // Normalize registry-passed template vars: localPath → jsonPath\n if ((options as any).localPath && !options.jsonPath) {\n options.jsonPath = (options as any).localPath;\n }\n\n zodParse(afsJSONOptionsSchema, options);\n\n const jsonPath = resolveLocalPath(options.jsonPath, { cwd: options.cwd });\n\n // Auto-create JSON file if it doesn't exist\n if (!existsSync(jsonPath)) {\n mkdirSync(dirname(jsonPath), { recursive: true });\n writeFileSync(jsonPath, \"{}\", \"utf8\");\n }\n\n // Detect file format based on extension for writing\n const ext = extname(jsonPath).toLowerCase();\n this.fileFormat = ext === \".yaml\" || ext === \".yml\" ? \"yaml\" : \"json\";\n\n // Extract name without extension\n const extensions = [\".json\", \".yaml\", \".yml\"];\n let name = basename(jsonPath);\n for (const e of extensions) {\n if (name.endsWith(e)) {\n name = name.slice(0, -e.length);\n break;\n }\n }\n\n this.name = options.name || name || \"json\";\n this.description = options.description;\n this.agentSkills = options.agentSkills;\n // Default to \"readwrite\", but \"readonly\" if agentSkills is enabled\n this.accessMode = options.accessMode ?? (options.agentSkills ? \"readonly\" : \"readwrite\");\n this.resolvedJsonPath = jsonPath;\n }\n\n // ========== Meta Handlers ==========\n // Meta is read-only introspection. Metadata writes are handled by @Write via payload.meta.\n //\n // Meta storage strategy (mirrors FS provider's .afs directory):\n // - For objects (directories): metadata stored in `.afs.meta` key within the object\n // - For primitives (files): metadata stored in parent's `.afs[\".nodes\"][key].meta` structure\n //\n // Example JSON structure:\n // {\n // \"database\": {\n // \"host\": \"localhost\",\n // \".afs\": {\n // \"meta\": { \"description\": \"Database config\" }, // object's own meta\n // \".nodes\": {\n // \"host\": { \"meta\": { \"description\": \"DB hostname\" } } // primitive's meta\n // }\n // }\n // }\n // }\n\n /**\n * Read metadata for a JSON node via /.meta or /path/.meta\n * Returns stored metadata merged with computed type information\n * Note: Meta is read-only. To write metadata, use write() with payload.meta.\n */\n @Meta(\"/:path*\")\n async readMetaHandler(ctx: RouteContext<{ path?: string }>): Promise<AFSEntry | undefined> {\n await this.ensureLoaded();\n\n const nodePath = joinURL(\"/\", ctx.params.path ?? \"\");\n const segments = this.getPathSegments(nodePath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(nodePath);\n }\n\n const isDir = this.isDirectoryValue(value);\n const children = isDir ? this.getChildren(value) : [];\n\n // Determine the JSON type\n let type: string;\n if (Array.isArray(value)) {\n type = \"array\";\n } else if (value === null) {\n type = \"null\";\n } else if (typeof value === \"object\") {\n type = \"object\";\n } else {\n type = typeof value;\n }\n\n // Load stored user-defined metadata\n const storedMeta = this.loadMeta(nodePath) || {};\n\n // Build computed metadata (type info, etc.)\n const computedMeta: Record<string, unknown> = {\n type,\n path: nodePath,\n };\n\n if (isDir) {\n computedMeta.childrenCount = children.length;\n if (Array.isArray(value)) {\n computedMeta.length = value.length;\n } else {\n // Filter out internal keys from keys list\n computedMeta.keys = Object.keys(value).filter((k) => !this.isMetaKey(k));\n }\n } else {\n computedMeta.value = value;\n }\n\n if (this.fileStats.birthtime) {\n computedMeta.created = this.fileStats.birthtime;\n }\n if (this.fileStats.mtime) {\n computedMeta.modified = this.fileStats.mtime;\n }\n\n return this.buildEntry(joinURL(nodePath, \".meta\"), {\n // User-defined metadata goes in metadata field (for conformance)\n meta: storedMeta as AFSEntryMetadata,\n // Computed type info goes in content (JSON-specific)\n content: computedMeta,\n createdAt: this.fileStats.birthtime,\n updatedAt: this.fileStats.mtime,\n });\n }\n\n // ========== Route Handlers ==========\n\n @List(\"/:path*\", { handleDepth: true })\n async listHandler(\n ctx: RouteContext<{ path?: string }>,\n ): Promise<AFSListResult & { noExpand?: string[] }> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const options = ctx.options as { limit?: number; maxChildren?: number; maxDepth?: number };\n const limit = Math.min(options?.limit || LIST_MAX_LIMIT, LIST_MAX_LIMIT);\n const maxChildren =\n typeof options?.maxChildren === \"number\" ? options.maxChildren : Number.MAX_SAFE_INTEGER;\n const maxDepth = options?.maxDepth ?? 1;\n\n const segments = this.getPathSegments(normalizedPath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n // Note: list() returns only children, never the path itself (per new semantics)\n // maxDepth=0 means no children, maxDepth=1 means immediate children only, etc.\n if (maxDepth === 0) {\n return { data: [] };\n }\n\n // If the value is not a directory, it has no children\n if (!this.isDirectoryValue(value)) {\n return { data: [] };\n }\n\n const entries: AFSEntry[] = [];\n\n interface QueueItem {\n path: string;\n value: any;\n depth: number;\n }\n\n // Start with immediate children at depth 1 (not the path itself at depth 0)\n const rootChildren = this.getChildren(value);\n const rootChildrenToProcess =\n rootChildren.length > maxChildren ? rootChildren.slice(0, maxChildren) : rootChildren;\n\n const queue: QueueItem[] = rootChildrenToProcess.map((child) => ({\n path: normalizedPath === \"/\" ? `/${child.key}` : `${normalizedPath}/${child.key}`,\n value: child.value,\n depth: 1,\n }));\n\n while (queue.length > 0) {\n const item = queue.shift();\n if (!item) break;\n\n const { path: itemPath, value: itemValue, depth } = item;\n\n const entry = this.valueToAFSEntry(itemPath, itemValue);\n entries.push(entry);\n\n if (entries.length >= limit) {\n break;\n }\n\n // Process children if within depth limit\n if (this.isDirectoryValue(itemValue) && depth < maxDepth) {\n const children = this.getChildren(itemValue);\n const childrenToProcess =\n children.length > maxChildren ? children.slice(0, maxChildren) : children;\n\n for (const child of childrenToProcess) {\n const childPath = itemPath === \"/\" ? `/${child.key}` : `${itemPath}/${child.key}`;\n queue.push({\n path: childPath,\n value: child.value,\n depth: depth + 1,\n });\n }\n }\n }\n\n return { data: entries };\n }\n\n @Read(\"/:path*\")\n async readHandler(ctx: RouteContext<{ path?: string }>): Promise<AFSEntry | undefined> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const segments = this.getPathSegments(normalizedPath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n return this.valueToAFSEntry(normalizedPath, value);\n }\n\n /**\n * Write handler - supports writing content and/or metadata\n *\n * | payload | behavior |\n * |---------|----------|\n * | { content } | write content only |\n * | { metadata } | write metadata only (to .afs storage) |\n * | { content, metadata } | write both |\n */\n @Write(\"/:path*\")\n async writeHandler(\n ctx: RouteContext<{ path?: string }>,\n payload: AFSWriteEntryPayload,\n ): Promise<{ data: AFSEntry }> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const segments = this.getPathSegments(normalizedPath);\n\n // Write content if provided\n if (payload.content !== undefined) {\n this.setValueAtPath(this.jsonData, segments, payload.content);\n }\n\n // Write metadata if provided (merge with existing)\n if (payload.meta !== undefined && typeof payload.meta === \"object\") {\n const existingMeta = this.loadMeta(normalizedPath) || {};\n const finalMeta = { ...existingMeta, ...payload.meta };\n this.saveMeta(normalizedPath, finalMeta);\n }\n\n // Save back to file\n await this.saveToFile();\n\n const newValue = this.getValueAtPath(this.jsonData, segments);\n const isDir = this.isDirectoryValue(newValue);\n const children = isDir ? this.getChildren(newValue) : [];\n\n // Load stored metadata for response\n const storedMeta = this.loadMeta(normalizedPath) || {};\n\n const writtenEntry: AFSEntry = {\n id: normalizedPath,\n path: normalizedPath,\n content: payload.content !== undefined ? payload.content : newValue,\n summary: payload.summary,\n createdAt: this.fileStats.birthtime,\n updatedAt: this.fileStats.mtime,\n meta: {\n ...storedMeta,\n childrenCount: isDir ? children.length : undefined,\n } as AFSEntryMetadata,\n userId: payload.userId,\n sessionId: payload.sessionId,\n linkTo: payload.linkTo,\n };\n\n return { data: writtenEntry };\n }\n\n @Delete(\"/:path*\")\n async deleteHandler(ctx: RouteContext<{ path?: string }>): Promise<{ message: string }> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const options = ctx.options as AFSDeleteOptions | undefined;\n const segments = this.getPathSegments(normalizedPath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n const hasChildren = this.isDirectoryValue(value) && this.getChildren(value).length > 0;\n if (hasChildren && !options?.recursive) {\n throw new Error(\n `Cannot delete directory '${normalizedPath}' without recursive option. Set recursive: true to delete directories.`,\n );\n }\n\n this.deleteValueAtPath(this.jsonData, segments);\n await this.saveToFile();\n\n return { message: `Successfully deleted: ${normalizedPath}` };\n }\n\n @Rename(\"/:path*\")\n async renameHandler(\n ctx: RouteContext<{ path?: string }>,\n newPath: string,\n ): Promise<{ message: string }> {\n await this.ensureLoaded();\n\n const normalizedOldPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const normalizedNewPath = this.normalizePath(newPath);\n const options = ctx.options as AFSRenameOptions | undefined;\n\n const oldSegments = this.getPathSegments(normalizedOldPath);\n const newSegments = this.getPathSegments(normalizedNewPath);\n\n const oldValue = this.getValueAtPath(this.jsonData, oldSegments);\n if (oldValue === undefined) {\n throw new AFSNotFoundError(normalizedOldPath);\n }\n\n const existingNewValue = this.getValueAtPath(this.jsonData, newSegments);\n if (existingNewValue !== undefined && !options?.overwrite) {\n throw new Error(\n `Destination '${normalizedNewPath}' already exists. Set overwrite: true to replace it.`,\n );\n }\n\n // Copy to new location and delete old\n this.setValueAtPath(this.jsonData, newSegments, oldValue);\n this.deleteValueAtPath(this.jsonData, oldSegments);\n await this.saveToFile();\n\n return {\n message: `Successfully renamed '${normalizedOldPath}' to '${normalizedNewPath}'`,\n };\n }\n\n @Search(\"/:path*\")\n async searchHandler(\n ctx: RouteContext<{ path?: string }>,\n query: string,\n options?: AFSSearchOptions,\n ): Promise<{ data: AFSEntry[]; message?: string }> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const limit = Math.min(options?.limit || LIST_MAX_LIMIT, LIST_MAX_LIMIT);\n const caseSensitive = options?.caseSensitive ?? false;\n\n const segments = this.getPathSegments(normalizedPath);\n const rootValue = this.getValueAtPath(this.jsonData, segments);\n\n if (rootValue === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n const entries: AFSEntry[] = [];\n const searchQuery = caseSensitive ? query : query.toLowerCase();\n\n const searchInValue = (valuePath: string, value: any): void => {\n if (entries.length >= limit) return;\n\n let matched = false;\n\n // Search in the value itself\n if (!this.isDirectoryValue(value)) {\n const valueStr = typeof value === \"string\" ? value : JSON.stringify(value);\n const searchValue = caseSensitive ? valueStr : valueStr.toLowerCase();\n if (searchValue.includes(searchQuery)) {\n matched = true;\n }\n }\n\n if (matched) {\n entries.push(this.valueToAFSEntry(valuePath, value));\n }\n\n // Recursively search children\n if (this.isDirectoryValue(value)) {\n const children = this.getChildren(value);\n for (const child of children) {\n if (entries.length >= limit) break;\n const childPath = valuePath === \"/\" ? `/${child.key}` : `${valuePath}/${child.key}`;\n searchInValue(childPath, child.value);\n }\n }\n };\n\n searchInValue(normalizedPath, rootValue);\n\n return {\n data: entries,\n message: entries.length >= limit ? `Results truncated to limit ${limit}` : undefined,\n };\n }\n\n @Stat(\"/:path*\")\n async statHandler(ctx: RouteContext<{ path?: string }>): Promise<AFSStatResult> {\n await this.ensureLoaded();\n\n const normalizedPath = ctx.params.path ? `/${ctx.params.path}` : \"/\";\n const segments = this.getPathSegments(normalizedPath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n const isDir = this.isDirectoryValue(value);\n const children = isDir ? this.getChildren(value) : [];\n const loadedMeta = this.loadMeta(normalizedPath);\n const meta: Record<string, unknown> = { ...loadedMeta };\n if (isDir) {\n meta.childrenCount = children.length;\n }\n\n const id = segments.length > 0 ? (segments[segments.length - 1] as string) : \"/\";\n\n return {\n data: {\n id,\n path: normalizedPath,\n createdAt: this.fileStats.birthtime,\n updatedAt: this.fileStats.mtime,\n meta,\n },\n };\n }\n\n // ========== Explain & Capabilities ==========\n\n @Read(\"/.meta/.capabilities\")\n async readCapabilitiesHandler(_ctx: RouteContext): Promise<AFSEntry | undefined> {\n await this.ensureLoaded();\n\n const operations = [\"list\", \"read\", \"stat\", \"explain\", \"search\"];\n if (this.accessMode === \"readwrite\") {\n operations.push(\"write\", \"delete\", \"rename\");\n }\n\n const manifest: CapabilitiesManifest = {\n schemaVersion: 1,\n provider: this.name,\n description: this.description || `JSON/YAML virtual filesystem (${this.fileFormat} format)`,\n tools: [],\n actions: [],\n operations: this.getOperationsDeclaration(),\n };\n\n return {\n id: \"/.meta/.capabilities\",\n path: \"/.meta/.capabilities\",\n content: manifest,\n meta: { kind: \"afs:capabilities\", operations },\n };\n }\n\n @Explain(\"/:path*\")\n async explainHandler(ctx: RouteContext<{ path?: string }>): Promise<AFSExplainResult> {\n await this.ensureLoaded();\n\n const normalizedPath = joinURL(\"/\", ctx.params.path ?? \"\");\n const format = (ctx.options as AFSExplainOptions)?.format || \"markdown\";\n const segments = this.getPathSegments(normalizedPath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(normalizedPath);\n }\n\n const nodeName = segments.length > 0 ? segments[segments.length - 1]! : \"/\";\n const isDir = this.isDirectoryValue(value);\n const storedMeta = this.loadMeta(normalizedPath);\n const lines: string[] = [];\n\n if (format === \"markdown\") {\n lines.push(`# ${nodeName}`);\n lines.push(\"\");\n lines.push(`**Path:** \\`${normalizedPath}\\``);\n lines.push(`**Format:** ${this.fileFormat.toUpperCase()}`);\n\n if (normalizedPath === \"/\") {\n // Root: describe file path, format, top-level structure\n const topType = Array.isArray(this.jsonData) ? \"array\" : \"object\";\n const children = this.getChildren(this.jsonData);\n lines.push(`**Structure:** ${topType}`);\n lines.push(`**Top-level keys:** ${children.length}`);\n if (children.length > 0) {\n lines.push(\"\");\n lines.push(\"## Keys\");\n lines.push(\"\");\n for (const child of children.slice(0, 30)) {\n const childVal = child.value;\n const childType = this.describeType(childVal);\n lines.push(`- \\`${child.key}\\` — ${childType}`);\n }\n if (children.length > 30) {\n lines.push(`- ... and ${children.length - 30} more`);\n }\n }\n } else if (Array.isArray(value)) {\n // Array node\n lines.push(`**Type:** array`);\n lines.push(`**Elements:** ${value.length}`);\n if (value.length > 0) {\n const elementType = this.describeType(value[0]);\n const isHomogeneous = value.every((v: unknown) => this.describeType(v) === elementType);\n lines.push(`**Element type:** ${isHomogeneous ? elementType : \"mixed\"}`);\n }\n } else if (typeof value === \"object\" && value !== null) {\n // Object node\n const children = this.getChildren(value);\n lines.push(`**Type:** object`);\n lines.push(`**Keys:** ${children.length}`);\n if (children.length > 0) {\n lines.push(\"\");\n lines.push(\"## Keys\");\n lines.push(\"\");\n for (const child of children.slice(0, 30)) {\n const childType = this.describeType(child.value);\n lines.push(`- \\`${child.key}\\` — ${childType}`);\n }\n if (children.length > 30) {\n lines.push(`- ... and ${children.length - 30} more`);\n }\n }\n } else {\n // Primitive node\n const valType = value === null ? \"null\" : typeof value;\n lines.push(`**Type:** ${valType}`);\n const valStr = String(value);\n if (valStr.length > 200) {\n lines.push(`**Value:** ${valStr.slice(0, 200)}...`);\n } else {\n lines.push(`**Value:** ${valStr}`);\n }\n }\n\n if (storedMeta) {\n lines.push(\"\");\n lines.push(\"## Metadata\");\n for (const [key, val] of Object.entries(storedMeta)) {\n lines.push(`- **${key}:** ${JSON.stringify(val)}`);\n }\n }\n } else {\n // text format\n lines.push(`${nodeName} (${isDir ? \"directory\" : \"value\"})`);\n lines.push(`Path: ${normalizedPath}`);\n lines.push(`Format: ${this.fileFormat}`);\n if (isDir) {\n const children = this.getChildren(value);\n lines.push(`Children: ${children.length}`);\n } else {\n const valStr = String(value);\n lines.push(`Type: ${value === null ? \"null\" : typeof value}`);\n lines.push(`Value: ${valStr.length > 200 ? `${valStr.slice(0, 200)}...` : valStr}`);\n }\n }\n\n return { content: lines.join(\"\\n\"), format };\n }\n\n /**\n * Get a human-readable type description for a JSON value.\n */\n private describeType(value: unknown): string {\n if (value === null) return \"null\";\n if (Array.isArray(value)) return `array[${value.length}]`;\n if (typeof value === \"object\") {\n const keys = Object.keys(value).filter((k) => !this.isMetaKey(k));\n return `object{${keys.length} keys}`;\n }\n return typeof value;\n }\n\n // ========== Private Helper Methods ==========\n\n /**\n * Check if a key is a hidden meta key that should be filtered from listings\n */\n private isMetaKey(key: string): boolean {\n return key === AFS_KEY;\n }\n\n /**\n * Load metadata for a node.\n *\n * Storage location depends on node type (mirrors FS provider's .afs structure):\n * - Objects: `.afs.meta` key within the object itself\n * - Primitives: parent's `.afs[\".nodes\"][key].meta`\n */\n private loadMeta(nodePath: string): Record<string, unknown> | null {\n const segments = this.getPathSegments(nodePath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n return null;\n }\n\n if (this.isDirectoryValue(value) && !Array.isArray(value)) {\n // Object: meta is in value[\".afs\"].meta\n const afs = value[AFS_KEY];\n if (afs && typeof afs === \"object\" && !Array.isArray(afs)) {\n const meta = afs[META_KEY];\n if (meta && typeof meta === \"object\" && !Array.isArray(meta)) {\n return meta as Record<string, unknown>;\n }\n }\n return null;\n }\n\n // Primitive or array: meta is in parent's .afs[\".nodes\"][key].meta\n if (segments.length === 0) {\n // Root is always an object, handled above\n return null;\n }\n\n const parentSegments = segments.slice(0, -1);\n const nodeKey = segments[segments.length - 1]!;\n const parentValue = this.getValueAtPath(this.jsonData, parentSegments);\n\n if (!parentValue || Array.isArray(parentValue) || typeof parentValue !== \"object\") {\n return null;\n }\n\n const afs = parentValue[AFS_KEY];\n if (!afs || typeof afs !== \"object\" || Array.isArray(afs)) {\n return null;\n }\n\n const nodes = afs[NODES_KEY];\n if (!nodes || typeof nodes !== \"object\" || Array.isArray(nodes)) {\n return null;\n }\n\n const nodeEntry = nodes[nodeKey];\n if (!nodeEntry || typeof nodeEntry !== \"object\" || Array.isArray(nodeEntry)) {\n return null;\n }\n\n const meta = nodeEntry[META_KEY];\n if (!meta || typeof meta !== \"object\" || Array.isArray(meta)) {\n return null;\n }\n\n return meta as Record<string, unknown>;\n }\n\n /**\n * Save metadata for a node.\n *\n * Storage location depends on node type (mirrors FS provider's .afs structure):\n * - Objects: `.afs.meta` key within the object itself\n * - Primitives: parent's `.afs[\".nodes\"][key].meta`\n */\n private saveMeta(nodePath: string, meta: Record<string, unknown>): void {\n const segments = this.getPathSegments(nodePath);\n const value = this.getValueAtPath(this.jsonData, segments);\n\n if (value === undefined) {\n throw new AFSNotFoundError(nodePath);\n }\n\n if (this.isDirectoryValue(value) && !Array.isArray(value)) {\n // Object: store in value[\".afs\"].meta\n if (!value[AFS_KEY]) {\n value[AFS_KEY] = {};\n }\n // Store in .meta key\n value[AFS_KEY][META_KEY] = meta;\n return;\n }\n\n // Primitive or array: store in parent's .afs[\".nodes\"][key].meta\n if (segments.length === 0) {\n throw new Error(\"Cannot save meta for root when root is not an object\");\n }\n\n const parentSegments = segments.slice(0, -1);\n const nodeKey = segments[segments.length - 1]!;\n const parentValue = this.getValueAtPath(this.jsonData, parentSegments);\n\n if (!parentValue || typeof parentValue !== \"object\") {\n throw new Error(`Parent path is not an object`);\n }\n\n if (Array.isArray(parentValue)) {\n throw new Error(`Cannot save meta for array elements`);\n }\n\n // Ensure .afs exists\n if (!parentValue[AFS_KEY]) {\n parentValue[AFS_KEY] = {};\n }\n\n // Ensure .afs[\".nodes\"] exists\n if (!parentValue[AFS_KEY][NODES_KEY]) {\n parentValue[AFS_KEY][NODES_KEY] = {};\n }\n\n // Ensure .afs[\".nodes\"][nodeKey] exists\n if (!parentValue[AFS_KEY][NODES_KEY][nodeKey]) {\n parentValue[AFS_KEY][NODES_KEY][nodeKey] = {};\n }\n\n // Store the meta in .meta key\n parentValue[AFS_KEY][NODES_KEY][nodeKey][META_KEY] = meta;\n }\n\n /**\n * Load JSON/YAML data from file. Called lazily on first access.\n * Uses YAML parser which can handle both JSON and YAML formats.\n */\n private async ensureLoaded(): Promise<void> {\n if (this.jsonData !== null) return;\n\n try {\n const stats = await stat(this.resolvedJsonPath);\n this.fileStats = {\n birthtime: stats.birthtime,\n mtime: stats.mtime,\n };\n\n const content = await readFile(this.resolvedJsonPath, \"utf8\");\n\n // YAML parser can handle both JSON and YAML formats\n this.jsonData = parseYAML(content);\n } catch (error) {\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n // File doesn't exist yet, start with empty object\n this.jsonData = {};\n } else {\n throw error;\n }\n }\n }\n\n /**\n * Save JSON/YAML data back to file. Only called in readwrite mode.\n */\n private async saveToFile(): Promise<void> {\n let content: string;\n\n // Serialize based on file format\n if (this.fileFormat === \"yaml\") {\n content = stringifyYAML(this.jsonData);\n } else {\n content = JSON.stringify(this.jsonData, null, 2);\n }\n\n await writeFile(this.resolvedJsonPath, content, \"utf8\");\n\n // Update file stats\n const stats = await stat(this.resolvedJsonPath);\n this.fileStats = {\n birthtime: this.fileStats.birthtime || stats.birthtime,\n mtime: stats.mtime,\n };\n }\n\n /**\n * Get path segments from normalized path\n */\n /**\n * Dangerous property names that must never be used as object keys.\n * Prevents prototype pollution attacks (e.g., writing to /__proto__/polluted).\n */\n private static readonly DANGEROUS_KEYS = new Set([\"__proto__\", \"constructor\", \"prototype\"]);\n\n private getPathSegments(path: string): string[] {\n const normalized = this.normalizePath(path);\n if (normalized === \"/\") return [];\n const segments = normalized.slice(1).split(\"/\");\n\n // Guard against prototype pollution\n for (const segment of segments) {\n if (AFSJSON.DANGEROUS_KEYS.has(segment)) {\n throw new Error(`Path segment \"${segment}\" is not allowed (prototype pollution guard)`);\n }\n }\n\n return segments;\n }\n\n /**\n * Navigate to a value in the JSON structure using path segments\n */\n private getValueAtPath(data: any, segments: string[]): any {\n let current = data;\n for (const segment of segments) {\n if (current == null) return undefined;\n\n // Handle array indices\n if (Array.isArray(current)) {\n const index = Number.parseInt(segment, 10);\n if (Number.isNaN(index) || index < 0 || index >= current.length) {\n return undefined;\n }\n current = current[index];\n } else if (typeof current === \"object\") {\n current = current[segment as keyof typeof current];\n } else {\n return undefined;\n }\n }\n return current;\n }\n\n /**\n * Set a value in the JSON structure at the given path\n */\n private setValueAtPath(data: any, segments: string[], value: any): void {\n if (segments.length === 0) {\n throw new Error(\"Cannot set value at root path\");\n }\n\n let current = data;\n for (let i = 0; i < segments.length - 1; i++) {\n const segment = segments[i]!;\n const nextSegment = segments[i + 1]!;\n\n if (Array.isArray(current)) {\n const index = Number.parseInt(segment, 10);\n if (Number.isNaN(index) || index < 0) {\n throw new Error(`Invalid array index: ${segment}`);\n }\n\n // Extend array if necessary\n while (current.length <= index) {\n current.push(null);\n }\n\n if (current[index] == null) {\n // Determine if next level should be array or object\n const isNextArray = !Number.isNaN(Number.parseInt(nextSegment, 10));\n current[index] = isNextArray ? [] : {};\n }\n current = current[index];\n } else if (typeof current === \"object\") {\n if (current[segment] == null) {\n // Determine if next level should be array or object\n const isNextArray = !Number.isNaN(Number.parseInt(nextSegment, 10));\n current[segment] = isNextArray ? [] : {};\n }\n current = current[segment];\n } else {\n throw new Error(\n `Cannot set property on non-object at ${segments.slice(0, i + 1).join(\"/\")}`,\n );\n }\n }\n\n const lastSegment = segments[segments.length - 1]!;\n if (Array.isArray(current)) {\n const index = Number.parseInt(lastSegment, 10);\n if (Number.isNaN(index) || index < 0) {\n throw new Error(`Invalid array index: ${lastSegment}`);\n }\n current[index] = value;\n } else if (typeof current === \"object\") {\n current[lastSegment] = value;\n } else {\n throw new Error(\"Cannot set property on non-object\");\n }\n }\n\n /**\n * Delete a value from the JSON structure at the given path\n */\n private deleteValueAtPath(data: any, segments: string[]): boolean {\n if (segments.length === 0) {\n throw new Error(\"Cannot delete root path\");\n }\n\n let current = data;\n for (let i = 0; i < segments.length - 1; i++) {\n const segment = segments[i]!;\n\n if (Array.isArray(current)) {\n const index = Number.parseInt(segment, 10);\n if (Number.isNaN(index) || index < 0 || index >= current.length) {\n return false;\n }\n current = current[index];\n } else if (typeof current === \"object\") {\n if (!(segment in current)) return false;\n current = current[segment];\n } else {\n return false;\n }\n }\n\n const lastSegment = segments[segments.length - 1]!;\n if (Array.isArray(current)) {\n const index = Number.parseInt(lastSegment, 10);\n if (Number.isNaN(index) || index < 0 || index >= current.length) {\n return false;\n }\n current.splice(index, 1);\n return true;\n }\n if (typeof current === \"object\") {\n if (!(lastSegment in current)) return false;\n delete current[lastSegment];\n return true;\n }\n return false;\n }\n\n /**\n * Check if a value is a \"directory\" (object or array with children)\n */\n private isDirectoryValue(value: any): boolean {\n if (Array.isArray(value)) return true;\n if (typeof value === \"object\" && value !== null) return true;\n return false;\n }\n\n /**\n * Get children of a directory value (filters out .afs meta key)\n */\n private getChildren(value: any): Array<{ key: string; value: any }> {\n if (Array.isArray(value)) {\n return value.map((item, index) => ({ key: String(index), value: item }));\n }\n if (typeof value === \"object\" && value !== null) {\n return Object.entries(value)\n .filter(([key]) => !this.isMetaKey(key))\n .map(([key, val]) => ({ key, value: val }));\n }\n return [];\n }\n\n /**\n * Convert a JSON value to an AFSEntry\n */\n private valueToAFSEntry(path: string, value: any): AFSEntry {\n const isDir = this.isDirectoryValue(value);\n const children = isDir ? this.getChildren(value) : [];\n const kind = Array.isArray(value) ? \"json:array\" : isDir ? \"json:object\" : \"json:value\";\n\n return this.buildEntry(path, {\n content: isDir ? undefined : value,\n meta: {\n kind,\n childrenCount: isDir ? children.length : undefined,\n },\n createdAt: this.fileStats.birthtime,\n updatedAt: this.fileStats.mtime,\n });\n }\n}\n\nconst _typeCheck: AFSModuleClass<AFSJSON, AFSJSONOptions> = AFSJSON;\n\nexport default AFSJSON;\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@aigne/afs-json",
|
|
3
|
-
"version": "1.11.0-beta.
|
|
3
|
+
"version": "1.11.0-beta.12",
|
|
4
4
|
"description": "AIGNE AFS module for JSON and YAML file storage",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"publishConfig": {
|
|
@@ -36,7 +36,8 @@
|
|
|
36
36
|
"ufo": "^1.6.3",
|
|
37
37
|
"yaml": "^2.8.1",
|
|
38
38
|
"zod": "^4.0.0",
|
|
39
|
-
"@aigne/afs": "^1.11.0-beta.
|
|
39
|
+
"@aigne/afs": "^1.11.0-beta.12",
|
|
40
|
+
"@aigne/afs-provider-utils": "^1.11.0-beta.12"
|
|
40
41
|
},
|
|
41
42
|
"devDependencies": {
|
|
42
43
|
"@types/bun": "^1.3.6",
|
|
@@ -46,7 +47,7 @@
|
|
|
46
47
|
"typescript": "5.9.2",
|
|
47
48
|
"@aigne/scripts": "0.0.0",
|
|
48
49
|
"@aigne/typescript-config": "0.0.0",
|
|
49
|
-
"@aigne/afs-testing": "1.11.0-beta.
|
|
50
|
+
"@aigne/afs-testing": "1.11.0-beta.12"
|
|
50
51
|
},
|
|
51
52
|
"scripts": {
|
|
52
53
|
"build": "tsdown",
|