@agentxm/registry-protocol 0.28.12 → 0.28.13

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

package/dist/src/unstable/knowledge/knowledge-search.js

@@ -1,147 +0,0 @@
-export const KNOWLEDGE_SEARCH_TOKENIZER_PROFILE = {
-    id: "axm-knowledge-lexical-v1",
-    unicodeNormalization: "NFKC",
-    caseNormalization: "unicode-case-fold",
-    termBoundary: "unicode-whitespace-punctuation-camel-code",
-    stemming: false,
-};
-const normalizeTokenSource = (value) => value
-    .normalize("NFKC")
-    .replace(/([\p{Ll}\p{N}])(\p{Lu})/gu, "$1 $2")
-    .replace(/(\p{Lu})(\p{Lu}\p{Ll})/gu, "$1 $2")
-    .replace(/(\p{L})(\p{N})/gu, "$1 $2")
-    .replace(/(\p{N})(\p{L})/gu, "$1 $2")
-    // ECMAScript does not expose Unicode's CaseFolding.txt operation directly.
-    // Upper-then-lower handles multi-character folds such as ß -> ss while
-    // remaining deterministic and locale-independent.
-    .toUpperCase()
-    .toLowerCase();
-export const tokenizeKnowledgeSearchText = (value) => normalizeTokenSource(value).match(/[\p{L}\p{M}\p{N}]+/gu) ?? [];
-const normalizeLiteral = (value) => value.normalize("NFC").toLowerCase();
-const parseQuotedValue = (input, quoteIndex) => {
-    let value = "";
-    let escaped = false;
-    for (let index = quoteIndex + 1; index < input.length; index += 1) {
-        const character = input[index];
-        if (character === undefined)
-            break;
-        if (escaped) {
-            value += character;
-            escaped = false;
-            continue;
-        }
-        if (character === "\\") {
-            escaped = true;
-            continue;
-        }
-        if (character === '"') {
-            return { ok: true, value, nextIndex: index + 1 };
-        }
-        value += character;
-    }
-    return { ok: false };
-};
-const addOrdinaryTerms = (clauses, value) => {
-    for (const token of tokenizeKnowledgeSearchText(value)) {
-        clauses.push({ kind: "term", token });
-    }
-};
-const startsWithLiteralOperator = (input, index) => input.slice(index, index + "literal:".length).toLowerCase() === "literal:";
-export const parseKnowledgeSearchQuery = (input) => {
-    const clauses = [];
-    let index = 0;
-    while (index < input.length) {
-        if (/\s/u.test(input[index] ?? "")) {
-            index += 1;
-            continue;
-        }
-        if (startsWithLiteralOperator(input, index)) {
-            index += "literal:".length;
-            if (input[index] === '"') {
-                const quoted = parseQuotedValue(input, index);
-                if (!quoted.ok) {
-                    return { ok: false, detail: "Explicit literals must end with a closing quote." };
-                }
-                if (quoted.value.trim().length === 0) {
-                    return { ok: false, detail: "Explicit literals cannot be empty." };
-                }
-                clauses.push({ kind: "literal", value: normalizeLiteral(quoted.value) });
-                index = quoted.nextIndex;
-                continue;
-            }
-            const end = input.slice(index).search(/\s/u);
-            const nextIndex = end === -1 ? input.length : index + end;
-            const value = input.slice(index, nextIndex);
-            if (value.length === 0) {
-                return { ok: false, detail: "Explicit literals cannot be empty." };
-            }
-            clauses.push({ kind: "literal", value: normalizeLiteral(value) });
-            index = nextIndex;
-            continue;
-        }
-        if (input[index] === '"') {
-            const quoted = parseQuotedValue(input, index);
-            if (!quoted.ok) {
-                return { ok: false, detail: "Quoted phrases must end with a closing quote." };
-            }
-            if (quoted.value.length === 0) {
-                return { ok: false, detail: "Quoted phrases cannot be empty." };
-            }
-            const tokens = tokenizeKnowledgeSearchText(quoted.value);
-            if (tokens.length === 0) {
-                return {
-                    ok: false,
-                    detail: "Quoted phrases must contain at least one searchable token.",
-                };
-            }
-            clauses.push({ kind: "phrase", tokens });
-            index = quoted.nextIndex;
-            continue;
-        }
-        let end = index;
-        while (end < input.length && !/\s/u.test(input[end] ?? "") && input[end] !== '"') {
-            end += 1;
-        }
-        addOrdinaryTerms(clauses, input.slice(index, end));
-        index = end;
-    }
-    return clauses.length === 0
-        ? { ok: false, detail: "Search query must contain at least one term, phrase, or literal." }
-        : { ok: true, query: { clauses } };
-};
-const containsPhrase = (fieldTokens, phraseTokens) => {
-    if (phraseTokens.length > fieldTokens.length)
-        return false;
-    const finalStart = fieldTokens.length - phraseTokens.length;
-    for (let start = 0; start <= finalStart; start += 1) {
-        if (phraseTokens.every((token, offset) => fieldTokens[start + offset] === token))
-            return true;
-    }
-    return false;
-};
-const searchableFields = (concept) => [
-    concept.id,
-    concept.title,
-    ...(concept.description === undefined ? [] : [concept.description]),
-    ...(concept.tags ?? []),
-    ...(concept.type === undefined ? [] : [concept.type]),
-    concept.body,
-];
-export const matchesKnowledgeSearchQuery = (concept, query) => {
-    const fields = searchableFields(concept);
-    const tokenFields = fields.map(tokenizeKnowledgeSearchText);
-    const literalFields = fields.map(normalizeLiteral);
-    return query.clauses.every((clause) => {
-        switch (clause.kind) {
-            case "term":
-                return tokenFields.some((tokens) => tokens.includes(clause.token));
-            case "phrase":
-                return tokenFields.some((tokens) => containsPhrase(tokens, clause.tokens));
-            case "literal":
-                return literalFields.some((field) => field.includes(clause.value));
-            default:
-                return clause;
-        }
-    });
-};
-//# sourceMappingURL=knowledge-search.js.map