@agentxm/client-core 0.10.0 → 0.10.1

package/dist/src/unstable/version-resolution/version-resolution.js

@@ -52,14 +52,14 @@ const fetchGitHubJson = (httpClient, url) => Effect.gen(function* () {
         .pipe(Effect.mapError((cause) => makeAppError({
         code: "network",
         detail: "GitHub API is unreachable",
-        breadcrumbs: [{ description: "Check your network connection and try again." }],
+        suggestions: [{ description: "Check your network connection and try again." }],
         cause,
     })));
     if (response.status !== 200) {
         return yield* makeAppError({
             code: "internal",
             detail: `GitHub API returned status ${String(response.status)}`,
-            breadcrumbs: [
+            suggestions: [
                 {
                     description: "Check your network connection and try again. If the problem persists, GitHub may be experiencing issues.",
                 },
@@ -69,7 +69,7 @@ const fetchGitHubJson = (httpClient, url) => Effect.gen(function* () {
     return yield* response.json.pipe(Effect.mapError((cause) => makeAppError({
         code: "validation",
         detail: "GitHub API response was not valid JSON",
-        breadcrumbs: [
+        suggestions: [
             {
                 description: "This may indicate a GitHub API change. Please try again or report the issue.",
             },
@@ -83,7 +83,7 @@ const fetchGitHubJson = (httpClient, url) => Effect.gen(function* () {
 const mapDecodeError = (_url) => Effect.mapError((cause) => makeAppError({
     code: "validation",
     detail: "GitHub API returned an unexpected response shape",
-    breadcrumbs: [
+    suggestions: [
         {
             description: "This may indicate a GitHub API change. Please try again or report the issue.",
         },
@@ -128,7 +128,7 @@ const resolveRemoteVersion = (httpClient, repo) => Effect.gen(function* () {
     return yield* makeAppError({
         code: "not_found",
         detail: "No CLI release found on GitHub",
-        breadcrumbs: [
+        suggestions: [
             {
                 description: "Ensure the repository has at least one release tagged with the 'cli-v' prefix.",
             },

package/dist/src/unstable/workspace/configured-entry-resolution/resolve.js

@@ -30,7 +30,7 @@ export const resolveConfiguredSkill = (name, source) => Effect.gen(function* ()
         .pipe(Effect.map((entries) => entries.filter((entry) => entry.type === "skill")), Effect.mapError((cause) => makeAppError({
         code: "internal",
         detail: `Failed to resolve configured skill "${name}"`,
-        breadcrumbs: [
+        suggestions: [
             {
                 description: `Verify the configured source is reachable and still contains the skill.`,
             },
@@ -42,7 +42,7 @@ export const resolveConfiguredSkill = (name, source) => Effect.gen(function* ()
         return yield* makeAppError({
             code: "not_found",
             detail: `Configured skill "${name}" could not be found in its source`,
-            breadcrumbs: [
+            suggestions: [
                 {
                     description: `Verify the configured source still contains the skill or update settings.json.`,
                 },
@@ -80,7 +80,7 @@ export const resolveConfiguredSubagent = (name, source) => Effect.gen(function*
         .pipe(Effect.map((entries) => entries.filter((entry) => entry.type === "subagent")), Effect.mapError((cause) => makeAppError({
         code: "internal",
         detail: `Failed to resolve configured subagent "${name}"`,
-        breadcrumbs: [
+        suggestions: [
             {
                 description: `Verify the configured source is reachable and still contains the subagent.`,
             },
@@ -92,7 +92,7 @@ export const resolveConfiguredSubagent = (name, source) => Effect.gen(function*
         return yield* makeAppError({
             code: "not_found",
             detail: `Configured subagent "${name}" could not be found in its source`,
-            breadcrumbs: [
+            suggestions: [
                 {
                     description: `Verify the configured source still contains the subagent or update settings.json.`,
                 },
@@ -110,7 +110,7 @@ export const resolveConfiguredCommand = (name, source) => Effect.gen(function* (
         return yield* makeAppError({
             code: "validation",
             detail: `The configured command entry "${name}" is invalid.`,
-            breadcrumbs: [{ description: `Use a name like "@owner/commands/name".` }],
+            suggestions: [{ description: `Use a name like "@owner/commands/name".` }],
         });
     }
     const providers = yield* SourceHostProviders;
@@ -130,7 +130,7 @@ export const resolveConfiguredCommand = (name, source) => Effect.gen(function* (
         .pipe(Effect.map((entries) => entries.filter((entry) => entry.type === "command")), Effect.mapError((cause) => makeAppError({
         code: "internal",
         detail: `Failed to resolve configured command "${name}"`,
-        breadcrumbs: [
+        suggestions: [
             {
                 description: `Verify the configured registry source is reachable and still contains the command.`,
             },
@@ -142,7 +142,7 @@ export const resolveConfiguredCommand = (name, source) => Effect.gen(function* (
         return yield* makeAppError({
             code: "not_found",
             detail: `Configured command "${name}" could not be found in its source`,
-            breadcrumbs: [
+            suggestions: [
                 {
                     description: `Verify the configured source still contains the command or update settings.json.`,
                 },
@@ -160,7 +160,7 @@ export const resolveConfiguredMcpServer = (name, source) => Effect.gen(function*
         return yield* makeAppError({
             code: "validation",
             detail: `The configured MCP server entry "${name}" is invalid.`,
-            breadcrumbs: [{ description: `Use a name like "@owner/mcp-servers/name".` }],
+            suggestions: [{ description: `Use a name like "@owner/mcp-servers/name".` }],
         });
     }
     const providers = yield* SourceHostProviders;
@@ -180,7 +180,7 @@ export const resolveConfiguredMcpServer = (name, source) => Effect.gen(function*
         .pipe(Effect.map((entries) => entries.filter((entry) => entry.type === "mcp-server")), Effect.mapError((cause) => makeAppError({
         code: "internal",
         detail: `Failed to resolve configured MCP server "${name}"`,
-        breadcrumbs: [
+        suggestions: [
             {
                 description: `Verify the configured registry source is reachable and still contains the MCP server.`,
             },
@@ -192,7 +192,7 @@ export const resolveConfiguredMcpServer = (name, source) => Effect.gen(function*
         return yield* makeAppError({
             code: "not_found",
             detail: `Configured MCP server "${name}" could not be found in its source`,
-            breadcrumbs: [
+            suggestions: [
                 {
                     description: `Verify the configured source still contains the MCP server or update settings.json.`,
                 },
@@ -210,7 +210,7 @@ export const resolveConfiguredPack = (name, source) => Effect.gen(function* () {
         return yield* makeAppError({
             code: "validation",
             detail: `The configured pack entry "${name}" is invalid.`,
-            breadcrumbs: [{ description: `Use a name like "@owner/packs/name".` }],
+            suggestions: [{ description: `Use a name like "@owner/packs/name".` }],
         });
     }
     const providers = yield* SourceHostProviders;
@@ -251,7 +251,7 @@ export const resolveConfiguredPack = (name, source) => Effect.gen(function* () {
         : Effect.fail(error)), Effect.mapError((cause) => makeAppError({
         code: "internal",
         detail: `Failed to resolve configured pack "${name}"`,
-        breadcrumbs: [
+        suggestions: [
             {
                 description: "Verify the configured registry source is reachable and still contains the pack.",
             },
@@ -263,7 +263,7 @@ export const resolveConfiguredPack = (name, source) => Effect.gen(function* () {
         return yield* makeAppError({
             code: "not_found",
             detail: `Configured pack "${name}" could not be found in its source`,
-            breadcrumbs: [
+            suggestions: [
                 {
                     description: "Verify the configured source still contains the pack or update settings.json.",
                 },

package/dist/src/unstable/workspace/initialization.js

@@ -26,7 +26,7 @@ import { getAxmDir } from "./paths.js";
 const SELECT_AGENTS_PROMPT_MISSING = makeAppError({
     code: "usage",
     detail: "Interactive prompt required: Select agents to configure",
-    breadcrumbs: [{ description: "Provide WorkspaceInitializationInteraction in the runtime." }],
+    suggestions: [{ description: "Provide WorkspaceInitializationInteraction in the runtime." }],
 });
 const isKnownAgentId = (id) => Object.hasOwn(AGENTS, id);
 const allAgentDescriptors = () => Object.values(AGENTS);

package/dist/src/unstable/workspace/service.js

@@ -77,7 +77,7 @@ const requireInitializedWorkspace = (settingsPath, settings) => settings.pipe(Ef
     onNone: () => Effect.fail(makeAppError({
         code: "internal",
         detail: `Workspace settings not found: ${settingsPath}`,
-        breadcrumbs: [
+        suggestions: [
             { description: "Run `axm setup` to create the workspace.", cmd: "axm setup" },
         ],
     })),
@@ -259,7 +259,7 @@ export const loadWorkspace = (options) => Effect.gen(function* () {
                 return yield* makeAppError({
                     code: "conflict",
                     detail: `Skill "${name}" not found in lockfile`,
-                    breadcrumbs: [
+                    suggestions: [
                         {
                             description: "Install the skill first with `axm skills install`",
                             cmd: "axm skills install <source>",

package/dist/src/unstable/workspace/version-currency/test-stubs.js

@@ -26,6 +26,6 @@ export const makeStubRegistryClient = (indices) =>
     getExtensionPackage: () => Effect.die("not used"),
     publishExtension: () => Effect.die("not used"),
     extensionExists: () => Effect.die("not used"),
-    discoverExtensions: () => Effect.die("not used"),
+    discoverPackages: () => Effect.die("not used"),
 });
 //# sourceMappingURL=test-stubs.js.map

package/dist/src/unstable/workspace/version-currency/test-stubs.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-stubs.js","sourceRoot":"","sources":["../../../../../src/unstable/workspace/version-currency/test-stubs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAIrF,MAAM,CAAC,GAAG,iBAAiB,CAAC;AAE5B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,IAAY,EACZ,IAA8D,EAC9D,QAA+B,EACf,EAAE;AAClB,6HAA6H;AAC7H,CAAC;IACC,IAAI;IACJ,KAAK,EAAE,OAAO;IACd,IAAI;IACJ,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/B,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC;QACf,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,eAAe;KAC3B,CAAC,CAAC;CACJ,CAA8B,CAAC;AAElC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAsC,EAAkB,EAAE;AAC/F,6HAA6H;AAC7H,CAAC;IACC,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAkC,EAAE,EAAE;QACpE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,oBAAoB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;IAClD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;IACzC,mBAAmB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;IACjD,gBAAgB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;IAC9C,eAAe,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;IAC7C,kBAAkB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;CACjD,CAA8B,CAAC"}
+{"version":3,"file":"test-stubs.js","sourceRoot":"","sources":["../../../../../src/unstable/workspace/version-currency/test-stubs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kDAAkD,CAAC;AAIrF,MAAM,CAAC,GAAG,iBAAiB,CAAC;AAE5B,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAChC,IAAY,EACZ,IAA8D,EAC9D,QAA+B,EACf,EAAE;AAClB,6HAA6H;AAC7H,CAAC;IACC,IAAI;IACJ,KAAK,EAAE,OAAO;IACd,IAAI;IACJ,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QAC/B,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC;QACf,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,eAAe;KAC3B,CAAC,CAAC;CACJ,CAA8B,CAAC;AAElC,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAsC,EAAkB,EAAE;AAC/F,6HAA6H;AAC7H,CAAC;IACC,iBAAiB,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAkC,EAAE,EAAE;QACpE,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACtE,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,oBAAoB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;IAClD,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;IACzC,mBAAmB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;IACjD,gBAAgB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;IAC9C,eAAe,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;IAC7C,gBAAgB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC;CAC/C,CAA8B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentxm/client-core",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Core library for the axm agent extension manager. Unstable and unsupported — use the axm.sh CLI.",
   "type": "module",
   "license": "MIT",
@@ -229,6 +229,6 @@
     "typescript": "^5.9.3",
     "vitest": "^4.1.5",
     "yaml": "^2.8.4",
-    "@agentxm/client-utils": "^0.10.0"
+    "@agentxm/client-utils": "^0.10.1"
   }
 }

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

@@ -2,28 +2,55 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$ref": "#/definitions/AxmPackageMeta",
   "definitions": {
-    "ExtensionSpec": {
+    "ExtensionFqn": {
+      "type": "string",
+      "allOf": [
+        {
+          "pattern": "^(@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)\\/(skills|commands|mcp-servers|subagents|files|rules|packs)\\/([a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?)$",
+          "title": "Extension FQN",
+          "description": "Canonical extension identifier in @owner/<type>s/<name> form.",
+          "examples": ["@acme/skills/code-review", "@my-org/commands/format"]
+        }
+      ]
+    },
+    "VersionRange": {
       "type": "string",
       "allOf": [
         { "minLength": 1 },
         {
-          "pattern": "^(@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?)\\/(skills|commands|mcp-servers|subagents|files|rules|packs)\\/([a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?)(?:@.+)?$",
-          "title": "Extension Spec",
-          "description": "Extension reference with an optional version constraint suffix.",
-          "examples": ["@acme/skills/code-review", "@acme/skills/code-review@^1.0.0"]
+          "pattern": "^[~^<>=*xXvV0-9A-Za-z| .-]+$",
+          "title": "Version Range",
+          "description": "A semver version range like ^1.0.0, ~2.3.0, >=1.0.0 <3.0.0, or an exact version 1.2.3. Use \"*\" to always resolve to the latest available version.",
+          "examples": ["^1.0.0", "~2.4", ">=1 <3", "1.2.3", "*"]
         }
       ]
     },
+    "PackageExtensionDeclaration": {
+      "type": "object",
+      "properties": {
+        "ref": { "$ref": "#/definitions/ExtensionFqn" },
+        "versionRange": {
+          "anyOf": [
+            { "anyOf": [{ "$ref": "#/definitions/VersionRange" }, { "type": "null" }] },
+            { "type": "null" }
+          ]
+        }
+      },
+      "required": ["ref"],
+      "additionalProperties": false,
+      "title": "Package Extension Declaration",
+      "description": "An extension declared by package-native AXM metadata, with an optional semver version range."
+    },
     "AxmPackageMeta": {
       "type": "object",
       "properties": {
         "$schema": { "anyOf": [{ "type": "string" }, { "type": "null" }] },
-        "recommendedExtensions": {
+        "extensions": {
           "type": "array",
-          "items": { "$ref": "#/definitions/ExtensionSpec" }
+          "items": { "$ref": "#/definitions/PackageExtensionDeclaration" }
         }
       },
-      "required": ["recommendedExtensions"],
+      "required": ["extensions"],
       "additionalProperties": false,
       "title": "axm Package Metadata",
       "description": "Recommendation metadata shipped by library authors to surface axm extensions."

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

@@ -251,7 +251,7 @@
             { "type": "null" }
           ]
         },
-        "companionPackages": {
+        "packages": {
           "anyOf": [
             {
               "type": "array",

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

@@ -251,7 +251,7 @@
             { "type": "null" }
           ]
         },
-        "companionPackages": {
+        "packages": {
           "anyOf": [
             {
               "type": "array",

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

@@ -262,7 +262,7 @@
             { "type": "null" }
           ]
         },
-        "companionPackages": {
+        "packages": {
           "anyOf": [
             {
               "type": "array",

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

@@ -251,7 +251,7 @@
             { "type": "null" }
           ]
         },
-        "companionPackages": {
+        "packages": {
           "anyOf": [
             {
               "type": "array",

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

@@ -251,7 +251,7 @@
             { "type": "null" }
           ]
         },
-        "companionPackages": {
+        "packages": {
           "anyOf": [
             {
               "type": "array",

package/dist/src/unstable/cli-runtime/breadcrumb.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"breadcrumb.d.ts","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/breadcrumb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,eAAO,MAAM,gBAAgB;;;;EAgBzB,CAAC;AAEL,MAAM,MAAM,UAAU,GAAG,OAAO,gBAAgB,CAAC,IAAI,CAAC"}

package/dist/src/unstable/cli-runtime/breadcrumb.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"breadcrumb.js","sourceRoot":"","sources":["../../../../src/unstable/cli-runtime/breadcrumb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,MAAM,yBAAyB,GAAG,SAAS,CAAC;AAE5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,WAAW,EAAE,MAAM,CAAC,MAAM;IAC1B,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CACpC,CAAC;KACC,KAAK,CACJ,MAAM,CAAC,UAAU,CAAC,CAAC,UAAU,EAAE,EAAE,CAC/B,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,UAAU,CAAC,GAAG,KAAK,SAAS;IACpF,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,4DAA4D,EAAE;IACxF,CAAC,CAAC,SAAS,CACd,CACF;KACA,QAAQ,CAAC;IACR,UAAU,EAAE,YAAY;IACxB,KAAK,EAAE,YAAY;IACnB,WAAW,EAAE,qDAAqD;CACnE,CAAC,CAAC"}