@agentxm/client-core 0.17.0 → 0.18.0

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.17.0",
+  "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.17.0"
+    "@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/{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

@@ -259,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
             }
           },
@@ -324,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
             }
           },
@@ -395,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" }
@@ -447,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
             }
           },
@@ -498,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
             }
           },
@@ -549,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
             }
           },
@@ -609,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
             }
           },
@@ -647,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" } },
@@ -713,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" }
@@ -858,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."