@agentxm/client-core 0.16.2 → 0.18.0

package/dist/src/unstable/yaml/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/yaml/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsCH,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,KAAG,OAAwC,CAAC;AAEjF,eAAO,MAAM,aAAa,GACxB,KAAK,MAAM,EACX,YAAY,MAAM,EAClB,YAAY,MAAM,KACjB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAMtC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,KAAK,MAAM,EACX,YAAY,MAAM,EAClB,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,KAC/D,aAAa,CAAC,MAAM,CAOtB,CAAC;AAEF,eAAO,MAAM,YAAY,GACvB,KAAK,MAAM,EACX,YAAY,MAAM,EAClB,YAAY,MAAM,EAClB,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KACvC,MAKF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,EAAE,YAAY,MAAM,EAAE,YAAY,MAAM,KAAG,MAKrF,CAAC;AAEF,eAAO,MAAM,aAAa,GACxB,KAAK,MAAM,EACX,MAAM,aAAa,CAAC,MAAM,CAAC,EAC3B,OAAO,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,KACtC,MASF,CAAC"}

package/dist/src/unstable/yaml/index.js

@@ -0,0 +1,73 @@
+/**
+ * YAML config helpers for AXM-owned structured config edits.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+import { parseDocument } from "yaml";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const formatPath = (path) => path.join(".");
+const parseYamlDocument = (raw) => {
+    const document = parseDocument(raw, { keepSourceTokens: true });
+    if (document.errors.length > 0) {
+        throw new Error(document.errors.map((error) => error.message).join("; "));
+    }
+    return document;
+};
+const parseYamlObjectOrNull = (raw) => {
+    const parsed = parseYamlDocument(raw).toJS();
+    if (parsed === null || parsed === undefined)
+        return null;
+    if (!isRecord(parsed)) {
+        throw new Error("YAML document root must be a mapping");
+    }
+    return parsed;
+};
+const validateServersShape = (raw, serversKey) => {
+    const parsed = parseYamlObjectOrNull(raw);
+    const servers = parsed?.[serversKey];
+    if (servers !== undefined && !isRecord(servers)) {
+        throw new Error(`${formatPath([serversKey])} must be a mapping`);
+    }
+    return parsed;
+};
+export const parseYaml = (raw) => parseYamlDocument(raw).toJS();
+export const readYamlEntry = (raw, serversKey, serverName) => {
+    const parsed = validateServersShape(raw, serversKey);
+    const servers = parsed?.[serversKey];
+    if (!isRecord(servers))
+        return undefined;
+    const entry = servers[serverName];
+    return isRecord(entry) ? entry : undefined;
+};
+export const managedYamlNames = (raw, serversKey, isManaged) => {
+    const parsed = validateServersShape(raw, serversKey);
+    const servers = parsed?.[serversKey];
+    if (!isRecord(servers))
+        return [];
+    return Object.entries(servers).flatMap(([name, entry]) => isRecord(entry) && isManaged(entry) ? [name] : []);
+};
+export const setYamlEntry = (raw, serversKey, serverName, entry) => {
+    validateServersShape(raw, serversKey);
+    const document = parseYamlDocument(raw);
+    document.setIn([serversKey, serverName], entry);
+    return document.toString({ lineWidth: 0 });
+};
+export const deleteYamlEntry = (raw, serversKey, serverName) => {
+    validateServersShape(raw, serversKey);
+    const document = parseYamlDocument(raw);
+    const removed = document.deleteIn([serversKey, serverName]);
+    return removed ? document.toString({ lineWidth: 0 }) : raw;
+};
+export const setYamlScalar = (raw, path, value) => {
+    if (path.length === 0) {
+        throw new Error("YAML scalar path must not be empty");
+    }
+    const rootKey = path[0];
+    if (rootKey !== undefined)
+        validateServersShape(raw, rootKey);
+    const document = parseYamlDocument(raw);
+    document.setIn(path, value);
+    return document.toString({ lineWidth: 0 });
+};
+//# sourceMappingURL=index.js.map

package/dist/src/unstable/yaml/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/yaml/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxm/client-core",
-  "version": "0.16.2",
+  "version": "0.18.0",
   "description": "Core library for the axm agent extension manager. Unstable and unsupported — use the axm.sh CLI.",
   "type": "module",
   "license": "FSL-1.1-MIT",
@@ -83,6 +83,10 @@
       "types": "./dist/src/unstable/lockfile/index.d.ts",
       "default": "./dist/src/unstable/lockfile/index.js"
     },
+    "./unstable/libraries": {
+      "types": "./dist/src/unstable/libraries/index.d.ts",
+      "default": "./dist/src/unstable/libraries/index.js"
+    },
     "./unstable/schema": {
       "types": "./dist/src/unstable/schema/index.d.ts",
       "default": "./dist/src/unstable/schema/index.js"
@@ -209,6 +213,10 @@
       "types": "./dist/src/unstable/toml/index.d.ts",
       "default": "./dist/src/unstable/toml/index.js"
     },
+    "./unstable/yaml": {
+      "types": "./dist/src/unstable/yaml/index.d.ts",
+      "default": "./dist/src/unstable/yaml/index.js"
+    },
     "./unstable/discover": {
       "types": "./dist/src/unstable/discover/index.d.ts",
       "default": "./dist/src/unstable/discover/index.js"
@@ -248,7 +256,8 @@
     "proper-lockfile": "^4.1.2",
     "semver": "^7.8.0",
     "simple-git": "^3.36.0",
-    "spdx-expression-parse": "3.0.1"
+    "spdx-expression-parse": "3.0.1",
+    "yaml": "^2.8.4"
   },
   "devDependencies": {
     "@effect/openapi-generator": "4.0.0-beta.64",
@@ -260,7 +269,6 @@
     "swagger2openapi": "^7.0.8",
     "typescript": "^5.9.3",
     "vitest": "^4.1.5",
-    "yaml": "^2.8.4",
-    "@agentxm/client-utils": "^0.16.2"
+    "@agentxm/client-utils": "^0.18.0"
   }
 }

package/site-content/__generated__/schemas/axm-lock.schema.json

@@ -206,6 +206,74 @@
       "title": "Pack Lock Entry",
       "description": "Pinned version info for an installed pack from a registry."
     },
+    "LibraryLockEntry": {
+      "type": "object",
+      "properties": {
+        "type": { "type": "string", "enum": ["registry"] },
+        "owner": { "$ref": "#/definitions/Handle" },
+        "name": { "$ref": "#/definitions/ExtensionName" },
+        "sourceName": { "type": "string" },
+        "installedAt": { "$ref": "#/definitions/IsoDateTimeString" },
+        "updatedAt": { "$ref": "#/definitions/IsoDateTimeString" },
+        "resolvedAt": { "$ref": "#/definitions/IsoDateTimeString" },
+        "membershipDigest": { "type": "string" },
+        "resolvedSkills": {
+          "type": "object",
+          "propertyNames": { "$ref": "#/definitions/ExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/Version" }
+        },
+        "resolvedCommands": {
+          "type": "object",
+          "propertyNames": { "$ref": "#/definitions/ExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/Version" }
+        },
+        "resolvedMcpServers": {
+          "type": "object",
+          "propertyNames": { "$ref": "#/definitions/ExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/Version" }
+        },
+        "resolvedSubagents": {
+          "type": "object",
+          "propertyNames": { "$ref": "#/definitions/ExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/Version" }
+        },
+        "resolvedFiles": {
+          "type": "object",
+          "propertyNames": { "$ref": "#/definitions/ExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/Version" }
+        },
+        "resolvedRules": {
+          "type": "object",
+          "propertyNames": { "$ref": "#/definitions/ExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/Version" }
+        },
+        "resolvedHooks": {
+          "type": "object",
+          "propertyNames": { "$ref": "#/definitions/ExtensionFqn" },
+          "additionalProperties": { "$ref": "#/definitions/Version" }
+        }
+      },
+      "required": [
+        "type",
+        "owner",
+        "name",
+        "sourceName",
+        "installedAt",
+        "updatedAt",
+        "resolvedAt",
+        "membershipDigest",
+        "resolvedSkills",
+        "resolvedCommands",
+        "resolvedMcpServers",
+        "resolvedSubagents",
+        "resolvedFiles",
+        "resolvedRules",
+        "resolvedHooks"
+      ],
+      "additionalProperties": false,
+      "title": "Library Lock Entry",
+      "description": "Pinned membership snapshot for an installed Library subscription."
+    },
     "Lockfile": {
       "type": "object",
       "properties": {
@@ -2109,6 +2177,15 @@
             { "type": "object", "additionalProperties": { "$ref": "#/definitions/PackLockEntry" } },
             { "type": "null" }
           ]
+        },
+        "libraries": {
+          "anyOf": [
+            {
+              "type": "object",
+              "additionalProperties": { "$ref": "#/definitions/LibraryLockEntry" }
+            },
+            { "type": "null" }
+          ]
         }
       },
       "required": ["lockfileVersion", "skills"],

package/site-content/__generated__/schemas/hook.schema.json

@@ -207,6 +207,157 @@
       "description": "Interpreter family used to execute the materialized hook entrypoint."
     },
     "HookEvent": {
+      "type": "string",
+      "enum": [
+        "session.start",
+        "prompt.submit",
+        "turn.end",
+        "tool.pre",
+        "tool.post",
+        "subagent.stop",
+        "compaction.pre"
+      ],
+      "title": "Hook Event",
+      "description": "Canonical AXM hook event this extension binds to.",
+      "examples": ["tool.pre", "tool.post", "prompt.submit"]
+    },
+    "CanonicalHookToolId": {
+      "type": "string",
+      "enum": ["file.read", "file.write", "file.edit", "shell.exec", "web.fetch", "mcp.call"],
+      "title": "Canonical Hook Tool ID",
+      "description": "Vendor-neutral tool identity used by portable hook matchers.",
+      "examples": ["file.write", "file.edit", "shell.exec"]
+    },
+    "HookMatch": {
+      "type": "object",
+      "properties": {
+        "tools": {
+          "anyOf": [
+            {
+              "type": "array",
+              "minItems": 1,
+              "allOf": [{ "uniqueItems": true }],
+              "items": [{ "$ref": "#/definitions/CanonicalHookToolId" }],
+              "additionalItems": { "$ref": "#/definitions/CanonicalHookToolId" }
+            },
+            { "type": "null" }
+          ]
+        }
+      },
+      "additionalProperties": false,
+      "title": "Hook Match",
+      "description": "Portable hook matcher expressed over AXM canonical tool IDs."
+    },
+    "HookBindingTarget": {
+      "type": "object",
+      "properties": {
+        "matcherRaw": {
+          "anyOf": [{ "type": "string", "allOf": [{ "minLength": 1 }] }, { "type": "null" }]
+        }
+      },
+      "additionalProperties": false,
+      "title": "Hook Binding Target",
+      "description": "Target-agent-specific hook binding escape hatches."
+    },
+    "HookBlockOutcome": {
+      "type": "string",
+      "enum": ["allow", "deny", "ask"],
+      "title": "Hook Block Outcome",
+      "description": "Decision outcome available to blocking hook systems."
+    },
+    "HookModifyOperation": {
+      "type": "string",
+      "enum": ["modify-input", "inject-context", "modify-output", "synthesize", "redact"],
+      "title": "Hook Modify Operation",
+      "description": "Transform operation available to modifying hook systems."
+    },
+    "HookDecisionRequirement": {
+      "anyOf": [
+        {
+          "type": "object",
+          "properties": { "kind": { "type": "string", "enum": ["observe"] } },
+          "required": ["kind"],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": { "type": "string", "enum": ["block"] },
+            "outcomes": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "minItems": 1,
+                  "allOf": [{ "uniqueItems": true }],
+                  "items": [{ "$ref": "#/definitions/HookBlockOutcome" }],
+                  "additionalItems": { "$ref": "#/definitions/HookBlockOutcome" }
+                },
+                { "type": "null" }
+              ]
+            }
+          },
+          "required": ["kind"],
+          "additionalProperties": false
+        },
+        {
+          "type": "object",
+          "properties": {
+            "kind": { "type": "string", "enum": ["modify"] },
+            "operations": {
+              "anyOf": [
+                {
+                  "type": "array",
+                  "minItems": 1,
+                  "allOf": [{ "uniqueItems": true }],
+                  "items": [{ "$ref": "#/definitions/HookModifyOperation" }],
+                  "additionalItems": { "$ref": "#/definitions/HookModifyOperation" }
+                },
+                { "type": "null" }
+              ]
+            }
+          },
+          "required": ["kind"],
+          "additionalProperties": false
+        }
+      ],
+      "title": "Hook Decision Requirement",
+      "description": "Decision capability a hook binding requires from the target agent event."
+    },
+    "CanonicalHookBinding": {
+      "type": "object",
+      "properties": {
+        "on": { "$ref": "#/definitions/HookEvent" },
+        "match": { "anyOf": [{ "$ref": "#/definitions/HookMatch" }, { "type": "null" }] },
+        "matcherRaw": {
+          "anyOf": [{ "type": "string", "allOf": [{ "minLength": 1 }] }, { "type": "null" }]
+        },
+        "targets": {
+          "anyOf": [
+            {
+              "type": "object",
+              "additionalProperties": { "$ref": "#/definitions/HookBindingTarget" }
+            },
+            { "type": "null" }
+          ]
+        },
+        "requires": {
+          "anyOf": [
+            {
+              "type": "object",
+              "properties": { "decision": { "$ref": "#/definitions/HookDecisionRequirement" } },
+              "required": ["decision"],
+              "additionalProperties": false
+            },
+            { "type": "null" }
+          ]
+        }
+      },
+      "required": ["on"],
+      "additionalProperties": false,
+      "title": "Canonical Hook Binding",
+      "description": "Universal hook event binding expressed in AXM canonical vocabulary."
+    },
+    "LegacyHookEvent": {
       "type": "string",
       "enum": [
         "PreToolUse",
@@ -217,19 +368,24 @@
         "SubagentStop",
         "PreCompact"
       ],
-      "title": "Hook Event",
-      "description": "Agent hook event this extension binds to."
+      "title": "Legacy Hook Event",
+      "description": "Deprecated Claude-compatible hook event name accepted as a decode alias."
     },
     "HookBinding": {
-      "type": "object",
-      "properties": {
-        "event": { "$ref": "#/definitions/HookEvent" },
-        "matcher": {
-          "anyOf": [{ "type": "string", "allOf": [{ "minLength": 1 }] }, { "type": "null" }]
+      "anyOf": [
+        { "$ref": "#/definitions/CanonicalHookBinding" },
+        {
+          "type": "object",
+          "properties": {
+            "event": { "$ref": "#/definitions/LegacyHookEvent" },
+            "matcher": {
+              "anyOf": [{ "type": "string", "allOf": [{ "minLength": 1 }] }, { "type": "null" }]
+            }
+          },
+          "required": ["event"],
+          "additionalProperties": false
         }
-      },
-      "required": ["event"],
-      "additionalProperties": false
+      ]
     },
     "HookCapabilities": {
       "type": "object",

package/site-content/__generated__/schemas/{mcp-server.schema.json → mcp.schema.json}

@@ -578,7 +578,7 @@
       "required": ["name", "description", "version"],
       "additionalProperties": false,
       "title": "MCP Registry Server Detail",
-      "description": "Verbatim MCP registry server.json ServerDetail embedded in AXM mcp-server.json manifests."
+      "description": "Verbatim MCP registry server.json ServerDetail embedded in AXM mcp.json manifests."
     },
     "McpServerManifest": {
       "type": "object",

package/site-content/__generated__/schemas/settings.schema.json

@@ -19,6 +19,18 @@
         }
       ]
     },
+    "MinimumReleaseAge": {
+      "type": "string",
+      "allOf": [
+        {
+          "pattern": "^\\d+(ms|s|m|h|d)$",
+          "title": "Minimum Release Age",
+          "description": "Minimum age for registry versions during unattended resolution. Use 0s to disable the holdback.",
+          "default": "24h",
+          "examples": ["24h", "1440m", "0s"]
+        }
+      ]
+    },
     "ConfigurableAgentId": {
       "type": "string",
       "enum": [
@@ -90,9 +102,9 @@
           "default": "AGENTS.md",
           "examples": ["AGENTS.md"]
         },
-        "gitignore": {
+        "gitignoreAliases": {
           "type": "boolean",
-          "description": "Whether AXM manages propagated instruction-file ignore entries in .gitignore.",
+          "description": "Whether AXM adds propagated alias instruction files (e.g. CLAUDE.md) to a managed .gitignore region. The source-of-truth file (fileName) is never ignored.",
           "default": true,
           "examples": [true, false]
         }
@@ -111,7 +123,7 @@
             { "type": "null" }
           ],
           "description": "Instruction-file management: false for manual, object for enabled, null or absent for unset.",
-          "examples": [false, { "fileName": "AGENTS.md", "gitignore": true }]
+          "examples": [false, { "fileName": "AGENTS.md", "gitignoreAliases": true }]
         }
       },
       "additionalProperties": false
@@ -247,7 +259,7 @@
             },
             "authored": {
               "type": "boolean",
-              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
+              "description": "Set to true to mark this entry as authored locally in this workspace — for extensions you edit here. AXM treats authored entries as locally owned: it preserves their files on uninstall, keeps the local source instead of repointing to the registry on update, and re-resolves them from the local managed copy on enable. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             }
           },
@@ -312,7 +324,7 @@
             },
             "authored": {
               "type": "boolean",
-              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
+              "description": "Set to true to mark this entry as authored locally in this workspace — for extensions you edit here. AXM treats authored entries as locally owned: it preserves their files on uninstall, keeps the local source instead of repointing to the registry on update, and re-resolves them from the local managed copy on enable. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             }
           },
@@ -383,7 +395,7 @@
             },
             "authored": {
               "type": "boolean",
-              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
+              "description": "Set to true to mark this entry as authored locally in this workspace — for extensions you edit here. AXM treats authored entries as locally owned: it preserves their files on uninstall, keeps the local source instead of repointing to the registry on update, and re-resolves them from the local managed copy on enable. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             },
             "inputs": { "$ref": "#/definitions/FilesInputValuesMap" }
@@ -435,7 +447,7 @@
             },
             "authored": {
               "type": "boolean",
-              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
+              "description": "Set to true to mark this entry as authored locally in this workspace — for extensions you edit here. AXM treats authored entries as locally owned: it preserves their files on uninstall, keeps the local source instead of repointing to the registry on update, and re-resolves them from the local managed copy on enable. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             }
           },
@@ -486,7 +498,7 @@
             },
             "authored": {
               "type": "boolean",
-              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
+              "description": "Set to true to mark this entry as authored locally in this workspace — for extensions you edit here. AXM treats authored entries as locally owned: it preserves their files on uninstall, keeps the local source instead of repointing to the registry on update, and re-resolves them from the local managed copy on enable. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             }
           },
@@ -537,7 +549,7 @@
             },
             "authored": {
               "type": "boolean",
-              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
+              "description": "Set to true to mark this entry as authored locally in this workspace — for extensions you edit here. AXM treats authored entries as locally owned: it preserves their files on uninstall, keeps the local source instead of repointing to the registry on update, and re-resolves them from the local managed copy on enable. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             }
           },
@@ -597,7 +609,7 @@
             },
             "authored": {
               "type": "boolean",
-              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
+              "description": "Set to true to mark this entry as authored locally in this workspace — for extensions you edit here. AXM treats authored entries as locally owned: it preserves their files on uninstall, keeps the local source instead of repointing to the registry on update, and re-resolves them from the local managed copy on enable. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             }
           },
@@ -635,6 +647,55 @@
       "title": "Packs Config",
       "description": "Feature-level configuration for packs."
     },
+    "LibraryRef": {
+      "type": "string",
+      "allOf": [
+        {
+          "pattern": "^(@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)\\/libraries\\/([a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?)$",
+          "title": "Library Ref",
+          "description": "Bare Library reference. Libraries do not accept version suffixes.",
+          "examples": ["@acme/libraries/frontend"]
+        }
+      ]
+    },
+    "LibraryEntry": {
+      "anyOf": [
+        { "type": "string" },
+        {
+          "type": "object",
+          "properties": {
+            "source": { "$ref": "#/definitions/LibraryRef" },
+            "enabled": {
+              "type": "boolean",
+              "description": "Set to false to disable this entry. Omit otherwise — true is the default and should not be written explicitly.",
+              "default": true
+            },
+            "authored": {
+              "type": "boolean",
+              "description": "Set to true to mark this entry as authored locally in this workspace — for extensions you edit here. AXM treats authored entries as locally owned: it preserves their files on uninstall, keeps the local source instead of repointing to the registry on update, and re-resolves them from the local managed copy on enable. Omit otherwise — false is the default and should not be written explicitly.",
+              "default": false
+            }
+          },
+          "required": ["source"],
+          "additionalProperties": false,
+          "title": "Library Entry Object",
+          "description": "A Library subscription entry with source and optional enabled/authored flags."
+        }
+      ],
+      "title": "Library Entry",
+      "description": "A Library subscription entry: a bare Library ref, or an object with source plus optional flags.",
+      "examples": [
+        "@acme/libraries/frontend",
+        { "source": "@acme/libraries/frontend", "enabled": false }
+      ]
+    },
+    "LibrariesMap": {
+      "type": "object",
+      "title": "Libraries Map",
+      "description": "A map of Library subscription names to Library refs.",
+      "propertyNames": { "pattern": "^[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?$" },
+      "additionalProperties": { "$ref": "#/definitions/LibraryEntry" }
+    },
     "McpServerEnv": {
       "anyOf": [
         { "type": "object", "additionalProperties": { "type": "string" } },
@@ -701,7 +762,7 @@
             },
             "authored": {
               "type": "boolean",
-              "description": "Set to true to mark this entry as authored locally in this workspace. Omit otherwise — false is the default and should not be written explicitly.",
+              "description": "Set to true to mark this entry as authored locally in this workspace — for extensions you edit here. AXM treats authored entries as locally owned: it preserves their files on uninstall, keeps the local source instead of repointing to the registry on update, and re-resolves them from the local managed copy on enable. Omit otherwise — false is the default and should not be written explicitly.",
               "default": false
             },
             "env": { "$ref": "#/definitions/McpServerEnv" }
@@ -778,6 +839,10 @@
           "anyOf": [{ "$ref": "#/definitions/Handle" }],
           "description": "Default owner handle used when AXM scaffolds or resolves workspace extensions."
         },
+        "minimumReleaseAge": {
+          "anyOf": [{ "$ref": "#/definitions/MinimumReleaseAge" }],
+          "description": "Minimum published age for registry versions during unattended sync/update resolution. Defaults to 24h; use 0s to disable."
+        },
         "agents": {
           "type": "array",
           "description": "Coding agents AXM should sync managed extensions into.",
@@ -842,6 +907,10 @@
           "anyOf": [{ "$ref": "#/definitions/PacksConfig" }],
           "description": "Feature-level options for pack management."
         },
+        "libraries": {
+          "anyOf": [{ "$ref": "#/definitions/LibrariesMap" }],
+          "description": "Your Library subscriptions, keyed by workspace subscription name. Prefer plain Library refs; use the object form only to set `enabled: false` or `authored: true`. Libraries are always latest and do not accept version suffixes."
+        },
         "mcpServers": {
           "anyOf": [{ "$ref": "#/definitions/McpServersMap" }],
           "description": "Your installed MCP servers, keyed by workspace MCP server name. Prefer plain source strings; use the object form only to set `enabled: false`, `authored: true`, or persisted `env` values."