@agentxm/registry-protocol 0.28.11 → 0.28.13

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

@@ -1,52 +0,0 @@
-/**
- * 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";
-/**
- * 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;
-}
-declare const FrontmatterParseFailure_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
-    readonly _tag: "FrontmatterParseFailure";
-} & Readonly<A>;
-/** Bounded, document-relative failure from parsing a YAML frontmatter block. */
-export declare class FrontmatterParseFailure extends FrontmatterParseFailure_base<{
-    readonly reason: string;
-    readonly line?: number;
-    readonly column?: number;
-}> {
-}
-export declare const FRONTMATTER_PARSE_FALLBACK_REASON = "YAML frontmatter could not be parsed";
-/** Normalize a foreign YAML failure without retaining its raw cause or parser code. */
-export declare const normalizeFrontmatterParseFailure: (error: unknown, documentLineOffset: number) => FrontmatterParseFailure;
-/**
- * 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 `FrontmatterParseFailure` 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, FrontmatterParseFailure>;
-export {};
-//# sourceMappingURL=frontmatter.d.ts.map

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

@@ -1,115 +0,0 @@
-/**
- * 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 Data from "effect/Data";
-import * as Effect from "effect/Effect";
-import YAML, { YAMLParseError } from "yaml";
-/** Bounded, document-relative failure from parsing a YAML frontmatter block. */
-export class FrontmatterParseFailure extends Data.TaggedError("FrontmatterParseFailure") {
-}
-const FRONTMATTER_DELIMITER = "---";
-export const FRONTMATTER_PARSE_FALLBACK_REASON = "YAML frontmatter could not be parsed";
-const FRONTMATTER_PARSE_REASON_MAX_CODE_POINTS = 256;
-const boundedReason = (reason) => {
-    const codePoints = Array.from(reason);
-    if (codePoints.length <= FRONTMATTER_PARSE_REASON_MAX_CODE_POINTS)
-        return reason;
-    return `${codePoints.slice(0, FRONTMATTER_PARSE_REASON_MAX_CODE_POINTS - 1).join("")}…`;
-};
-const parserReason = (error) => {
-    const firstLine = error.message.split(/\r?\n/, 1)[0]?.trim() ?? "";
-    const withoutLocation = firstLine
-        .replace(/\s+at line \d+, column \d+:?$/, "")
-        .replace(/^Missing closing ["']quote$/, "Missing closing quote")
-        .trim();
-    return boundedReason(withoutLocation || FRONTMATTER_PARSE_FALLBACK_REASON);
-};
-/** Normalize a foreign YAML failure without retaining its raw cause or parser code. */
-export const normalizeFrontmatterParseFailure = (error, documentLineOffset) => {
-    if (!(error instanceof YAMLParseError)) {
-        return new FrontmatterParseFailure({ reason: FRONTMATTER_PARSE_FALLBACK_REASON });
-    }
-    const position = error.linePos?.[0];
-    if (position === undefined || !Number.isSafeInteger(position.line) || position.line < 1) {
-        return new FrontmatterParseFailure({ reason: parserReason(error) });
-    }
-    const line = position.line + documentLineOffset;
-    const column = Number.isSafeInteger(position.col) && position.col > 0 ? position.col : undefined;
-    return new FrontmatterParseFailure({
-        reason: parserReason(error),
-        line,
-        ...(column === undefined ? {} : { column }),
-    });
-};
-/**
- * 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.startsWith("\r\n", closingEnd)
-        ? closingEnd + 2
-        : 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 = (() => {
-        try {
-            return YAML.parse(yamlContent ?? "");
-        }
-        catch (error) {
-            const documentLineOffset = content.slice(0, boundaries.yamlStart).split("\n").length - 1;
-            throw normalizeFrontmatterParseFailure(error, documentLineOffset);
-        }
-    })();
-    const body = content.slice(boundaries.bodyStart);
-    return { frontmatter: frontmatter ?? undefined, body };
-};
-/**
- * Parse frontmatter from content as an Effect.
- *
- * Returns `FrontmatterParseFailure` 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) => error instanceof FrontmatterParseFailure
-        ? error
-        : new FrontmatterParseFailure({ reason: FRONTMATTER_PARSE_FALLBACK_REASON }),
-});
-//# sourceMappingURL=frontmatter.js.map

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

@@ -1,11 +0,0 @@
-/**
- * Area barrel for the package public surface.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export { AGENT_SKILLS_COMPATIBILITY_MAX_LENGTH, AGENT_SKILLS_DESCRIPTION_MAX_LENGTH, AGENT_SKILLS_FRONTMATTER_FIELDS, AGENT_SKILLS_NAME_MAX_LENGTH, AGENT_SKILLS_REFERENCE_VALIDATOR_URL, AGENT_SKILLS_SPECIFICATION_URL, AGENT_SKILLS_STANDARD_REVISION, } from "./agent-skills-standard.js";
-export { FrontmatterParseFailure, type FrontmatterResult, parseFrontmatterEffect, parseFrontmatterSync, } from "./frontmatter.js";
-export { type SkillFrontmatter, SkillFrontmatterSchema, type SkillFrontmatterValidation, parseSkillMd, validateSkillFrontmatter, } from "./skill-content.js";
-export { type Skill } from "./skill-types.js";
-export { type SubagentAgentOverrides, type SubagentContentResult, parseSubagentMd, } from "./subagent-content.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1,11 +0,0 @@
-/**
- * Area barrel for the package public surface.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export { AGENT_SKILLS_COMPATIBILITY_MAX_LENGTH, AGENT_SKILLS_DESCRIPTION_MAX_LENGTH, AGENT_SKILLS_FRONTMATTER_FIELDS, AGENT_SKILLS_NAME_MAX_LENGTH, AGENT_SKILLS_REFERENCE_VALIDATOR_URL, AGENT_SKILLS_SPECIFICATION_URL, AGENT_SKILLS_STANDARD_REVISION, } from "./agent-skills-standard.js";
-export { FrontmatterParseFailure, parseFrontmatterEffect, parseFrontmatterSync, } from "./frontmatter.js";
-export { SkillFrontmatterSchema, parseSkillMd, validateSkillFrontmatter, } from "./skill-content.js";
-export {} from "./skill-types.js";
-export { parseSubagentMd, } from "./subagent-content.js";
-//# sourceMappingURL=index.js.map

package/dist/src/unstable/content/skill-content.d.ts

@@ -1,43 +0,0 @@
-/**
- * Skill content file module for SKILL.md parsing and frontmatter schemas.
- *
- * Defines the frontmatter schema for SKILL.md files and a parser that
- * combines the shared frontmatter utility with skill-specific validation.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Option from "effect/Option";
-import * as Schema from "effect/Schema";
-import type { Skill } from "./skill-types.js";
-/**
- * Schema for SKILL.md frontmatter fields.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export declare const SkillFrontmatterSchema: Schema.Struct<{
-    readonly name: Schema.String;
-    readonly description: Schema.String;
-    readonly license: Schema.optionalKey<Schema.String>;
-    readonly compatibility: Schema.optionalKey<Schema.String>;
-    readonly metadata: Schema.optionalKey<Schema.$Record<Schema.String, Schema.String>>;
-    readonly "allowed-tools": Schema.optionalKey<Schema.String>;
-}>;
-export type SkillFrontmatter = Schema.Schema.Type<typeof SkillFrontmatterSchema>;
-export type SkillFrontmatterValidation = {
-    readonly valid: true;
-    readonly frontmatter: SkillFrontmatter;
-} | {
-    readonly valid: false;
-    readonly errors: ReadonlyArray<string>;
-};
-/** Validate parsed YAML against the pinned Agent Skills metadata contract. */
-export declare const validateSkillFrontmatter: (input: unknown, expectedDirectoryName?: string) => SkillFrontmatterValidation;
-/**
- * Parse a SKILL.md file's content and extract skill metadata from frontmatter.
- *
- * Returns `Option.some(Skill)` when the file has valid YAML frontmatter with
- * non-empty `name` and `description` fields. Returns `Option.none()` for any
- * invalid input: missing frontmatter, invalid YAML, or missing/empty required fields.
- */
-export declare const parseSkillMd: (content: string, expectedDirectoryName?: string) => Option.Option<Skill>;
-//# sourceMappingURL=skill-content.d.ts.map

package/dist/src/unstable/content/skill-content.js

@@ -1,184 +0,0 @@
-/**
- * Skill content file module for SKILL.md parsing and frontmatter schemas.
- *
- * Defines the frontmatter schema for SKILL.md files and a parser that
- * combines the shared frontmatter utility with skill-specific validation.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Option from "effect/Option";
-import * as Schema from "effect/Schema";
-import { parseFrontmatterSync } from "./frontmatter.js";
-import { AGENT_SKILLS_COMPATIBILITY_MAX_LENGTH, AGENT_SKILLS_DESCRIPTION_MAX_LENGTH, AGENT_SKILLS_FRONTMATTER_FIELDS, AGENT_SKILLS_NAME_MAX_LENGTH, } from "./agent-skills-standard.js";
-const NonEmptyTrimmedStringSchema = Schema.String.pipe(Schema.check(Schema.makeFilter((input) => input.trim().length > 0 ? undefined : "Expected a non-empty string")));
-const BoundedNonEmptyStringSchema = (maximumLength) => NonEmptyTrimmedStringSchema.pipe(Schema.check(Schema.makeFilter((input) => [...input].length <= maximumLength
-    ? undefined
-    : `Expected at most ${maximumLength} characters`)));
-const SkillNameSchema = BoundedNonEmptyStringSchema(AGENT_SKILLS_NAME_MAX_LENGTH).pipe(Schema.check(Schema.makeFilter((input) => {
-    const normalized = input.trim().normalize("NFKC");
-    if (normalized !== normalized.toLowerCase())
-        return "Skill name must be lowercase";
-    if (normalized.startsWith("-") || normalized.endsWith("-")) {
-        return "Skill name cannot start or end with a hyphen";
-    }
-    if (normalized.includes("--"))
-        return "Skill name cannot contain consecutive hyphens";
-    return [...normalized].every((character) => /[\p{L}\p{N}-]/u.test(character))
-        ? undefined
-        : "Skill name may contain only Unicode letters, numbers, and hyphens";
-})));
-const AllowedToolsSchema = NonEmptyTrimmedStringSchema.pipe(Schema.check(Schema.makeFilter((input) => /^\S+(?: \S+)*$/u.test(input) ? undefined : "Allowed tools must be a space-delimited string")));
-/**
- * Schema for SKILL.md frontmatter fields.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export const SkillFrontmatterSchema = Schema.Struct({
-    name: SkillNameSchema.pipe(Schema.annotateKey({ messageMissingKey: "skill name is required in SKILL.md frontmatter" })),
-    description: BoundedNonEmptyStringSchema(AGENT_SKILLS_DESCRIPTION_MAX_LENGTH).pipe(Schema.annotateKey({
-        messageMissingKey: "skill description is required in SKILL.md frontmatter",
-    })),
-    license: Schema.optionalKey(Schema.String),
-    compatibility: Schema.optionalKey(BoundedNonEmptyStringSchema(AGENT_SKILLS_COMPATIBILITY_MAX_LENGTH)),
-    metadata: Schema.optionalKey(Schema.Record(Schema.String, Schema.String)),
-    "allowed-tools": Schema.optionalKey(AllowedToolsSchema),
-}).annotate({
-    identifier: "SkillFrontmatter",
-    title: "Skill Frontmatter",
-    description: "Agent Skills standard metadata at the top of a SKILL.md file.",
-});
-const isRecord = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
-const allowedFrontmatterFields = new Set(AGENT_SKILLS_FRONTMATTER_FIELDS);
-/** Validate parsed YAML against the pinned Agent Skills metadata contract. */
-export const validateSkillFrontmatter = (input, expectedDirectoryName) => {
-    if (!isRecord(input)) {
-        return { valid: false, errors: ["SKILL.md frontmatter must be a YAML mapping"] };
-    }
-    const errors = [];
-    const unexpected = Object.keys(input)
-        .filter((key) => !allowedFrontmatterFields.has(key))
-        .sort();
-    if (unexpected.length > 0) {
-        errors.push(`Unexpected frontmatter fields: ${unexpected.join(", ")}`);
-    }
-    const nameValue = input["name"];
-    let normalizedName;
-    if (typeof nameValue !== "string" || nameValue.trim().length === 0) {
-        errors.push("Field 'name' must be a non-empty string");
-    }
-    else {
-        normalizedName = nameValue.trim().normalize("NFKC");
-        if ([...normalizedName].length > AGENT_SKILLS_NAME_MAX_LENGTH) {
-            errors.push(`Skill name exceeds ${AGENT_SKILLS_NAME_MAX_LENGTH} character limit`);
-        }
-        if (normalizedName !== normalizedName.toLowerCase()) {
-            errors.push("Skill name must be lowercase");
-        }
-        if (normalizedName.startsWith("-") || normalizedName.endsWith("-")) {
-            errors.push("Skill name cannot start or end with a hyphen");
-        }
-        if (normalizedName.includes("--")) {
-            errors.push("Skill name cannot contain consecutive hyphens");
-        }
-        if (![...normalizedName].every((character) => /[\p{L}\p{N}-]/u.test(character))) {
-            errors.push("Skill name may contain only Unicode letters, numbers, and hyphens");
-        }
-        if (expectedDirectoryName !== undefined &&
-            expectedDirectoryName.normalize("NFKC") !== normalizedName) {
-            errors.push(`Directory name '${expectedDirectoryName}' must match skill name '${normalizedName}'`);
-        }
-    }
-    const descriptionValue = input["description"];
-    if (typeof descriptionValue !== "string" || descriptionValue.trim().length === 0) {
-        errors.push("Field 'description' must be a non-empty string");
-    }
-    else if ([...descriptionValue].length > AGENT_SKILLS_DESCRIPTION_MAX_LENGTH) {
-        errors.push(`Description exceeds ${AGENT_SKILLS_DESCRIPTION_MAX_LENGTH} character limit`);
-    }
-    const licenseValue = input["license"];
-    if (licenseValue !== undefined && typeof licenseValue !== "string") {
-        errors.push("Field 'license' must be a string");
-    }
-    const compatibilityValue = input["compatibility"];
-    if (compatibilityValue !== undefined) {
-        if (typeof compatibilityValue !== "string" || compatibilityValue.trim().length === 0) {
-            errors.push("Field 'compatibility' must be a non-empty string");
-        }
-        else if ([...compatibilityValue].length > AGENT_SKILLS_COMPATIBILITY_MAX_LENGTH) {
-            errors.push(`Compatibility exceeds ${AGENT_SKILLS_COMPATIBILITY_MAX_LENGTH} character limit`);
-        }
-    }
-    const metadataValue = input["metadata"];
-    const metadata = {};
-    if (metadataValue !== undefined) {
-        if (!isRecord(metadataValue)) {
-            errors.push("Field 'metadata' must be a mapping from strings to strings");
-        }
-        else {
-            for (const [key, value] of Object.entries(metadataValue)) {
-                if (typeof value !== "string") {
-                    errors.push(`Metadata value for '${key}' must be a string`);
-                }
-                else {
-                    metadata[key] = value;
-                }
-            }
-        }
-    }
-    const allowedToolsValue = input["allowed-tools"];
-    if (allowedToolsValue !== undefined) {
-        if (typeof allowedToolsValue !== "string" || !/^\S+(?: \S+)*$/u.test(allowedToolsValue)) {
-            errors.push("Field 'allowed-tools' must be a non-empty space-delimited string");
-        }
-    }
-    if (errors.length > 0 || normalizedName === undefined || typeof descriptionValue !== "string") {
-        return { valid: false, errors };
-    }
-    return {
-        valid: true,
-        frontmatter: {
-            name: normalizedName,
-            description: descriptionValue,
-            ...(licenseValue !== undefined && typeof licenseValue === "string"
-                ? { license: licenseValue }
-                : {}),
-            ...(compatibilityValue !== undefined && typeof compatibilityValue === "string"
-                ? { compatibility: compatibilityValue }
-                : {}),
-            ...(metadataValue !== undefined ? { metadata } : {}),
-            ...(allowedToolsValue !== undefined && typeof allowedToolsValue === "string"
-                ? { "allowed-tools": allowedToolsValue }
-                : {}),
-        },
-    };
-};
-/**
- * Parse a SKILL.md file's content and extract skill metadata from frontmatter.
- *
- * Returns `Option.some(Skill)` when the file has valid YAML frontmatter with
- * non-empty `name` and `description` fields. Returns `Option.none()` for any
- * invalid input: missing frontmatter, invalid YAML, or missing/empty required fields.
- */
-export const parseSkillMd = (content, expectedDirectoryName) => {
-    try {
-        const parsed = parseFrontmatterSync(content);
-        if (parsed.frontmatter === undefined) {
-            return Option.none();
-        }
-        const validation = validateSkillFrontmatter(parsed.frontmatter, expectedDirectoryName);
-        if (!validation.valid) {
-            return Option.none();
-        }
-        const frontmatter = validation.frontmatter;
-        return Option.some({
-            name: frontmatter.name,
-            description: frontmatter.description,
-            metadata: frontmatter.metadata === undefined ? Option.none() : Option.some(frontmatter.metadata),
-        });
-    }
-    catch {
-        // Invalid YAML or other parsing errors — silently skip
-        return Option.none();
-    }
-};
-//# sourceMappingURL=skill-content.js.map

package/dist/src/unstable/content/skill-types.d.ts

@@ -1,22 +0,0 @@
-/**
- * Core domain types for skills management.
- *
- * @experimental This API is unstable and may change without notice.
- * @packageDocumentation
- */
-import * as Option from "effect/Option";
-import * as Record from "effect/Record";
-/**
- * Represents a discovered skill.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export interface Skill {
-    /** Unique name of the skill */
-    readonly name: string;
-    /** Description of the skill */
-    readonly description: string;
-    /** Optional metadata from SKILL.md frontmatter */
-    readonly metadata: Option.Option<Record.ReadonlyRecord<string, string>>;
-}
-//# sourceMappingURL=skill-types.d.ts.map

package/dist/src/unstable/content/skill-types.js

@@ -1,9 +0,0 @@
-/**
- * Core domain types for skills management.
- *
- * @experimental This API is unstable and may change without notice.
- * @packageDocumentation
- */
-import * as Option from "effect/Option";
-import * as Record from "effect/Record";
-//# sourceMappingURL=skill-types.js.map

package/dist/src/unstable/content/subagent-content.d.ts

@@ -1,58 +0,0 @@
-/**
- * Subagent content file module for subagent content parsing.
- *
- * The content file's YAML frontmatter is largely free-form: only `name` is
- * required and validated. `agentOverrides`, when present, is recognized for
- * use in per-agent rendering. Any other frontmatter keys flow through
- * verbatim to the agent-native file produced by the renderer.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Effect from "effect/Effect";
-import * as Option from "effect/Option";
-declare const SubagentContentError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
-    readonly _tag: "SubagentContentError";
-} & Readonly<A>;
-/**
- * Typed failure produced while parsing a subagent content file. Application
- * layers translate this into their own error vocabulary.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export declare class SubagentContentError extends SubagentContentError_base<{
-    readonly reason: "frontmatter-parse" | "missing-frontmatter" | "invalid-frontmatter" | "name-mismatch";
-    readonly detail: string;
-    readonly suggestion?: string;
-    readonly cause?: unknown;
-}> {
-}
-/**
- * Map of agent-id → merge patch applied during per-agent rendering.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export type SubagentAgentOverrides = Readonly<Record<string, Readonly<Record<string, unknown>>>>;
-/**
- * Result of parsing a subagent content file.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export interface SubagentContentResult {
-    /** The full frontmatter map, opaque except for `name`. Empty when no frontmatter. */
-    readonly frontmatter: Option.Option<Readonly<Record<string, unknown>>>;
-    /** The `agentOverrides` map keyed by agent id, when present and structurally valid. */
-    readonly agentOverrides: Option.Option<SubagentAgentOverrides>;
-    /** Content body after the frontmatter block, or full content if no frontmatter. */
-    readonly body: string;
-}
-/**
- * Parse a subagent content file into validated frontmatter and body.
- *
- * Validates only that frontmatter is present and that its `name` matches
- * the expected name. All other keys are preserved verbatim.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export declare const parseSubagentMd: (content: string, expectedName: string) => Effect.Effect<SubagentContentResult, SubagentContentError>;
-export {};
-//# sourceMappingURL=subagent-content.d.ts.map

package/dist/src/unstable/content/subagent-content.js

@@ -1,101 +0,0 @@
-/**
- * Subagent content file module for subagent content parsing.
- *
- * The content file's YAML frontmatter is largely free-form: only `name` is
- * required and validated. `agentOverrides`, when present, is recognized for
- * use in per-agent rendering. Any other frontmatter keys flow through
- * verbatim to the agent-native file produced by the renderer.
- *
- * @experimental This API is unstable and may change without notice.
- */
-import * as Data from "effect/Data";
-import * as Effect from "effect/Effect";
-import * as Option from "effect/Option";
-import * as Schema from "effect/Schema";
-import { parseFrontmatterEffect } from "./frontmatter.js";
-/**
- * Typed failure produced while parsing a subagent content file. Application
- * layers translate this into their own error vocabulary.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export class SubagentContentError extends Data.TaggedError("SubagentContentError") {
-}
-/**
- * Schema for the only required frontmatter field — `name`.
- *
- * Used to validate that `name` is present and a string. The full frontmatter
- * map is preserved verbatim and surfaced as `frontmatter`.
- */
-const NameOnlySchema = Schema.Struct({
-    name: Schema.String,
-}).annotate({
-    identifier: "SubagentFrontmatterName",
-    description: "Required `name` field for subagent frontmatter.",
-});
-const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const extractAgentOverrides = (fm) => {
-    const raw = fm["agentOverrides"];
-    if (!isPlainObject(raw))
-        return Option.none();
-    const out = {};
-    for (const [agentId, patch] of Object.entries(raw)) {
-        if (isPlainObject(patch))
-            out[agentId] = patch;
-    }
-    return Option.some(out);
-};
-/**
- * Parse a subagent content file into validated frontmatter and body.
- *
- * Validates only that frontmatter is present and that its `name` matches
- * the expected name. All other keys are preserved verbatim.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export const parseSubagentMd = (content, expectedName) => Effect.gen(function* () {
-    const parsed = yield* parseFrontmatterEffect(content).pipe(Effect.mapError((cause) => new SubagentContentError({
-        reason: "frontmatter-parse",
-        detail: "YAML frontmatter could not be parsed",
-        suggestion: "Ensure the frontmatter block contains valid YAML between --- delimiters.",
-        cause,
-    })));
-    if (parsed.frontmatter === undefined) {
-        return yield* new SubagentContentError({
-            reason: "missing-frontmatter",
-            detail: `Missing subagent frontmatter for "${expectedName}"`,
-            suggestion: `Add YAML frontmatter with name: ${expectedName}.`,
-        });
-    }
-    yield* Effect.try({
-        try: () => Schema.decodeUnknownSync(NameOnlySchema)(parsed.frontmatter),
-        catch: (error) => new SubagentContentError({
-            reason: "invalid-frontmatter",
-            detail: "Invalid subagent frontmatter",
-            suggestion: "Frontmatter must include a string `name` field.",
-            cause: error,
-        }),
-    });
-    if (!isPlainObject(parsed.frontmatter)) {
-        return yield* new SubagentContentError({
-            reason: "invalid-frontmatter",
-            detail: "Subagent frontmatter must be a YAML mapping",
-            suggestion: `Add YAML frontmatter with name: ${expectedName}.`,
-        });
-    }
-    const fm = parsed.frontmatter;
-    const name = fm["name"];
-    if (name !== expectedName) {
-        return yield* new SubagentContentError({
-            reason: "name-mismatch",
-            detail: `Subagent frontmatter name "${String(name)}" does not match expected name "${expectedName}"`,
-            suggestion: `Set subagent.json name, frontmatter name, and filename to ${expectedName}.`,
-        });
-    }
-    return {
-        frontmatter: Option.some(fm),
-        agentOverrides: extractAgentOverrides(fm),
-        body: parsed.body,
-    };
-});
-//# sourceMappingURL=subagent-content.js.map

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

@@ -1,8 +0,0 @@
-/**
- * Area barrel for the package public surface.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export { KNOWLEDGE_SEARCH_TOKENIZER_PROFILE, type KnowledgeSearchClause, type KnowledgeSearchQuery, type KnowledgeSearchQueryParseResult, matchesKnowledgeSearchQuery, parseKnowledgeSearchQuery, tokenizeKnowledgeSearchText, } from "./knowledge-search.js";
-export { KNOWLEDGE_DIAGNOSTIC_CODES, type KnowledgeActorRecord, type KnowledgeAuthoredLink, type KnowledgeBundleEntry, type KnowledgeConcept, type KnowledgeDiagnostic, type KnowledgeDiagnosticCode, type KnowledgeDocumentKind, type KnowledgeFrontmatterParseDetails, type KnowledgeInspection, type KnowledgeTrustTier, collectKnowledgeBundleEntries, inspectKnowledgeBundle, inspectKnowledgeEntries, openKnowledgeConcept, searchKnowledgeConcepts, } from "./okf.js";
-//# sourceMappingURL=index.d.ts.map

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

@@ -1,8 +0,0 @@
-/**
- * Area barrel for the package public surface.
- *
- * @experimental This API is unstable and may change without notice.
- */
-export { KNOWLEDGE_SEARCH_TOKENIZER_PROFILE, matchesKnowledgeSearchQuery, parseKnowledgeSearchQuery, tokenizeKnowledgeSearchText, } from "./knowledge-search.js";
-export { KNOWLEDGE_DIAGNOSTIC_CODES, collectKnowledgeBundleEntries, inspectKnowledgeBundle, inspectKnowledgeEntries, openKnowledgeConcept, searchKnowledgeConcepts, } from "./okf.js";
-//# sourceMappingURL=index.js.map

package/dist/src/unstable/knowledge/knowledge-search.d.ts

@@ -1,32 +0,0 @@
-import type { KnowledgeConcept } from "./okf.js";
-export declare const KNOWLEDGE_SEARCH_TOKENIZER_PROFILE: {
-    readonly id: "axm-knowledge-lexical-v1";
-    readonly unicodeNormalization: "NFKC";
-    readonly caseNormalization: "unicode-case-fold";
-    readonly termBoundary: "unicode-whitespace-punctuation-camel-code";
-    readonly stemming: false;
-};
-export type KnowledgeSearchClause = {
-    readonly kind: "term";
-    readonly token: string;
-} | {
-    readonly kind: "phrase";
-    readonly tokens: ReadonlyArray<string>;
-} | {
-    readonly kind: "literal";
-    readonly value: string;
-};
-export interface KnowledgeSearchQuery {
-    readonly clauses: ReadonlyArray<KnowledgeSearchClause>;
-}
-export type KnowledgeSearchQueryParseResult = {
-    readonly ok: true;
-    readonly query: KnowledgeSearchQuery;
-} | {
-    readonly ok: false;
-    readonly detail: string;
-};
-export declare const tokenizeKnowledgeSearchText: (value: string) => ReadonlyArray<string>;
-export declare const parseKnowledgeSearchQuery: (input: string) => KnowledgeSearchQueryParseResult;
-export declare const matchesKnowledgeSearchQuery: (concept: KnowledgeConcept, query: KnowledgeSearchQuery) => boolean;
-//# sourceMappingURL=knowledge-search.d.ts.map