@agentxm/client-core 0.1.6

package/dist/src/unstable/extensions/reconciliation-utils.js

@@ -0,0 +1,57 @@
+/**
+ * Shared reconciliation utilities for disk compatibility checks.
+ *
+ * Extracts the common pattern used by skills and packs reconciliation adapters
+ * for checking disk existence, reading manifests, and decoding them.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { makeAppError } from "../app-error/index.js";
+/**
+ * Check that a canonical path exists on disk, read a manifest file,
+ * parse its JSON, and decode it with the provided function.
+ *
+ * Returns an Unresolved DeclarationResolution when the path is missing,
+ * the manifest is empty, JSON parsing fails, or decoding fails.
+ * Returns the decoded manifest on success.
+ */
+export const readAndDecodeManifest = (declaration, canonicalPath, manifestFilename, decode, extensionLabel, env) => Effect.gen(function* () {
+    const exists = yield* env.fs.exists(canonicalPath).pipe(Effect.mapError((error) => makeAppError({
+        code: "LOCKFILE_RECONCILE_DISK_CHECK_FAILED",
+        what: `Failed to check ${extensionLabel} path: ${canonicalPath}`,
+        cause: error,
+    })));
+    if (!exists) {
+        return {
+            _tag: "Unresolved",
+            declaration,
+            reason: "missing",
+        };
+    }
+    const manifestPath = env.path.join(canonicalPath, manifestFilename);
+    const manifestRaw = yield* env.fs
+        .readFileString(manifestPath)
+        .pipe(Effect.catch(() => Effect.succeed("")));
+    if (manifestRaw.length === 0) {
+        return {
+            _tag: "Unresolved",
+            declaration,
+            reason: "invalid",
+        };
+    }
+    const manifestJson = yield* Effect.try({
+        try: () => JSON.parse(manifestRaw),
+        catch: () => "parse-failed",
+    }).pipe(Effect.catch(() => Effect.void));
+    const manifest = decode(manifestJson);
+    if (manifest === null) {
+        return {
+            _tag: "Unresolved",
+            declaration,
+            reason: "invalid",
+        };
+    }
+    return { _tag: "ok", manifest, canonicalPath };
+});
+//# sourceMappingURL=reconciliation-utils.js.map

package/dist/src/unstable/extensions/reconciliation-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation-utils.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/reconciliation-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAOrD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,WAAsC,EACtC,aAAqB,EACrB,gBAAwB,EACxB,MAAmC,EACnC,cAAsB,EACtB,GAAuB,EACvB,EAAE,CACF,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CACrD,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,YAAY,CAAC;QACX,IAAI,EAAE,sCAAsC;QAC5C,IAAI,EAAE,mBAAmB,cAAc,UAAU,aAAa,EAAE;QAChE,KAAK,EAAE,KAAK;KACb,CAAC,CACH,CACF,CAAC;IAEF,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,WAAW;YACX,MAAM,EAAE,SAAS;SACc,CAAC;IACpC,CAAC;IAED,MAAM,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;IACpE,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE;SAC9B,cAAc,CAAC,YAAY,CAAC;SAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAEhD,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,WAAW;YACX,MAAM,EAAE,SAAS;SACc,CAAC;IACpC,CAAC;IAED,MAAM,YAAY,GAAY,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAC9C,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;QAClC,KAAK,EAAE,GAAG,EAAE,CAAC,cAAc;KAC5B,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzC,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC;IAEtC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,WAAW;YACX,MAAM,EAAE,SAAS;SACc,CAAC;IACpC,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,IAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;AAC1D,CAAC,CAAC,CAAC"}

package/dist/src/unstable/extensions/ref-base.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Base types for extension references.
+ *
+ * Defines the foundational type hierarchy used by all extension types.
+ * Per-type concrete refs live in their respective feature folders
+ * (skills/refs.ts, commands/refs.ts, etc.).
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { ExtensionName, ExtensionType } from "./common.js";
+import type * as Option from "effect/Option";
+import type * as Record from "effect/Record";
+import type { RefType, Source } from "../sources/types.js";
+import type { ExtensionDependencyConstraintMap } from "./common.js";
+import type { ExactSemverVersion } from "../version-constraints/version-constraints.js";
+import type { Handle } from "./handle.js";
+import type { PackageUrlParts } from "../packaging/package-url.js";
+/** Ref details for git-hosted sources (GitHub, GitLab, Bitbucket, AzureRepos, Git). @experimental */
+export interface GitHostedRefDetails {
+    /** file:// URL to cloned directory */
+    readonly location: string;
+    /** Git tree SHA for integrity verification */
+    readonly gitTreeSha: Option.Option<string>;
+}
+/** Ref details for registry sources. @experimental */
+export interface RegistryRefDetails {
+    /** Registry owner that owns the published extension */
+    readonly owner: Handle;
+    /**
+     * Registry package name — the identifier used for registry operations (fetch, version resolution).
+     * This may differ from the extension-specific display name (e.g., skill.name, pack.name,
+     * server.name) which is the user-facing name parsed from the extension's manifest.
+     */
+    readonly name: ExtensionName;
+    /** Resolved semver version */
+    readonly version: ExactSemverVersion;
+    /** SRI integrity string in `sha512-<base64>` format. None for synthetic refs (fork/publish). */
+    readonly integrity: Option.Option<string>;
+    /** Package URLs this extension is compatible with, from registry metadata. Empty when absent. */
+    readonly compatiblePackages: ReadonlyArray<PackageUrlParts>;
+}
+/** Ref details for local filesystem sources. @experimental */
+export interface LocalRefDetails {
+    /** file:// URL to local directory */
+    readonly location: string;
+}
+/** @experimental */
+export interface ExtensionRefBase<TExtensionType extends ExtensionType, TRefType extends RefType, TSource extends Source> {
+    readonly type: TExtensionType;
+    readonly refType: TRefType;
+    readonly source: TSource;
+}
+/** @experimental */
+export type SkillExtensionRefBase<TRefType extends RefType, TSource extends Source> = ExtensionRefBase<"skill", TRefType, TSource> & {
+    readonly skill: {
+        readonly name: ExtensionName;
+        readonly description: Option.Option<string>;
+        readonly metadata: Option.Option<Record.ReadonlyRecord<string, unknown>>;
+    };
+};
+/** @experimental */
+export type CommandExtensionRefBase<TRefType extends RefType, TSource extends Source> = ExtensionRefBase<"command", TRefType, TSource> & {
+    readonly command: {
+        readonly name: ExtensionName;
+    };
+};
+/** @experimental */
+export type McpServerExtensionRefBase<TRefType extends RefType, TSource extends Source> = ExtensionRefBase<"mcp-server", TRefType, TSource> & {
+    readonly server: {
+        readonly name: ExtensionName;
+    };
+};
+/** @experimental */
+export type SubagentExtensionRefBase<TRefType extends RefType, TSource extends Source> = ExtensionRefBase<"subagent", TRefType, TSource> & {
+    readonly subagent: {
+        readonly name: ExtensionName;
+        readonly description: Option.Option<string>;
+    };
+};
+/** @experimental */
+export type ExtensionPackRefBase<TRefType extends RefType, TSource extends Source> = ExtensionRefBase<"pack", TRefType, TSource> & {
+    readonly owner: Handle;
+    readonly pack: {
+        readonly name: ExtensionName;
+        readonly skills: ExtensionDependencyConstraintMap;
+        readonly commands: ExtensionDependencyConstraintMap;
+        readonly mcpServers: ExtensionDependencyConstraintMap;
+        readonly subagents: ExtensionDependencyConstraintMap;
+    };
+};
+//# sourceMappingURL=ref-base.d.ts.map

package/dist/src/unstable/extensions/ref-base.d.ts.map

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

package/dist/src/unstable/extensions/ref-base.js

@@ -0,0 +1,12 @@
+/**
+ * Base types for extension references.
+ *
+ * Defines the foundational type hierarchy used by all extension types.
+ * Per-type concrete refs live in their respective feature folders
+ * (skills/refs.ts, commands/refs.ts, etc.).
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=ref-base.js.map

package/dist/src/unstable/extensions/ref-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref-base.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/ref-base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/src/unstable/extensions/refs.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Extension ref union assembler.
+ *
+ * Imports per-type concrete refs from feature folders and defines the
+ * unified `ExtensionRef` union. This file is a leaf — feature folders
+ * import only from `ref-base.ts`, never from this file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { SkillExtensionRef } from "../skills/refs.js";
+import type { CommandExtensionRef } from "../commands/refs.js";
+import type { McpServerExtensionRef } from "../mcp-servers/refs.js";
+import type { SubagentExtensionRef } from "../subagents/refs.js";
+import type { ExtensionPackRef } from "../packs/refs.js";
+/** @experimental */
+export type ExtensionRef = SkillExtensionRef | CommandExtensionRef | McpServerExtensionRef | SubagentExtensionRef | ExtensionPackRef;
+//# sourceMappingURL=refs.d.ts.map

package/dist/src/unstable/extensions/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,oBAAoB;AACpB,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,mBAAmB,GACnB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,CAAC"}

package/dist/src/unstable/extensions/refs.js

@@ -0,0 +1,12 @@
+/**
+ * Extension ref union assembler.
+ *
+ * Imports per-type concrete refs from feature folders and defines the
+ * unified `ExtensionRef` union. This file is a leaf — feature folders
+ * import only from `ref-base.ts`, never from this file.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+export {};
+//# sourceMappingURL=refs.js.map

package/dist/src/unstable/extensions/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/dist/src/unstable/extensions/registry-source.d.ts

@@ -0,0 +1,32 @@
+import * as Schema from "effect/Schema";
+export declare const RegistrySourcePatternPartsSchema: Schema.Struct<{
+    readonly owner: Schema.brand<Schema.String, "Handle">;
+    readonly type: Schema.optional<Schema.Literals<readonly ["skills", "commands", "mcp-servers", "subagents", "files", "rules", "packs"]>>;
+    readonly name: Schema.optional<Schema.brand<Schema.String, "ExtensionName">>;
+    readonly versionConstraint: Schema.optional<Schema.brand<Schema.String, "VersionConstraint">>;
+}>;
+export type RegistrySourcePatternParts = Schema.Schema.Type<typeof RegistrySourcePatternPartsSchema>;
+export declare const RegistrySourceRefPartsSchema: Schema.Struct<{
+    readonly owner: Schema.brand<Schema.String, "Handle">;
+    readonly type: Schema.Literals<readonly ["skills", "commands", "mcp-servers", "subagents", "files", "rules", "packs"]>;
+    readonly name: Schema.brand<Schema.String, "ExtensionName">;
+    readonly versionConstraint: Schema.optional<Schema.brand<Schema.String, "VersionConstraint">>;
+}>;
+export type RegistrySourceRefParts = Schema.Schema.Type<typeof RegistrySourceRefPartsSchema>;
+export declare const parseRegistrySourcePatternParts: (input: string) => RegistrySourcePatternParts | undefined;
+export declare const parseRegistrySourceRef: (input: string) => RegistrySourceRefParts | undefined;
+export declare const formatRegistrySourcePatternParts: (value: RegistrySourcePatternParts) => string;
+export declare const formatRegistrySourceRef: (value: RegistrySourceRefParts) => string;
+export declare const RegistrySourcePatternSchema: Schema.decodeTo<Schema.toType<Schema.Struct<{
+    readonly owner: Schema.brand<Schema.String, "Handle">;
+    readonly type: Schema.optional<Schema.Literals<readonly ["skills", "commands", "mcp-servers", "subagents", "files", "rules", "packs"]>>;
+    readonly name: Schema.optional<Schema.brand<Schema.String, "ExtensionName">>;
+    readonly versionConstraint: Schema.optional<Schema.brand<Schema.String, "VersionConstraint">>;
+}>>, Schema.String, never, never>;
+export declare const RegistrySourceRefSchema: Schema.decodeTo<Schema.toType<Schema.Struct<{
+    readonly owner: Schema.brand<Schema.String, "Handle">;
+    readonly type: Schema.Literals<readonly ["skills", "commands", "mcp-servers", "subagents", "files", "rules", "packs"]>;
+    readonly name: Schema.brand<Schema.String, "ExtensionName">;
+    readonly versionConstraint: Schema.optional<Schema.brand<Schema.String, "VersionConstraint">>;
+}>>, Schema.String, never, never>;
+//# sourceMappingURL=registry-source.d.ts.map

package/dist/src/unstable/extensions/registry-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-source.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/registry-source.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAaxC,eAAO,MAAM,gCAAgC;;;;;EA8BzC,CAAC;AAEL,MAAM,MAAM,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CACzD,OAAO,gCAAgC,CACxC,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;EAUvC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,4BAA4B,CAAC,CAAC;AA4B7F,eAAO,MAAM,+BAA+B,GAC1C,OAAO,MAAM,KACZ,0BAA0B,GAAG,SAqD/B,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,KAAG,sBAAsB,GAAG,SAQ/E,CAAC;AAEF,eAAO,MAAM,gCAAgC,GAAI,OAAO,0BAA0B,KAAG,MAgBpF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,OAAO,sBAAsB,KAAG,MAC/B,CAAC;AAE1C,eAAO,MAAM,2BAA2B;;;;;iCAiBvC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;iCAiBnC,CAAC"}

package/dist/src/unstable/extensions/registry-source.js

@@ -0,0 +1,150 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import * as SchemaIssue from "effect/SchemaIssue";
+import * as SchemaTransformation from "effect/SchemaTransformation";
+import { ExtensionNameSchema, ExtensionTypePluralSchema } from "./common.js";
+import { HandleSchema } from "./handle.js";
+import { VersionConstraintSchema } from "../version-constraints/version-constraints.js";
+const invalidRegistrySourcePattern = (input) => `Expected registry source pattern in @handle, @handle/<plural-type>, or @handle/<plural-type>/<name>@<constraint> form, got: ${input}`;
+const invalidRegistrySourceRef = (input) => `Expected registry source ref in @handle/<plural-type>/<name>@<constraint> form, got: ${input}`;
+export const RegistrySourcePatternPartsSchema = Schema.Struct({
+    owner: HandleSchema,
+    type: Schema.optional(ExtensionTypePluralSchema),
+    name: Schema.optional(ExtensionNameSchema),
+    versionConstraint: Schema.optional(VersionConstraintSchema),
+})
+    .pipe(Schema.check(Schema.makeFilter((value) => {
+    if (value.type === undefined) {
+        return value.name === undefined && value.versionConstraint === undefined
+            ? undefined
+            : "Registry source pattern cannot include name or versionConstraint without type";
+    }
+    if (value.name === undefined) {
+        return value.versionConstraint === undefined
+            ? undefined
+            : "Registry source pattern cannot include versionConstraint without name";
+    }
+    return undefined;
+})))
+    .annotate({
+    identifier: "RegistrySourcePatternParts",
+    title: "Registry Source Pattern",
+    description: "Structured registry source pattern: @handle, @handle/<type>, or @handle/<type>/<name>@<constraint>.",
+});
+export const RegistrySourceRefPartsSchema = Schema.Struct({
+    owner: HandleSchema,
+    type: ExtensionTypePluralSchema,
+    name: ExtensionNameSchema,
+    versionConstraint: Schema.optional(VersionConstraintSchema),
+}).annotate({
+    identifier: "RegistrySourceRefParts",
+    title: "Registry Source Ref",
+    description: "Structured registry source ref: @handle/<type>/<name> with optional version constraint.",
+});
+const decodeRegistrySourcePatternParts = Schema.decodeUnknownResult(RegistrySourcePatternPartsSchema);
+const decodeRegistrySourceRefParts = Schema.decodeUnknownResult(RegistrySourceRefPartsSchema);
+const parseNameAndConstraintSegment = (segment) => {
+    const atIndex = segment.indexOf("@");
+    if (atIndex === 0) {
+        return undefined;
+    }
+    if (atIndex === -1) {
+        return { name: segment };
+    }
+    const name = segment.slice(0, atIndex);
+    const versionConstraint = segment.slice(atIndex + 1);
+    if (name.length === 0 || versionConstraint.length === 0) {
+        return undefined;
+    }
+    return { name, versionConstraint };
+};
+export const parseRegistrySourcePatternParts = (input) => {
+    if (!input.startsWith("@")) {
+        return undefined;
+    }
+    const segments = input.split("/");
+    if (segments.length < 1 || segments.length > 3) {
+        return undefined;
+    }
+    const owner = segments[0];
+    if (owner === undefined) {
+        return undefined;
+    }
+    let candidate;
+    if (segments.length === 1) {
+        candidate = { owner };
+    }
+    else if (segments.length === 2) {
+        const type = segments[1];
+        if (type !== undefined) {
+            candidate = { owner, type };
+        }
+    }
+    else {
+        const type = segments[1];
+        const third = segments[2];
+        if (type !== undefined && third !== undefined) {
+            const parsedName = parseNameAndConstraintSegment(third);
+            if (parsedName !== undefined) {
+                candidate = {
+                    owner,
+                    type,
+                    name: parsedName.name,
+                    versionConstraint: parsedName.versionConstraint,
+                };
+            }
+        }
+    }
+    if (candidate === undefined) {
+        return undefined;
+    }
+    const result = decodeRegistrySourcePatternParts(candidate);
+    return Result.isSuccess(result) ? result.success : undefined;
+};
+export const parseRegistrySourceRef = (input) => {
+    const parsed = parseRegistrySourcePatternParts(input);
+    if (parsed?.type === undefined || parsed.name === undefined) {
+        return undefined;
+    }
+    const result = decodeRegistrySourceRefParts(parsed);
+    return Result.isSuccess(result) ? result.success : undefined;
+};
+export const formatRegistrySourcePatternParts = (value) => {
+    let output = value.owner;
+    if (value.type !== undefined) {
+        output += `/${value.type}`;
+    }
+    if (value.name !== undefined) {
+        output += `/${value.name}`;
+    }
+    if (value.versionConstraint !== undefined) {
+        output += `@${value.versionConstraint}`;
+    }
+    return output;
+};
+export const formatRegistrySourceRef = (value) => formatRegistrySourcePatternParts(value);
+export const RegistrySourcePatternSchema = Schema.String.pipe(Schema.decodeTo(Schema.toType(RegistrySourcePatternPartsSchema), SchemaTransformation.transformOrFail({
+    decode: (input) => {
+        const parsed = parseRegistrySourcePatternParts(input);
+        return parsed === undefined
+            ? Effect.fail(new SchemaIssue.Forbidden(Option.some(input), {
+                message: invalidRegistrySourcePattern(input),
+            }))
+            : Effect.succeed(parsed);
+    },
+    encode: (value) => Effect.succeed(formatRegistrySourcePatternParts(value)),
+})));
+export const RegistrySourceRefSchema = Schema.String.pipe(Schema.decodeTo(Schema.toType(RegistrySourceRefPartsSchema), SchemaTransformation.transformOrFail({
+    decode: (input) => {
+        const parsed = parseRegistrySourceRef(input);
+        return parsed === undefined
+            ? Effect.fail(new SchemaIssue.Forbidden(Option.some(input), {
+                message: invalidRegistrySourceRef(input),
+            }))
+            : Effect.succeed(parsed);
+    },
+    encode: (value) => Effect.succeed(formatRegistrySourceRef(value)),
+})));
+//# sourceMappingURL=registry-source.js.map

package/dist/src/unstable/extensions/registry-source.js.map

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

package/dist/src/unstable/extensions/rendered-files.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Rendered files tracking utilities for extension-managed output files.
+ *
+ * Provides schemas and hashing for tracking which files an extension has
+ * rendered, keyed by agent ID. Used as a lockfile mixin.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+/**
+ * Branded string for content source hashes.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const SourceHashSchema: Schema.brand<Schema.String, "SourceHash">;
+/**
+ * Branded SourceHash type.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type SourceHash = Schema.Schema.Type<typeof SourceHashSchema>;
+/**
+ * Branded string for rendered file paths.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const RenderedFilePathSchema: Schema.brand<Schema.String, "RenderedFilePath">;
+/**
+ * Branded RenderedFilePath type.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type RenderedFilePath = Schema.Schema.Type<typeof RenderedFilePathSchema>;
+/**
+ * Schema for the rendered files map — a record keyed by agent ID,
+ * where each value is an array of rendered file entries.
+ *
+ * Used as a lockfile mixin to track which files have been rendered
+ * per agent.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const RenderedFilesMapSchema: Schema.$Record<Schema.String, Schema.$Array<Schema.Struct<{
+    readonly path: Schema.brand<Schema.String, "RenderedFilePath">;
+}>>>;
+/**
+ * Inferred type for the rendered files map.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type RenderedFilesMap = Schema.Schema.Type<typeof RenderedFilesMapSchema>;
+/**
+ * Compute a SHA-256 hash of arbitrary content.
+ *
+ * Callers determine what to hash — this function accepts any string content
+ * and returns a branded SourceHash.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const computeSourceHash: (content: string) => SourceHash;
+//# sourceMappingURL=rendered-files.d.ts.map

package/dist/src/unstable/extensions/rendered-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendered-files.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/rendered-files.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,2CAAiD,CAAC;AAE/E;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,iDAAuD,CAAC;AAE3F;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAWjF;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB;;IAGlC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAIjF;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,KAAG,UACyB,CAAC"}

package/dist/src/unstable/extensions/rendered-files.js

@@ -0,0 +1,51 @@
+/**
+ * Rendered files tracking utilities for extension-managed output files.
+ *
+ * Provides schemas and hashing for tracking which files an extension has
+ * rendered, keyed by agent ID. Used as a lockfile mixin.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as crypto from "node:crypto";
+import * as Schema from "effect/Schema";
+/**
+ * Branded string for content source hashes.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const SourceHashSchema = Schema.String.pipe(Schema.brand("SourceHash"));
+/**
+ * Branded string for rendered file paths.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const RenderedFilePathSchema = Schema.String.pipe(Schema.brand("RenderedFilePath"));
+/**
+ * Schema for a single rendered file entry.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+const RenderedFileEntrySchema = Schema.Struct({
+    path: RenderedFilePathSchema,
+});
+/**
+ * Schema for the rendered files map — a record keyed by agent ID,
+ * where each value is an array of rendered file entries.
+ *
+ * Used as a lockfile mixin to track which files have been rendered
+ * per agent.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const RenderedFilesMapSchema = Schema.Record(Schema.String, Schema.Array(RenderedFileEntrySchema));
+const decodeSourceHash = Schema.decodeUnknownSync(SourceHashSchema);
+/**
+ * Compute a SHA-256 hash of arbitrary content.
+ *
+ * Callers determine what to hash — this function accepts any string content
+ * and returns a branded SourceHash.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const computeSourceHash = (content) => decodeSourceHash(crypto.createHash("sha256").update(content).digest("hex"));
+//# sourceMappingURL=rendered-files.js.map

package/dist/src/unstable/extensions/rendered-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rendered-files.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/rendered-files.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;AAS/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAS3F;;;;GAIG;AACH,MAAM,uBAAuB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,sBAAsB;CAC7B,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,MAAM,CACjD,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CACtC,CAAC;AASF,MAAM,gBAAgB,GAAG,MAAM,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAc,EAAE,CAC/D,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC"}

package/dist/src/unstable/extensions/utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared extension utilities.
+ *
+ * Cross-cutting utilities used by multiple extension types.
+ * Promoted from skills-specific modules to avoid cross-feature dependencies.
+ *
+ * @experimental This API is unstable and may change without notice.
+ * @packageDocumentation
+ */
+import type { PlatformError } from "effect/PlatformError";
+import * as FileSystem from "effect/FileSystem";
+import * as Path from "effect/Path";
+import * as Effect from "effect/Effect";
+/**
+ * Sanitizes an extension name into a safe on-disk directory name.
+ *
+ * Transformation pipeline:
+ * 1. Convert to lowercase
+ * 2. Replace non-alphanumeric characters (except `.` and `_`) with hyphens
+ * 3. Strip leading and trailing dots and hyphens
+ * 4. Truncate to 255 characters
+ * 5. Fall back to `"unnamed-skill"` if empty
+ */
+export declare const sanitizeName: (name: string) => string;
+export declare const validatePathSafety: (baseDir: string, targetPath: string, code: string) => import("../app-error/app-error.ts").AppError | Effect.Effect<void, never, never>;
+/**
+ * Recursively copies an extension directory from `src` to `dest`.
+ *
+ * Exclusions: README.md, metadata.json, `_`-prefixed entries, `.git`.
+ * Symlinks are dereferenced (file content is copied, not the link).
+ * Directory entries are copied concurrently.
+ */
+export declare const copyExtensionDirectory: (src: string, dest: string) => Effect.Effect<void, PlatformError, FileSystem.FileSystem | Path.Path>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/unstable/extensions/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAQxC;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAU3C,CAAC;AAMF,eAAO,MAAM,kBAAkB,GAAI,SAAS,MAAM,EAAE,YAAY,MAAM,EAAE,MAAM,MAAM,qFAM5E,CAAC;AA+CT;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,KAAK,MAAM,EACX,MAAM,MAAM,KACX,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAKnE,CAAC"}