@agentxm/client-core 0.1.6

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

@@ -0,0 +1,283 @@
+/**
+ * Common schema definitions shared across AXM configuration files.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Schema from "effect/Schema";
+import * as Option from "effect/Option";
+import * as Result from "effect/Result";
+import { AGENT_IDS } from "../agents/types.js";
+import { HANDLE_PATTERN_SOURCE, HandleSchema } from "./handle.js";
+import { PackageUrlSchema } from "../packaging/package-url.js";
+import { ExactSemverVersionSchema, VersionConstraintSchema, } from "../version-constraints/version-constraints.js";
+/**
+ * Author information for a manifest.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const AuthorSchema = Schema.Struct({
+    name: Schema.String.pipe(Schema.annotateKey({ messageMissingKey: "author name is required" })),
+    email: Schema.optional(Schema.String),
+    url: Schema.optional(Schema.String),
+}).annotate({
+    identifier: "Author",
+    title: "Author",
+    description: "Author details: name, email, and URL.",
+});
+/** Convert schema-decoded author shape into runtime/domain Author. */
+export const toAuthor = (author) => ({
+    name: author.name,
+    email: Option.fromUndefinedOr(author.email),
+    url: Option.fromUndefinedOr(author.url),
+});
+export const extensionTypes = [
+    "skill",
+    "command",
+    "mcp-server",
+    "subagent",
+    "file",
+    "rule",
+    "pack",
+];
+const extensionTypeSet = new Set(extensionTypes);
+export const isExtensionType = (value) => value !== undefined && extensionTypeSet.has(value);
+export const extensionTypePluralSegments = [
+    "skills",
+    "commands",
+    "mcp-servers",
+    "subagents",
+    "files",
+    "rules",
+    "packs",
+];
+const extensionTypePluralSet = new Set(extensionTypePluralSegments);
+export const isExtensionTypePlural = (value) => value !== undefined && extensionTypePluralSet.has(value);
+export const extensionTypeFromPlural = {
+    skills: "skill",
+    commands: "command",
+    "mcp-servers": "mcp-server",
+    subagents: "subagent",
+    files: "file",
+    rules: "rule",
+    packs: "pack",
+};
+export const extensionTypeToPlural = {
+    skill: "skills",
+    command: "commands",
+    "mcp-server": "mcp-servers",
+    subagent: "subagents",
+    file: "files",
+    rule: "rules",
+    pack: "packs",
+};
+export const toExtensionType = (segment) => extensionTypeFromPlural[segment];
+export const toExtensionTypePlural = (type) => extensionTypeToPlural[type];
+export const extensionTypeLabels = {
+    skill: "Skill",
+    command: "Command",
+    "mcp-server": "MCP Server",
+    subagent: "Subagent",
+    file: "File",
+    rule: "Rule",
+    pack: "Extension Pack",
+};
+export const extensionTypePluralLabels = {
+    skills: "Skills",
+    commands: "Commands",
+    "mcp-servers": "MCP Servers",
+    subagents: "Subagents",
+    files: "Files",
+    rules: "Rules",
+    packs: "Extension Packs",
+};
+export const extensionTypeSentenceLabels = {
+    skill: "skill",
+    command: "command",
+    "mcp-server": "MCP server",
+    subagent: "subagent",
+    file: "file",
+    rule: "rule",
+    pack: "extension pack",
+};
+export const extensionTypePluralSentenceLabels = {
+    skills: "skills",
+    commands: "commands",
+    "mcp-servers": "MCP servers",
+    subagents: "subagents",
+    files: "files",
+    rules: "rules",
+    packs: "extension packs",
+};
+const EXTENSION_TYPE_PLURAL_PATTERN_SOURCE = extensionTypePluralSegments.join("|");
+const EXTENSION_NAME_MAX_LENGTH = 64;
+const EXTENSION_NAME_PATTERN_SOURCE = "[a-z0-9](?:[a-z0-9-]{0,62}[a-z0-9])?";
+const EXTENSION_NAME_BRAND = "ExtensionName";
+const invalidExtensionName = (value) => `Expected extension name to be max ${EXTENSION_NAME_MAX_LENGTH} characters, use lowercase letters, numbers, and hyphens only, and not start or end with a hyphen, got: ${value}`;
+const makeExtensionNameSchema = () => Schema.String.pipe(Schema.check(Schema.makeFilter((value) => EXTENSION_NAME_PATTERN.test(value) ? undefined : invalidExtensionName(value))), Schema.annotate({
+    identifier: "ExtensionName",
+    title: "Extension Name",
+    description: "The name of an extension — lowercase letters, numbers, and hyphens (e.g. my-skill).",
+    examples: ["my-skill", "code-review", "prettier"],
+    message: "Expected a valid extension name (lowercase letters, numbers, and hyphens, e.g., my-skill)",
+}), Schema.brand(EXTENSION_NAME_BRAND));
+/**
+ * Fully qualified name regex: `@<handle>/<type>/<name>` where handle and name
+ * use the canonical handle, plural extension type, and extension name grammar.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const FQN_PATTERN = new RegExp(`^(${HANDLE_PATTERN_SOURCE})\\/(${EXTENSION_TYPE_PLURAL_PATTERN_SOURCE})\\/(${EXTENSION_NAME_PATTERN_SOURCE})$`);
+/**
+ * Canonical extension short name regex.
+ */
+export const EXTENSION_NAME_PATTERN = new RegExp(`^${EXTENSION_NAME_PATTERN_SOURCE}$`);
+/**
+ * Canonical extension short name schema shared by generic extension surfaces.
+ */
+export const ExtensionNameSchema = makeExtensionNameSchema();
+export const decodeExtensionNameSync = Schema.decodeUnknownSync(ExtensionNameSchema);
+/**
+ * Extension type enumeration.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ExtensionTypeSchema = Schema.Literals(extensionTypes).annotate({
+    identifier: "ExtensionType",
+    title: "Extension Type",
+    description: "What kind of extension this is: skill, command, mcp-server, subagent, file, rule, or pack.",
+});
+/**
+ * Plural extension-type segment enumeration used by route/FQN surfaces.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ExtensionTypePluralSchema = Schema.Literals(extensionTypePluralSegments).annotate({
+    identifier: "ExtensionTypePlural",
+    title: "Extension Type (Plural)",
+    description: "Plural form of the extension type used in URLs and identifiers (e.g. skills, commands, packs).",
+});
+/**
+ * Structured FQN parts schema composed from the canonical handle, type, and name schemas.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const FullyQualifiedNamePartsSchema = Schema.Struct({
+    owner: HandleSchema,
+    type: ExtensionTypeSchema,
+    name: ExtensionNameSchema,
+}).annotate({
+    identifier: "FullyQualifiedNameParts",
+    title: "Fully Qualified Name Parts",
+    description: "The parts of a full extension identifier like @my-org/skills/code-review.",
+});
+const decodeFullyQualifiedNameParts = Schema.decodeUnknownResult(FullyQualifiedNamePartsSchema);
+/**
+ * Parse a fully qualified name string into validated structured parts.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const parseFullyQualifiedNameParts = (input) => {
+    const parts = input.split("/");
+    if (parts.length !== 3) {
+        return undefined;
+    }
+    const [owner, typeSegment, name] = parts;
+    if (owner === undefined || typeSegment === undefined || name === undefined) {
+        return undefined;
+    }
+    if (!isExtensionTypePlural(typeSegment)) {
+        return undefined;
+    }
+    const type = toExtensionType(typeSegment);
+    const result = decodeFullyQualifiedNameParts({ owner, type, name });
+    return Result.isSuccess(result) ? result.success : undefined;
+};
+/**
+ * Parse a fully qualified ref string (with optional version constraint) into parts.
+ * Strips the version constraint suffix and returns the validated FQN parts.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const parseFullyQualifiedRefParts = (input) => {
+    const lastSlash = input.lastIndexOf("/");
+    const constraintAt = lastSlash > 0 ? input.indexOf("@", lastSlash + 1) : -1;
+    const fqnPart = constraintAt > 0 ? input.slice(0, constraintAt) : input;
+    return parseFullyQualifiedNameParts(fqnPart);
+};
+/**
+ * Fully qualified name string schema validated through the composed parts schema.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const FullyQualifiedNameSchema = Schema.String.pipe(Schema.check(Schema.makeFilter((value) => {
+    return parseFullyQualifiedNameParts(value) === undefined
+        ? `Expected fully qualified name in @handle/(skills|commands|mcp-servers|subagents|files|rules|packs)/name form, got: ${value}`
+        : undefined;
+})));
+/**
+ * Fully qualified extension reference with optional version constraint.
+ *
+ * Accepts `@owner/type/name` or `@owner/type/name@constraint` where
+ * the FQN portion validates through FullyQualifiedNameSchema and the
+ * optional constraint validates as a semver VersionConstraint.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const FullyQualifiedRefSchema = Schema.String.pipe(Schema.check(Schema.makeFilter((value) => {
+    // Find the constraint separator: the @ after the last slash
+    const lastSlash = value.lastIndexOf("/");
+    const constraintAt = lastSlash > 0 ? value.indexOf("@", lastSlash + 1) : -1;
+    const fqnPart = constraintAt > 0 ? value.slice(0, constraintAt) : value;
+    const constraintPart = constraintAt > 0 ? value.slice(constraintAt + 1) : undefined;
+    // Validate FQN portion
+    if (parseFullyQualifiedNameParts(fqnPart) === undefined) {
+        return `Expected fully qualified ref in @handle/type/name[@constraint] form, got: ${value}`;
+    }
+    // Validate constraint portion if present
+    if (constraintPart !== undefined) {
+        const constraintResult = Schema.decodeUnknownResult(VersionConstraintSchema)(constraintPart);
+        if (Result.isFailure(constraintResult)) {
+            return `Expected valid version constraint after @, got: ${constraintPart}`;
+        }
+    }
+    return undefined;
+})), Schema.annotate({
+    identifier: "FullyQualifiedRef",
+    title: "Fully Qualified Extension Reference",
+    description: "An extension reference like @owner/skills/name or @owner/skills/name@^1.0.0.",
+    examples: ["@acme/skills/code-review", "@acme/skills/code-review@^1.0.0"],
+}), Schema.brand("FullyQualifiedRef"));
+/**
+ * Map of fully-qualified extension names to semver constraints.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const ExtensionDependencyConstraintMapSchema = Schema.Record(FullyQualifiedNameSchema, VersionConstraintSchema);
+/**
+ * Common base fields shared across manifest types.
+ * Type-specific manifests provide their own `type` and `name` fields explicitly.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const CommonManifestBaseFields = {
+    owner: HandleSchema.pipe(Schema.annotateKey({ messageMissingKey: "owner is required" })),
+    version: ExactSemverVersionSchema.pipe(Schema.annotateKey({ messageMissingKey: "version is required" })),
+    description: Schema.optional(Schema.String),
+    keywords: Schema.optional(Schema.Array(Schema.String)),
+    repository: Schema.optional(Schema.String),
+    homepage: Schema.optional(Schema.String),
+    license: Schema.optional(Schema.String),
+    bugs: Schema.optional(Schema.String),
+    authors: Schema.optional(Schema.Array(AuthorSchema)),
+    compatiblePackages: Schema.optional(Schema.Array(PackageUrlSchema)),
+};
+/**
+ * Agent identifier enumeration for supported coding agents.
+ *
+ * Derived from `AGENT_IDS` in agents/types.ts — compile-time enforced,
+ * no manual sync required.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const AgentIdSchema = Schema.Literals([...AGENT_IDS]);
+//# sourceMappingURL=common.js.map

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

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

package/dist/src/unstable/extensions/conflict-detection.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Conflict detection for extension-rendered files.
+ *
+ * Determines whether a file is absent, owned by axm (has a managed marker),
+ * or in conflict (exists without a managed marker). Returns data only —
+ * no policy decisions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import { type AppError } from "../app-error/index.js";
+/**
+ * Tagged union representing the result of conflict detection.
+ *
+ * - `Absent`: file does not exist
+ * - `Owned`: file exists with a managed marker (safe to re-render)
+ * - `Conflict`: file exists without a managed marker (user-owned)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export type ConflictDetectionResult = {
+    readonly _tag: "Absent";
+} | {
+    readonly _tag: "Owned";
+} | {
+    readonly _tag: "Conflict";
+};
+/**
+ * Detect whether a file path is absent, owned by axm, or in conflict.
+ *
+ * When `fileContent` is provided, it is used directly instead of reading
+ * from disk. This is useful when the content is already available.
+ *
+ * Returns data only — callers decide what policy to apply.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const detectConflict: (filePath: string, fileContent?: string) => Effect.Effect<ConflictDetectionResult, AppError, FileSystem.FileSystem>;
+//# sourceMappingURL=conflict-detection.d.ts.map

package/dist/src/unstable/extensions/conflict-detection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-detection.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/conflict-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGpE;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;CAAE,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAYlC;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,GACzB,UAAU,MAAM,EAChB,cAAc,MAAM,KACnB,MAAM,CAAC,MAAM,CAAC,uBAAuB,EAAE,QAAQ,EAAE,UAAU,CAAC,UAAU,CAyBxE,CAAC"}

package/dist/src/unstable/extensions/conflict-detection.js

@@ -0,0 +1,49 @@
+/**
+ * Conflict detection for extension-rendered files.
+ *
+ * Determines whether a file is absent, owned by axm (has a managed marker),
+ * or in conflict (exists without a managed marker). Returns data only —
+ * no policy decisions.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import { makeAppError } from "../app-error/index.js";
+import { isManagedByAxm } from "./managed-marker.js";
+const Absent = { _tag: "Absent" };
+const Owned = { _tag: "Owned" };
+const Conflict = { _tag: "Conflict" };
+const classifyContent = (content) => isManagedByAxm(content) ? Owned : Conflict;
+const isNotFound = (error) => error.reason._tag === "NotFound";
+/**
+ * Detect whether a file path is absent, owned by axm, or in conflict.
+ *
+ * When `fileContent` is provided, it is used directly instead of reading
+ * from disk. This is useful when the content is already available.
+ *
+ * Returns data only — callers decide what policy to apply.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const detectConflict = (filePath, fileContent) => {
+    if (fileContent !== undefined) {
+        return Effect.succeed(classifyContent(fileContent));
+    }
+    return Effect.gen(function* () {
+        const fs = yield* FileSystem.FileSystem;
+        return yield* fs.readFileString(filePath).pipe(Effect.map(classifyContent), Effect.catch((error) => {
+            if (isNotFound(error)) {
+                return Effect.succeed(Absent);
+            }
+            return Effect.fail(makeAppError({
+                code: "FILE_READ_ERROR",
+                what: `Failed to read file: ${filePath}`,
+                details: [String(error)],
+                howToFix: "Check file permissions and ensure the path is accessible.",
+                cause: error,
+            }));
+        }));
+    });
+};
+//# sourceMappingURL=conflict-detection.js.map

package/dist/src/unstable/extensions/conflict-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-detection.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/conflict-detection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgBrD,MAAM,MAAM,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAC3D,MAAM,KAAK,GAA4B,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACzD,MAAM,QAAQ,GAA4B,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAE/D,MAAM,eAAe,GAAG,CAAC,OAAe,EAA2B,EAAE,CACnE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAE7C,MAAM,UAAU,GAAG,CAAC,KAAkC,EAAW,EAAE,CACjE,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AAEnC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,QAAgB,EAChB,WAAoB,EACqD,EAAE;IAC3E,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACzB,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;QACxC,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,IAAI,CAC5C,MAAM,CAAC,GAAG,CAAC,eAAe,CAAC,EAC3B,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACrB,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;YACD,OAAO,MAAM,CAAC,IAAI,CAChB,YAAY,CAAC;gBACX,IAAI,EAAE,iBAAiB;gBACvB,IAAI,EAAE,wBAAwB,QAAQ,EAAE;gBACxC,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxB,QAAQ,EAAE,2DAA2D;gBACrE,KAAK,EAAE,KAAK;aACb,CAAC,CACH,CAAC;QACJ,CAAC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Shared constants for extension operations.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const REGISTRY_EXTENSIONS_DIR = ".axm/extensions";
+export declare const EXTERNAL_EXTENSIONS_DIR = ".axm/extensions/external";
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,uBAAuB,oBAAoB,CAAC;AACzD,eAAO,MAAM,uBAAuB,6BAA6B,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Shared constants for extension operations.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const REGISTRY_EXTENSIONS_DIR = ".axm/extensions";
+export const EXTERNAL_EXTENSIONS_DIR = ".axm/extensions/external";
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,iBAAiB,CAAC;AACzD,MAAM,CAAC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * Fully qualified name (FQN) parsing and formatting for 3-segment extension names.
+ *
+ * FQN format: `@owner/type-plural/name` (e.g., `@acme/skills/code-review`)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { type FullyQualifiedNameParts } from "./common.js";
+/**
+ * Parse a 3-segment FQN string into its parts.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const parseFqn: (input: string) => Effect.Effect<{
+    readonly name: string & import("effect/Brand").Brand<"ExtensionName">;
+    readonly type: "skill" | "command" | "mcp-server" | "subagent" | "file" | "rule" | "pack";
+    readonly owner: string & import("effect/Brand").Brand<"Handle">;
+}, import("../app-error/app-error.ts").AppError, never>;
+/**
+ * Parse a 3-segment FQN string into its parts. Throws on invalid input.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const parseFqnOrThrow: (input: string) => FullyQualifiedNameParts;
+/**
+ * Format a parsed FQN back into a string.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const formatFqn: (fqn: FullyQualifiedNameParts) => string;
+//# sourceMappingURL=fqn.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fqn.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/fqn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM;;;;uDAalC,CAAC;AAEL;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,uBAQ/C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,KAAK,uBAAuB,KAAG,MACM,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * Fully qualified name (FQN) parsing and formatting for 3-segment extension names.
+ *
+ * FQN format: `@owner/type-plural/name` (e.g., `@acme/skills/code-review`)
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { makeAppError } from "../app-error/index.js";
+import { parseFullyQualifiedNameParts, toExtensionTypePlural, } from "./common.js";
+/**
+ * Parse a 3-segment FQN string into its parts.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const parseFqn = (input) => Effect.gen(function* () {
+    const parsed = parseFullyQualifiedNameParts(input);
+    if (parsed === undefined) {
+        return yield* makeAppError({
+            code: "INVALID_FQN",
+            what: `Invalid fully qualified name: ${input}`,
+            details: ["Expected format: @handle/type/name (e.g., @acme/skills/code-review)"],
+            howToFix: "Use the 3-segment format: @handle/(skills|commands|mcp-servers|subagents|files|rules|packs)/name",
+        });
+    }
+    return parsed;
+});
+/**
+ * Parse a 3-segment FQN string into its parts. Throws on invalid input.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const parseFqnOrThrow = (input) => {
+    const parsed = parseFullyQualifiedNameParts(input);
+    if (parsed === undefined) {
+        throw new Error(`Invalid fully qualified name: ${input}. Expected format: @handle/(skills|commands|mcp-servers|subagents|files|rules|packs)/name`);
+    }
+    return parsed;
+};
+/**
+ * Format a parsed FQN back into a string.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const formatFqn = (fqn) => `${fqn.owner}/${toExtensionTypePlural(fqn.type)}/${fqn.name}`;
+//# sourceMappingURL=fqn.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fqn.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/fqn.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACL,4BAA4B,EAC5B,qBAAqB,GAEtB,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE,CACxC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,CAAC,YAAY,CAAC;YACzB,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,iCAAiC,KAAK,EAAE;YAC9C,OAAO,EAAE,CAAC,qEAAqE,CAAC;YAChF,QAAQ,EACN,kGAAkG;SACrG,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC,CAAC;AAEL;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,KAAa,EAA2B,EAAE;IACxE,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,iCAAiC,KAAK,2FAA2F,CAClI,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,GAA4B,EAAU,EAAE,CAChE,GAAG,GAAG,CAAC,KAAK,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Generic YAML frontmatter parser.
+ *
+ * Parses content that may begin with a YAML frontmatter block delimited
+ * by `---`. Returns the parsed frontmatter as `unknown` so each consumer
+ * can apply its own Schema validation.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import { type AppError } from "../app-error/index.js";
+/**
+ * Result of parsing frontmatter from content.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export interface FrontmatterResult {
+    /** Parsed YAML frontmatter, or undefined if no frontmatter block was found. */
+    readonly frontmatter: unknown;
+    /** Content body after the frontmatter block, or full content if no frontmatter. */
+    readonly body: string;
+}
+/**
+ * Parse frontmatter from content synchronously.
+ *
+ * Throws on malformed YAML. Use `parseFrontmatterEffect` for full error channel.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const parseFrontmatterSync: (content: string) => FrontmatterResult;
+/**
+ * Parse frontmatter from content as an Effect.
+ *
+ * Returns `AppError` in the error channel for malformed YAML.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export declare const parseFrontmatterEffect: (content: string) => Effect.Effect<FrontmatterResult, AppError>;
+//# sourceMappingURL=frontmatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../../../src/unstable/extensions/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAkCD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,GAAI,SAAS,MAAM,KAAG,iBAWtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,GACjC,SAAS,MAAM,KACd,MAAM,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAWxC,CAAC"}

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

@@ -0,0 +1,71 @@
+/**
+ * Generic YAML frontmatter parser.
+ *
+ * Parses content that may begin with a YAML frontmatter block delimited
+ * by `---`. Returns the parsed frontmatter as `unknown` so each consumer
+ * can apply its own Schema validation.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+import * as Effect from "effect/Effect";
+import YAML from "yaml";
+import { makeAppError } from "../app-error/index.js";
+const FRONTMATTER_DELIMITER = "---";
+/**
+ * Find the frontmatter boundaries in content.
+ * Returns [endOfOpening, startOfClosing] indices, or undefined if no frontmatter.
+ */
+const findFrontmatterBoundaries = (content) => {
+    if (!content.startsWith(FRONTMATTER_DELIMITER)) {
+        return undefined;
+    }
+    const afterOpening = content.indexOf("\n");
+    if (afterOpening === -1) {
+        return undefined;
+    }
+    const closingIndex = content.indexOf(`\n${FRONTMATTER_DELIMITER}`, afterOpening);
+    if (closingIndex === -1) {
+        return undefined;
+    }
+    const closingEnd = closingIndex + 1 + FRONTMATTER_DELIMITER.length;
+    const bodyStart = content[closingEnd] === "\n" ? closingEnd + 1 : closingEnd;
+    return {
+        yamlStart: afterOpening + 1,
+        bodyStart,
+    };
+};
+/**
+ * Parse frontmatter from content synchronously.
+ *
+ * Throws on malformed YAML. Use `parseFrontmatterEffect` for full error channel.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const parseFrontmatterSync = (content) => {
+    const boundaries = findFrontmatterBoundaries(content);
+    if (boundaries === undefined) {
+        return { frontmatter: undefined, body: content };
+    }
+    const yamlContent = content.slice(boundaries.yamlStart, boundaries.bodyStart).split("---")[0];
+    const frontmatter = YAML.parse(yamlContent ?? "");
+    const body = content.slice(boundaries.bodyStart);
+    return { frontmatter: frontmatter ?? undefined, body };
+};
+/**
+ * Parse frontmatter from content as an Effect.
+ *
+ * Returns `AppError` in the error channel for malformed YAML.
+ *
+ * @experimental This API is unstable and may change without notice.
+ */
+export const parseFrontmatterEffect = (content) => Effect.try({
+    try: () => parseFrontmatterSync(content),
+    catch: (error) => makeAppError({
+        code: "FRONTMATTER_PARSE_ERROR",
+        what: "Failed to parse YAML frontmatter",
+        details: [error instanceof Error ? error.message : String(error)],
+        howToFix: "Ensure the frontmatter block contains valid YAML between --- delimiters.",
+        cause: error,
+    }),
+});
+//# sourceMappingURL=frontmatter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../../../src/unstable/extensions/frontmatter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,YAAY,EAAiB,MAAM,uBAAuB,CAAC;AAcpE,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC;;;GAGG;AACH,MAAM,yBAAyB,GAAG,CAChC,OAAe,EACuC,EAAE;IACxD,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,EAAE,CAAC;QAC/C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,qBAAqB,EAAE,EAAE,YAAY,CAAC,CAAC;IACjF,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,UAAU,GAAG,YAAY,GAAG,CAAC,GAAG,qBAAqB,CAAC,MAAM,CAAC;IACnE,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IAE7E,OAAO;QACL,SAAS,EAAE,YAAY,GAAG,CAAC;QAC3B,SAAS;KACV,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAqB,EAAE;IACzE,MAAM,UAAU,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACnD,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9F,MAAM,WAAW,GAAY,IAAI,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAEjD,OAAO,EAAE,WAAW,EAAE,WAAW,IAAI,SAAS,EAAE,IAAI,EAAE,CAAC;AACzD,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,OAAe,EAC6B,EAAE,CAC9C,MAAM,CAAC,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,EAAE,CAAC,oBAAoB,CAAC,OAAO,CAAC;IACxC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CACf,YAAY,CAAC;QACX,IAAI,EAAE,yBAAyB;QAC/B,IAAI,EAAE,kCAAkC;QACxC,OAAO,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjE,QAAQ,EAAE,0EAA0E;QACpF,KAAK,EAAE,KAAK;KACb,CAAC;CACL,CAAC,CAAC"}

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

@@ -0,0 +1,16 @@
+import * as Schema from "effect/Schema";
+export declare const SLUG_PATTERN_SOURCE = "[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?";
+export declare const HANDLE_PATTERN_SOURCE = "@[a-z0-9_](?:[a-z0-9_-]*[a-z0-9_])?";
+export declare const SLUG_PATTERN: RegExp;
+export declare const HANDLE_PATTERN: RegExp;
+export declare const SlugSchema: Schema.brand<Schema.String, "Slug">;
+export type Slug = Schema.Schema.Type<typeof SlugSchema>;
+export declare const HandleSchema: Schema.brand<Schema.String, "Handle">;
+export type Handle = Schema.Schema.Type<typeof HandleSchema>;
+export declare const decodeHandleSync: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Handle">;
+export declare const decodeSlugSync: (input: unknown, options?: import("effect/SchemaAST").ParseOptions) => string & import("effect/Brand").Brand<"Slug">;
+export declare const handleFromSlug: (slug: Slug) => Handle;
+export declare const slugFromHandle: (handle: Handle) => Slug;
+export declare const normalizeSlug: (slug: string) => Slug;
+export declare const normalizeHandle: (handle: string) => Handle;
+//# sourceMappingURL=handle.d.ts.map