@agentxm/client-core 0.1.6

package/dist/src/unstable/settings/settings.js

@@ -0,0 +1,147 @@
+/**
+ * Settings management for .axm/settings.json.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import { makeAppError } from "../app-error/index.js";
+import { decodeHandleSync } from "../extensions/handle.js";
+import { readAndValidateJsonFile } from "../schema/index.js";
+import { SETTINGS_KEY_ORDER, SettingsSchema } from "./schema.js";
+// -----------------------------------------------------------------------------
+// Constants
+// -----------------------------------------------------------------------------
+/**
+ * Filename for the settings file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SETTINGS_FILENAME = "settings.json";
+/**
+ * Default profile for skill resolution when not specified in settings.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const DEFAULT_PROFILE = decodeHandleSync("@community");
+// -----------------------------------------------------------------------------
+// Default Settings
+// -----------------------------------------------------------------------------
+/**
+ * Create default settings object.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const createDefaultSettings = () => ({});
+// -----------------------------------------------------------------------------
+// Key Ordering
+// -----------------------------------------------------------------------------
+/**
+ * Reorder settings keys to match the canonical schema order.
+ *
+ * Creates a new object with keys in `SETTINGS_KEY_ORDER`, omitting keys
+ * not present in the input.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const encodeSettingsSync = Schema.encodeSync(SettingsSchema);
+const decodeSettingsSync = Schema.decodeUnknownSync(SettingsSchema);
+const orderSettingsRecord = (settings) => SETTINGS_KEY_ORDER.reduce((ordered, key) => {
+    const value = settings[key];
+    return value === undefined ? ordered : { ...ordered, [key]: value };
+}, {});
+export const orderSettingsKeys = (settings) => decodeSettingsSync(orderSettingsRecord(encodeSettingsSync(settings)));
+// -----------------------------------------------------------------------------
+// Core Functions
+// -----------------------------------------------------------------------------
+/**
+ * Read and parse settings from .axm/settings.json.
+ *
+ * @param axmDir - Path to the .axm directory
+ * @returns Parsed Settings object
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const readSettings = (axmDir) => Effect.gen(function* () {
+    const path = yield* Path.Path;
+    const settingsPath = path.join(axmDir, SETTINGS_FILENAME);
+    const result = yield* readAndValidateJsonFile(settingsPath, SettingsSchema);
+    switch (result._tag) {
+        case "ok":
+            return Option.some(result.value);
+        case "missing":
+            return Option.none();
+        case "read-failure":
+            return yield* makeAppError({
+                code: "SETTINGS_PARSE_FAILED",
+                what: `Failed to read settings file: ${settingsPath}`,
+                details: [result.error],
+            });
+        case "unparseable":
+            return yield* makeAppError({
+                code: "SETTINGS_PARSE_FAILED",
+                what: `Failed to parse settings JSON at ${settingsPath}`,
+                details: [result.error, ...(result.location !== undefined ? [result.location] : [])],
+            });
+        case "schema-invalid":
+            return yield* makeAppError({
+                code: "SETTINGS_PARSE_FAILED",
+                what: `Invalid settings format: ${settingsPath}`,
+                details: [...result.issues],
+            });
+    }
+});
+/**
+ * Read settings from .axm/settings.json, falling back to defaults on missing
+ * file or read/parse error.
+ *
+ * @param axmDir - Path to the .axm directory
+ * @returns Settings object (never fails)
+ *
+ * @remarks All errors — including schema validation failures — are silently
+ * swallowed, returning default settings. Only use this in contexts where a
+ * prior check (e.g. workspace-ready) has already validated the settings file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const readSettingsOrDefault = (axmDir) => readSettings(axmDir).pipe(Effect.map(Option.getOrElse(() => createDefaultSettings())), Effect.orElseSucceed(() => createDefaultSettings()));
+/**
+ * Write settings to .axm/settings.json.
+ *
+ * Creates the directory if it doesn't exist. Pretty-prints JSON with 2-space indent.
+ *
+ * @param axmDir - Path to the .axm directory
+ * @param settings - Settings object to write
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const writeSettings = (axmDir, settings) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const settingsPath = path.join(axmDir, SETTINGS_FILENAME);
+    // Ensure directory exists
+    yield* fs.makeDirectory(axmDir, { recursive: true }).pipe(Effect.mapError((error) => makeAppError({
+        code: "SETTINGS_WRITE_FAILED",
+        what: `Failed to create directory: ${axmDir}`,
+        cause: error,
+    })));
+    // Encode through schema (converts Option -> nullable, URL -> string, etc.)
+    const encoded = yield* Schema.encodeEffect(SettingsSchema)(settings).pipe(Effect.mapError((error) => makeAppError({
+        code: "SETTINGS_WRITE_FAILED",
+        what: `Failed to encode settings: ${error.message}`,
+        cause: error,
+    })));
+    // Serialize to JSON with pretty printing and trailing newline.
+    const content = JSON.stringify(orderSettingsRecord(encoded), null, 2) + "\n";
+    // Write file
+    yield* fs.writeFileString(settingsPath, content).pipe(Effect.mapError((error) => makeAppError({
+        code: "SETTINGS_WRITE_FAILED",
+        what: `Failed to write settings file: ${settingsPath}`,
+        cause: error,
+    })));
+});
+//# sourceMappingURL=settings.js.map

package/dist/src/unstable/settings/settings.js.map

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

package/dist/src/unstable/skills/disk-check.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared helper for checking if a skill exists on disk in any canonical location.
+ *
+ * Used by SkillManager.isInstalled and uninstall-skill to detect whether a skill
+ * is present in the external or registry extension directories.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+export declare const existsInAnyCanonicalLocation: (fsService: FileSystem.FileSystem, pathService: Path.Path, baseDir: string, skillName: string) => Effect.Effect<boolean, never, never>;
+//# sourceMappingURL=disk-check.d.ts.map

package/dist/src/unstable/skills/disk-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-check.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/disk-check.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,eAAO,MAAM,4BAA4B,GACvC,WAAW,UAAU,CAAC,UAAU,EAChC,aAAa,IAAI,CAAC,IAAI,EACtB,SAAS,MAAM,EACf,WAAW,MAAM,yCA+Bf,CAAC"}

package/dist/src/unstable/skills/disk-check.js

@@ -0,0 +1,38 @@
+/**
+ * Shared helper for checking if a skill exists on disk in any canonical location.
+ *
+ * Used by SkillManager.isInstalled and uninstall-skill to detect whether a skill
+ * is present in the external or registry extension directories.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+import { EXTERNAL_EXTENSIONS_DIR, REGISTRY_EXTENSIONS_DIR } from "../extensions/index.js";
+import { sanitizeName } from "../extensions/utils.js";
+export const existsInAnyCanonicalLocation = (fsService, pathService, baseDir, skillName) => Effect.gen(function* () {
+    const sanitizedName = sanitizeName(skillName);
+    const canonicalExists = yield* fsService
+        .exists(pathService.join(baseDir, EXTERNAL_EXTENSIONS_DIR, "skills", sanitizedName))
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    if (canonicalExists)
+        return true;
+    const extensionsDir = pathService.join(baseDir, REGISTRY_EXTENSIONS_DIR);
+    const extensionsDirExists = yield* fsService
+        .exists(extensionsDir)
+        .pipe(Effect.catch(() => Effect.succeed(false)));
+    if (!extensionsDirExists)
+        return false;
+    const scopeDirs = yield* fsService
+        .readDirectory(extensionsDir)
+        .pipe(Effect.catch(() => Effect.succeed([])));
+    const results = yield* Effect.forEach(scopeDirs, (scopeDir) => {
+        if (!scopeDir.startsWith("@"))
+            return Effect.succeed(false);
+        const skillPath = pathService.join(extensionsDir, scopeDir, "skills", sanitizedName);
+        return fsService.exists(skillPath).pipe(Effect.catch(() => Effect.succeed(false)));
+    }, { concurrency: "unbounded" });
+    return results.some((exists) => exists);
+});
+//# sourceMappingURL=disk-check.js.map

package/dist/src/unstable/skills/disk-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disk-check.js","sourceRoot":"","sources":["../../../../src/unstable/skills/disk-check.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AAC1F,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,SAAgC,EAChC,WAAsB,EACtB,OAAe,EACf,SAAiB,EACjB,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,aAAa,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IAE9C,MAAM,eAAe,GAAG,KAAK,CAAC,CAAC,SAAS;SACrC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;SACnF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,eAAe;QAAE,OAAO,IAAI,CAAC;IAEjC,MAAM,aAAa,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;IACzE,MAAM,mBAAmB,GAAG,KAAK,CAAC,CAAC,SAAS;SACzC,MAAM,CAAC,aAAa,CAAC;SACrB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnD,IAAI,CAAC,mBAAmB;QAAE,OAAO,KAAK,CAAC;IAEvC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,SAAS;SAC/B,aAAa,CAAC,aAAa,CAAC;SAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAwB,EAAE,CAAC,CAAC,CAAC,CAAC;IAEvE,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CACnC,SAAS,EACT,CAAC,QAAQ,EAAE,EAAE;QACX,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QACrF,OAAO,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC,EACD,EAAE,WAAW,EAAE,WAAW,EAAE,CAC7B,CAAC;IAEF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC"}

package/dist/src/unstable/skills/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Skills feature module — types, schemas, manager, and operations.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+export { MANIFEST_FILENAME, SkillManifestSchema, type SkillManifest } from "./manifest-schema.js";
+export type { GitHostedSkillRef, RegistrySkillRef, LocalSkillRef, SkillExtensionRef, } from "./refs.js";
+export type { Skill } from "./types.js";
+export { parseSkillMd, SkillFrontmatterSchema } from "./skill-content.js";
+export { SkillManager, SkillManagerLive } from "./manager.js";
+export { computeSkillPaths, type SkillPathSource, type SkillDirPaths } from "./paths.js";
+export { getSkillDisplayName, getSkillFqn, isReferencedByExtensionPack, getReferencingExtensionPacks, } from "./utils.js";
+export { skillReconciliationAdapter, assertSkillAdapterLoaded } from "./reconciliation-adapter.js";
+export { buildRegistrySkillRef } from "./registry-ref-builder.js";
+export type { InstallSkillOperationArgs, InstallSkillOperation } from "./operations/install.js";
+export { installSkill } from "./operations/install.js";
+export type { InstallResult } from "./operations/install-result.js";
+export type { UninstallSkillOperationArgs, UninstallSkillOperation, } from "./operations/uninstall.js";
+export { uninstallSkill } from "./operations/uninstall.js";
+export type { PublishSkillOperationArgs, PublishSkillOperation } from "./operations/publish.js";
+export { publishSkill } from "./operations/publish.js";
+export type { CopySkillOperationArgs, CopySkillOperation } from "./operations/copy.js";
+export { copySkill } from "./operations/copy.js";
+export type { EnableSkillOperation } from "./operations/enable.js";
+export { enableSkill } from "./operations/enable.js";
+export type { DisableSkillOperation } from "./operations/disable.js";
+export { disableSkill } from "./operations/disable.js";
+export type { RenameSkillOperation } from "./operations/rename.js";
+export { renameSkill } from "./operations/rename.js";
+export type { NewSkillOperationArgs, NewSkillOperation } from "./operations/new-skill.js";
+export { newSkill } from "./operations/new-skill.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGlG,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,iBAAiB,GAClB,MAAM,WAAW,CAAC;AAGnB,YAAY,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAGzF,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAGnG,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,YAAY,EACV,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,YAAY,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC1F,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC"}

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

@@ -0,0 +1,29 @@
+/**
+ * Skills feature module — types, schemas, manager, and operations.
+ *
+ * @experimental All exports from this module are unstable and may change without notice.
+ * @packageDocumentation
+ */
+// Manifest schema
+export { MANIFEST_FILENAME, SkillManifestSchema } from "./manifest-schema.js";
+// Skill content parsing
+export { parseSkillMd, SkillFrontmatterSchema } from "./skill-content.js";
+// Manager
+export { SkillManager, SkillManagerLive } from "./manager.js";
+// Paths
+export { computeSkillPaths } from "./paths.js";
+// Utilities
+export { getSkillDisplayName, getSkillFqn, isReferencedByExtensionPack, getReferencingExtensionPacks, } from "./utils.js";
+// Reconciliation
+export { skillReconciliationAdapter, assertSkillAdapterLoaded } from "./reconciliation-adapter.js";
+// Registry ref builder
+export { buildRegistrySkillRef } from "./registry-ref-builder.js";
+export { installSkill } from "./operations/install.js";
+export { uninstallSkill } from "./operations/uninstall.js";
+export { publishSkill } from "./operations/publish.js";
+export { copySkill } from "./operations/copy.js";
+export { enableSkill } from "./operations/enable.js";
+export { disableSkill } from "./operations/disable.js";
+export { renameSkill } from "./operations/rename.js";
+export { newSkill } from "./operations/new-skill.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/unstable/skills/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,kBAAkB;AAClB,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAsB,MAAM,sBAAsB,CAAC;AAalG,wBAAwB;AACxB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAE1E,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAE9D,QAAQ;AACR,OAAO,EAAE,iBAAiB,EAA4C,MAAM,YAAY,CAAC;AAEzF,YAAY;AACZ,OAAO,EACL,mBAAmB,EACnB,WAAW,EACX,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAEpB,iBAAiB;AACjB,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEnG,uBAAuB;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIlE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/src/unstable/skills/managed-marker-ops.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Managed marker operations for SKILL.md files.
+ *
+ * Shared helper used by both materialization and install flows to prepend
+ * the managed marker to SKILL.md in materialized skill directories.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+/**
+ * Prepend the managed marker to SKILL.md in the materialized skill directory.
+ * No-op if SKILL.md does not exist or already has a marker.
+ * Errors are logged at debug level and swallowed — marker is best-effort.
+ */
+export declare const prependManagedMarkerToSkillMd: (skillSrcPath: string) => Effect.Effect<void, never, FileSystem.FileSystem | Path.Path>;
+/**
+ * Overload accepting explicit FileSystem and Path services (for callers
+ * that have already resolved them, e.g. materialization).
+ */
+export declare const prependManagedMarkerToSkillMdWith: (fs: FileSystem.FileSystem, pathService: Path.Path, skillSrcPath: string) => Effect.Effect<void, never, never>;
+//# sourceMappingURL=managed-marker-ops.d.ts.map

package/dist/src/unstable/skills/managed-marker-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"managed-marker-ops.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/managed-marker-ops.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,GAAI,cAAc,MAAM,kEAoB9D,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,iCAAiC,GAC5C,IAAI,UAAU,CAAC,UAAU,EACzB,aAAa,IAAI,CAAC,IAAI,EACtB,cAAc,MAAM,sCAmBlB,CAAC"}

package/dist/src/unstable/skills/managed-marker-ops.js

@@ -0,0 +1,46 @@
+/**
+ * Managed marker operations for SKILL.md files.
+ *
+ * Shared helper used by both materialization and install flows to prepend
+ * the managed marker to SKILL.md in materialized skill directories.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import { generateMarker, isManagedByAxm } from "../extensions/managed-marker.js";
+/**
+ * Prepend the managed marker to SKILL.md in the materialized skill directory.
+ * No-op if SKILL.md does not exist or already has a marker.
+ * Errors are logged at debug level and swallowed — marker is best-effort.
+ */
+export const prependManagedMarkerToSkillMd = (skillSrcPath) => Effect.gen(function* () {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const skillMdPath = path.join(skillSrcPath, "SKILL.md");
+    const exists = yield* fs.exists(skillMdPath).pipe(Effect.tapError((e) => Effect.logDebug(`Failed to check SKILL.md existence: ${e}`)), Effect.catch(() => Effect.succeed(false)));
+    if (!exists)
+        return;
+    const content = yield* fs.readFileString(skillMdPath).pipe(Effect.tapError((e) => Effect.logDebug(`Failed to read SKILL.md: ${e}`)), Effect.catch(() => Effect.succeed("")));
+    if (content === "" || isManagedByAxm(content))
+        return;
+    const marker = generateMarker("skills", "markdown");
+    yield* fs.writeFileString(skillMdPath, `${marker}\n${content}`).pipe(Effect.tapError((e) => Effect.logDebug(`Failed to write managed marker to SKILL.md: ${e}`)), Effect.catch(() => Effect.void));
+});
+/**
+ * Overload accepting explicit FileSystem and Path services (for callers
+ * that have already resolved them, e.g. materialization).
+ */
+export const prependManagedMarkerToSkillMdWith = (fs, pathService, skillSrcPath) => Effect.gen(function* () {
+    const skillMdPath = pathService.join(skillSrcPath, "SKILL.md");
+    const exists = yield* fs.exists(skillMdPath).pipe(Effect.tapError((e) => Effect.logDebug(`Failed to check SKILL.md existence: ${e}`)), Effect.catch(() => Effect.succeed(false)));
+    if (!exists)
+        return;
+    const content = yield* fs.readFileString(skillMdPath).pipe(Effect.tapError((e) => Effect.logDebug(`Failed to read SKILL.md: ${e}`)), Effect.catch(() => Effect.succeed("")));
+    if (content === "" || isManagedByAxm(content))
+        return;
+    const marker = generateMarker("skills", "markdown");
+    yield* fs.writeFileString(skillMdPath, `${marker}\n${content}`).pipe(Effect.tapError((e) => Effect.logDebug(`Failed to write managed marker to SKILL.md: ${e}`)), Effect.catch(() => Effect.void));
+});
+//# sourceMappingURL=managed-marker-ops.js.map

package/dist/src/unstable/skills/managed-marker-ops.js.map

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

package/dist/src/unstable/skills/manager.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Skill extension manager service.
+ *
+ * Implements ExtensionManager<SkillExtensionRef> with native/non-native
+ * branching in materializeInstall and agent symlink creation for all
+ * configured agents.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as ServiceMap from "effect/ServiceMap";
+import * as Layer from "effect/Layer";
+import type { SkillExtensionRef } from "./refs.js";
+import { SourceHostProviders } from "../source-resolution/index.js";
+import type { ExtensionManager } from "../workspace/service-interface.js";
+import { Workspace } from "../workspace/service-interface.js";
+import { CodingAgentRepository } from "../agents/index.js";
+declare const SkillManager_base: ServiceMap.ServiceClass<SkillManager, "axm.sh/SkillManager", ExtensionManager<SkillExtensionRef>>;
+export declare class SkillManager extends SkillManager_base {
+}
+export declare const SkillManagerLive: Layer.Layer<SkillManager, import("../app-error/app-error.ts").AppError, FileSystem.FileSystem | Path.Path | Workspace | CodingAgentRepository | SourceHostProviders>;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/src/unstable/skills/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../../src/unstable/skills/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAItC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,mCAAmC,CAAC;AAChG,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAI9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;;AAa3D,qBAAa,YAAa,SAAQ,iBAGR;CAAG;AAoB7B,eAAO,MAAM,gBAAgB,sKA6M5B,CAAC"}

package/dist/src/unstable/skills/manager.js

@@ -0,0 +1,167 @@
+/**
+ * Skill extension manager service.
+ *
+ * Implements ExtensionManager<SkillExtensionRef> with native/non-native
+ * branching in materializeInstall and agent symlink creation for all
+ * configured agents.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Array from "effect/Array";
+import * as ServiceMap from "effect/ServiceMap";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import { makeAppError } from "../app-error/index.js";
+import { sourceToLockEntry } from "../sources/index.js";
+import { SourceHostProviders } from "../source-resolution/index.js";
+import { Workspace } from "../workspace/service-interface.js";
+import { existsInAnyCanonicalLocation } from "./disk-check.js";
+import { sanitizeName } from "../extensions/utils.js";
+import { removeFromAllCanonicalLocations } from "../utils/index.js";
+import { CodingAgentRepository } from "../agents/index.js";
+import { validateExactResolvedVersion } from "../lockfile/index.js";
+import { ensureSkillAgentArtifact, materializeSkillCanonical, removeSkillAgentArtifact, } from "./materialization.js";
+// -----------------------------------------------------------------------------
+// Service Tag
+// -----------------------------------------------------------------------------
+export class SkillManager extends ServiceMap.Service()("axm.sh/SkillManager") {
+}
+// -----------------------------------------------------------------------------
+// Helpers
+// -----------------------------------------------------------------------------
+// Build skill lock entry from ref
+const buildSkillLockEntry = (ref, agents) => sourceToLockEntry({
+    ref,
+    agents,
+    now: new Date(),
+    sourceName: Option.none(),
+    existingInstalledAt: Option.none(),
+});
+// -----------------------------------------------------------------------------
+// Live Layer
+// -----------------------------------------------------------------------------
+export const SkillManagerLive = Layer.effect(SkillManager, Effect.gen(function* () {
+    const ws = yield* Workspace;
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const sources = yield* SourceHostProviders;
+    const agentRepo = yield* CodingAgentRepository;
+    const agents = yield* ws.getConfiguredAgents();
+    const baseDir = ws.baseDir;
+    // Build a layer to provide FileSystem + Path to inner effects
+    const fsPathLayer = Layer.mergeAll(Layer.succeed(FileSystem.FileSystem, fs), Layer.succeed(Path.Path, path));
+    // Provide FileSystem + Path to an effect that needs them
+    const provide = (effect) => Effect.provide(effect, fsPathLayer);
+    const materializeInstall = Effect.fn("SkillManager.materializeInstall")(function* ({ ref }) {
+        const sanitized = sanitizeName(ref.skill.name);
+        const skillSrcPath = yield* materializeSkillCanonical({
+            ref,
+            sanitizedName: sanitized,
+            fs,
+            pathService: path,
+            baseDir,
+            sources,
+            provide,
+        });
+        const configuredAgents = yield* agentRepo
+            .getConfiguredAgents()
+            .pipe(Effect.provideService(Workspace, ws));
+        const resolved = yield* Effect.forEach(configuredAgents, (agent) => agent.resolveEffectiveSkillsDir({ workspaceRoot: baseDir }).pipe(Effect.provide(fsPathLayer), Effect.map((outcome) => ({ agent, outcome }))), { concurrency: "unbounded" });
+        const misconfigured = Array.filter(resolved, ({ outcome }) => outcome._tag === "misconfigured");
+        if (misconfigured.length > 0) {
+            const details = misconfigured.map(({ agent, outcome }) => outcome._tag === "misconfigured"
+                ? `${agent.id}: ${outcome.reason}`
+                : `${agent.id}: invalid configuration`);
+            return yield* makeAppError({
+                code: "SKILL_DIR_MISCONFIGURED",
+                what: "One or more configured agents have invalid skills directory settings",
+                details,
+            });
+        }
+        const installTargets = [];
+        for (const { outcome } of resolved) {
+            if (outcome._tag === "supported") {
+                installTargets.push(path.normalize(outcome.dir));
+            }
+        }
+        const distinctDirs = Array.dedupe(installTargets);
+        yield* Effect.forEach(distinctDirs, (dir) => ensureSkillAgentArtifact({
+            canonicalSkillSrcPath: skillSrcPath,
+            targetDir: dir,
+            sanitizedName: sanitized,
+            pathService: path,
+            baseDir,
+            provide,
+        }), { concurrency: "unbounded" });
+    });
+    const materializeUninstall = Effect.fn("SkillManager.materializeUninstall")(function* ({ target }) {
+        const sanitized = sanitizeName(target.name);
+        const configuredAgents = yield* agentRepo
+            .getConfiguredAgents()
+            .pipe(Effect.provideService(Workspace, ws));
+        const resolved = yield* Effect.forEach(configuredAgents, (agent) => agent.resolveEffectiveSkillsDir({ workspaceRoot: baseDir }).pipe(Effect.provide(fsPathLayer), Effect.map((outcome) => ({ agent, outcome }))), { concurrency: "unbounded" });
+        const uninstallTargets = [];
+        for (const { outcome } of resolved) {
+            if (outcome._tag === "supported") {
+                uninstallTargets.push(path.normalize(outcome.dir));
+            }
+        }
+        const distinctDirs = Array.dedupe(uninstallTargets);
+        yield* Effect.forEach(distinctDirs, (dir) => removeSkillAgentArtifact({
+            fs,
+            pathService: path,
+            targetDir: dir,
+            sanitizedName: sanitized,
+        }), { concurrency: "unbounded" });
+        yield* removeFromAllCanonicalLocations(fs, baseDir, sanitized, path);
+    });
+    return {
+        type: "skill",
+        isInstalled: Effect.fn("SkillManager.isInstalled")(function* ({ target, }) {
+            const installedSkills = yield* ws.getInstalledSkills();
+            if (target.name in installedSkills) {
+                return true;
+            }
+            return yield* existsInAnyCanonicalLocation(fs, path, baseDir, target.name);
+        }),
+        materializeInstall,
+        materializeUninstall,
+        upsertSettingsEntry: ({ ref, versionConstraint, }) => {
+            const lockEntry = buildSkillLockEntry(ref, agents);
+            if (lockEntry.type === "registry") {
+                return validateExactResolvedVersion(`skills.${ref.skill.name}.resolvedVersion`, lockEntry.resolvedVersion).pipe(Effect.flatMap(() => ws.setSkill({ name: ref.skill.name, lockEntry, versionConstraint })), Effect.withSpan("SkillManager.upsertSettingsEntry"));
+            }
+            return ws
+                .setSkill({ name: ref.skill.name, lockEntry, versionConstraint })
+                .pipe(Effect.withSpan("SkillManager.upsertSettingsEntry"));
+        },
+        removeSettingsEntry: ({ target }) => ws
+            .removeSkillFromSettings(target.name)
+            .pipe(Effect.withSpan("SkillManager.removeSettingsEntry")),
+        upsertLockfileEntry: ({ ref }) => {
+            const lockEntry = buildSkillLockEntry(ref, agents);
+            if (lockEntry.type === "registry") {
+                return validateExactResolvedVersion(`skills.${ref.skill.name}.resolvedVersion`, lockEntry.resolvedVersion).pipe(Effect.flatMap(() => ws.setSkillLock({
+                    name: ref.skill.name,
+                    lockEntry,
+                    versionConstraint: Option.none(),
+                })), Effect.withSpan("SkillManager.upsertLockfileEntry"));
+            }
+            return ws
+                .setSkillLock({
+                name: ref.skill.name,
+                lockEntry,
+                versionConstraint: Option.none(),
+            })
+                .pipe(Effect.withSpan("SkillManager.upsertLockfileEntry"));
+        },
+        removeLockfileEntry: ({ target }) => ws.removeSkillLock(target.name).pipe(Effect.withSpan("SkillManager.removeLockfileEntry")),
+    };
+}));
+// -----------------------------------------------------------------------------
+// Internal materialization helpers
+// -----------------------------------------------------------------------------
+//# sourceMappingURL=manager.js.map

package/dist/src/unstable/skills/manager.js.map

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