@anvia/core 0.1.1 → 0.1.2

package/dist/chunk-KSIY7KJA.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/skills/instructions.ts","../src/skills/tools.ts","../src/skills/load.ts","../src/skills/local.ts","../src/skills/types.ts"],"sourcesContent":["import type { Skill } from \"./types\";\n\nexport function skillInstructions(skills: Skill[]): string {\n  if (skills.length === 0) {\n    return \"\";\n  }\n\n  return [\n    \"You have access to Agent Skills.\",\n    \"Skills are compact capability packages. Use the skill tools to load full instructions, references, or scripts only when a skill is relevant.\",\n    \"\",\n    \"Available skills:\",\n    ...skills.map(formatSkill),\n    \"\",\n    \"Skill tools:\",\n    \"- get_skill_instructions: load full SKILL.md guidance for a skill.\",\n    \"- get_skill_reference: read a reference file from a skill.\",\n    \"- get_skill_script: read a script file from a skill.\",\n    \"- run_skill_script: execute a script from a skill with arguments.\",\n  ].join(\"\\n\");\n}\n\nfunction formatSkill(skill: Skill): string {\n  const lines = [`- ${skill.name}: ${skill.description}`];\n  if (skill.references.length > 0) {\n    lines.push(`  references: ${skill.references.join(\", \")}`);\n  }\n  if (skill.scripts.length > 0) {\n    lines.push(`  scripts: ${skill.scripts.join(\", \")}`);\n  }\n  return lines.join(\"\\n\");\n}\n","import { spawn } from \"node:child_process\";\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, relative, resolve } from \"node:path\";\nimport { z } from \"zod\";\nimport { type AnyTool, createTool } from \"../tool\";\nimport type { Skill } from \"./types\";\n\nconst DEFAULT_TIMEOUT_MS = 30_000;\nconst MAX_OUTPUT_CHARS = 20_000;\n\nexport function createSkillTools(skills: Skill[]): AnyTool[] {\n  const registry = new SkillRegistry(skills);\n\n  return [\n    createTool({\n      name: \"get_skill_instructions\",\n      description: \"Load the full SKILL.md instructions for an Agent Skill.\",\n      input: z.object({\n        skillName: z.string().describe(\"The name of the skill to load.\"),\n      }),\n      output: z.string(),\n      execute: ({ skillName }) => registry.get(skillName).instructions,\n    }),\n    createTool({\n      name: \"get_skill_reference\",\n      description: \"Read a reference file from an Agent Skill.\",\n      input: z.object({\n        skillName: z.string().describe(\"The name of the skill.\"),\n        referencePath: z.string().describe(\"A path listed in the skill references.\"),\n      }),\n      output: z.string(),\n      execute: ({ skillName, referencePath }) => registry.readReference(skillName, referencePath),\n    }),\n    createTool({\n      name: \"get_skill_script\",\n      description: \"Read a script file from an Agent Skill.\",\n      input: z.object({\n        skillName: z.string().describe(\"The name of the skill.\"),\n        scriptPath: z.string().describe(\"A path listed in the skill scripts.\"),\n      }),\n      output: z.string(),\n      execute: ({ skillName, scriptPath }) => registry.readScript(skillName, scriptPath),\n    }),\n    createTool({\n      name: \"run_skill_script\",\n      description: \"Execute a script from an Agent Skill with optional arguments.\",\n      input: z.object({\n        skillName: z.string().describe(\"The name of the skill.\"),\n        scriptPath: z.string().describe(\"A path listed in the skill scripts.\"),\n        args: z.array(z.string()).optional().describe(\"Arguments passed to the script.\"),\n        timeoutMs: z.number().int().positive().optional().describe(\"Execution timeout in ms.\"),\n      }),\n      output: z.string(),\n      execute: ({ skillName, scriptPath, args = [], timeoutMs = DEFAULT_TIMEOUT_MS }) =>\n        registry.runScript(skillName, scriptPath, args, timeoutMs),\n    }),\n  ];\n}\n\nclass SkillRegistry {\n  private readonly skills = new Map<string, Skill>();\n\n  constructor(skills: Skill[]) {\n    for (const skill of skills) {\n      this.skills.set(skill.name, skill);\n    }\n  }\n\n  get(skillName: string): Skill {\n    const skill = this.skills.get(skillName);\n    if (skill === undefined) {\n      throw new Error(`Skill not found: ${skillName}`);\n    }\n    return skill;\n  }\n\n  async readReference(skillName: string, referencePath: string): Promise<string> {\n    const skill = this.get(skillName);\n    const path = this.resolveContainedPath(skill, \"references\", referencePath);\n    if (!skill.references.includes(referencePath)) {\n      throw new Error(`Skill reference not found: ${skillName}/${referencePath}`);\n    }\n    return readFile(path, \"utf8\");\n  }\n\n  async readScript(skillName: string, scriptPath: string): Promise<string> {\n    const skill = this.get(skillName);\n    const path = this.resolveContainedPath(skill, \"scripts\", scriptPath);\n    if (!skill.scripts.includes(scriptPath)) {\n      throw new Error(`Skill script not found: ${skillName}/${scriptPath}`);\n    }\n    return readFile(path, \"utf8\");\n  }\n\n  async runScript(\n    skillName: string,\n    scriptPath: string,\n    args: string[],\n    timeoutMs: number,\n  ): Promise<string> {\n    const skill = this.get(skillName);\n    const script = this.resolveContainedPath(skill, \"scripts\", scriptPath);\n    if (!skill.scripts.includes(scriptPath)) {\n      throw new Error(`Skill script not found: ${skillName}/${scriptPath}`);\n    }\n    return runExecutable(script, args, skill.directory, timeoutMs);\n  }\n\n  private resolveContainedPath(\n    skill: Skill,\n    section: \"references\" | \"scripts\",\n    requestedPath: string,\n  ): string {\n    if (requestedPath.length === 0 || isAbsolute(requestedPath)) {\n      throw new Error(`Invalid skill path: ${requestedPath}`);\n    }\n\n    const root = resolve(skill.directory, section);\n    const resolved = resolve(root, requestedPath);\n    const rel = relative(root, resolved);\n    if (rel === \"..\" || rel.startsWith(`..${\"/\"}`) || rel.startsWith(`..${\"\\\\\"}`)) {\n      throw new Error(`Invalid skill path: ${requestedPath}`);\n    }\n\n    return resolved;\n  }\n}\n\nfunction runExecutable(\n  command: string,\n  args: string[],\n  cwd: string,\n  timeoutMs: number,\n): Promise<string> {\n  return new Promise((resolvePromise, reject) => {\n    const child = spawn(command, args, {\n      cwd,\n      shell: false,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n    });\n\n    let stdout = \"\";\n    let stderr = \"\";\n    let timedOut = false;\n    const timeout = setTimeout(() => {\n      timedOut = true;\n      child.kill();\n    }, timeoutMs);\n\n    child.stdout.setEncoding(\"utf8\");\n    child.stderr.setEncoding(\"utf8\");\n    child.stdout.on(\"data\", (chunk) => {\n      stdout = appendLimited(stdout, chunk);\n    });\n    child.stderr.on(\"data\", (chunk) => {\n      stderr = appendLimited(stderr, chunk);\n    });\n    child.on(\"error\", (error) => {\n      clearTimeout(timeout);\n      reject(error);\n    });\n    child.on(\"close\", (code, signal) => {\n      clearTimeout(timeout);\n      if (timedOut) {\n        reject(new Error(`Skill script timed out after ${timeoutMs}ms`));\n        return;\n      }\n\n      const output = formatProcessOutput(stdout, stderr);\n      if (code !== 0) {\n        reject(new Error(`Skill script exited with code ${code ?? \"unknown\"}: ${output}`));\n        return;\n      }\n      if (signal !== null) {\n        reject(new Error(`Skill script exited with signal ${signal}: ${output}`));\n        return;\n      }\n\n      resolvePromise(output);\n    });\n  });\n}\n\nfunction formatProcessOutput(stdout: string, stderr: string): string {\n  const parts: string[] = [];\n  if (stdout.length > 0) {\n    parts.push(`stdout:\\n${stdout}`);\n  }\n  if (stderr.length > 0) {\n    parts.push(`stderr:\\n${stderr}`);\n  }\n  return parts.length === 0 ? \"\" : parts.join(\"\\n\\n\");\n}\n\nfunction appendLimited(current: string, chunk: string): string {\n  const next = current + chunk;\n  if (next.length <= MAX_OUTPUT_CHARS) {\n    return next;\n  }\n  return `${next.slice(0, MAX_OUTPUT_CHARS)}\\n[truncated]`;\n}\n","import { skillInstructions } from \"./instructions\";\nimport { createSkillTools } from \"./tools\";\nimport type { Skill, SkillLoader, SkillSet } from \"./types\";\n\nexport async function loadSkills(loaders: SkillLoader | SkillLoader[]): Promise<SkillSet> {\n  const ordered = Array.isArray(loaders) ? loaders : [loaders];\n  const byName = new Map<string, Skill>();\n\n  for (const loader of ordered) {\n    for (const loaded of await loader.load()) {\n      byName.delete(loaded.name);\n      byName.set(loaded.name, loaded);\n    }\n  }\n\n  const skills = [...byName.values()];\n  return {\n    skills,\n    instructions: skillInstructions(skills),\n    tools: skills.length === 0 ? [] : createSkillTools(skills),\n  };\n}\n","import { readdir, readFile, stat } from \"node:fs/promises\";\nimport { basename, join, relative, resolve, sep } from \"node:path\";\nimport { parse as parseYaml } from \"yaml\";\nimport type { Skill, SkillLoader, SkillValidationIssue } from \"./types\";\nimport { SkillValidationError } from \"./types\";\n\ntype SkillFrontmatter = {\n  name?: unknown;\n  description?: unknown;\n  license?: unknown;\n  metadata?: unknown;\n};\n\nconst NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;\nconst MAX_NAME_LENGTH = 64;\nconst MAX_DESCRIPTION_LENGTH = 1024;\n\nexport const skill = {\n  local(path: string): SkillLoader {\n    return {\n      load: () => loadLocalSkills(path),\n    };\n  },\n};\n\nasync function loadLocalSkills(path: string): Promise<Skill[]> {\n  const root = resolve(path);\n  if (await hasSkillFile(root)) {\n    return [await readSkill(root)];\n  }\n\n  const entries = await readdir(root, { withFileTypes: true });\n  const skills: Skill[] = [];\n  for (const entry of entries) {\n    if (!entry.isDirectory()) {\n      continue;\n    }\n    const directory = join(root, entry.name);\n    if (await hasSkillFile(directory)) {\n      skills.push(await readSkill(directory));\n    }\n  }\n  return skills;\n}\n\nasync function hasSkillFile(directory: string): Promise<boolean> {\n  try {\n    const info = await stat(join(directory, \"SKILL.md\"));\n    return info.isFile();\n  } catch {\n    return false;\n  }\n}\n\nasync function readSkill(directory: string): Promise<Skill> {\n  const skillPath = join(directory, \"SKILL.md\");\n  const markdown = await readFile(skillPath, \"utf8\");\n  const parsed = parseSkillMarkdown(markdown, skillPath);\n  validateSkillFrontmatter(parsed.frontmatter, directory, skillPath);\n\n  const name = parsed.frontmatter.name as string;\n  const description = parsed.frontmatter.description as string;\n  const license =\n    typeof parsed.frontmatter.license === \"string\" ? parsed.frontmatter.license : undefined;\n  const metadata = isRecord(parsed.frontmatter.metadata) ? parsed.frontmatter.metadata : undefined;\n\n  return {\n    name,\n    description,\n    instructions: parsed.body.trim(),\n    directory,\n    references: await listRelativeFiles(join(directory, \"references\")),\n    scripts: await listRelativeFiles(join(directory, \"scripts\")),\n    license,\n    metadata,\n  };\n}\n\nfunction parseSkillMarkdown(\n  markdown: string,\n  path: string,\n): { frontmatter: SkillFrontmatter; body: string } {\n  if (!markdown.startsWith(\"---\\n\") && !markdown.startsWith(\"---\\r\\n\")) {\n    throw new SkillValidationError(\"Skill validation failed\", [\n      { path, message: \"SKILL.md must start with YAML frontmatter\" },\n    ]);\n  }\n\n  const newline = markdown.startsWith(\"---\\r\\n\") ? \"\\r\\n\" : \"\\n\";\n  const marker = `${newline}---${newline}`;\n  const end = markdown.indexOf(marker, 3);\n  if (end === -1) {\n    throw new SkillValidationError(\"Skill validation failed\", [\n      { path, message: \"SKILL.md frontmatter must end with ---\" },\n    ]);\n  }\n\n  const rawFrontmatter = markdown.slice(3 + newline.length, end);\n  const body = markdown.slice(end + marker.length);\n  const parsed = parseYaml(rawFrontmatter);\n  if (!isRecord(parsed)) {\n    throw new SkillValidationError(\"Skill validation failed\", [\n      { path, message: \"SKILL.md frontmatter must be a YAML object\" },\n    ]);\n  }\n\n  return { frontmatter: parsed, body };\n}\n\nfunction validateSkillFrontmatter(\n  frontmatter: SkillFrontmatter,\n  directory: string,\n  path: string,\n): void {\n  const issues: SkillValidationIssue[] = [];\n  const name = frontmatter.name;\n  const description = frontmatter.description;\n\n  if (typeof name !== \"string\" || name.length === 0) {\n    issues.push({ path, message: \"name is required\" });\n  } else {\n    if (name.length > MAX_NAME_LENGTH) {\n      issues.push({ path, message: `name must be at most ${MAX_NAME_LENGTH} characters` });\n    }\n    if (!NAME_PATTERN.test(name)) {\n      issues.push({\n        path,\n        message: \"name must contain lowercase letters, numbers, and hyphens only\",\n      });\n    }\n    if (basename(directory) !== name) {\n      issues.push({ path, message: \"name must match the skill directory name\" });\n    }\n  }\n\n  if (typeof description !== \"string\" || description.length === 0) {\n    issues.push({ path, message: \"description is required\" });\n  } else if (description.length > MAX_DESCRIPTION_LENGTH) {\n    issues.push({\n      path,\n      message: `description must be at most ${MAX_DESCRIPTION_LENGTH} characters`,\n    });\n  }\n\n  if (issues.length > 0) {\n    throw new SkillValidationError(\"Skill validation failed\", issues);\n  }\n}\n\nasync function listRelativeFiles(directory: string): Promise<string[]> {\n  try {\n    const info = await stat(directory);\n    if (!info.isDirectory()) {\n      return [];\n    }\n  } catch {\n    return [];\n  }\n\n  const files: string[] = [];\n  await collectFiles(directory, directory, files);\n  return files.sort();\n}\n\nasync function collectFiles(root: string, directory: string, files: string[]): Promise<void> {\n  const entries = await readdir(directory, { withFileTypes: true });\n  for (const entry of entries) {\n    const path = join(directory, entry.name);\n    if (entry.isDirectory()) {\n      await collectFiles(root, path, files);\n    } else if (entry.isFile()) {\n      files.push(toPortablePath(relative(root, path)));\n    }\n  }\n}\n\nfunction toPortablePath(path: string): string {\n  return sep === \"/\" ? path : path.split(sep).join(\"/\");\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n","import type { AnyTool } from \"../tool\";\n\nexport type Skill = {\n  readonly name: string;\n  readonly description: string;\n  readonly instructions: string;\n  readonly directory: string;\n  readonly references: string[];\n  readonly scripts: string[];\n  readonly license?: string | undefined;\n  readonly metadata?: Record<string, unknown> | undefined;\n};\n\nexport type SkillLoader = {\n  load(): Promise<Skill[]>;\n};\n\nexport type SkillSet = {\n  readonly skills: Skill[];\n  readonly tools: AnyTool[];\n  readonly instructions: string;\n};\n\nexport type SkillValidationIssue = {\n  path: string;\n  message: string;\n};\n\nexport class SkillValidationError extends Error {\n  readonly issues: SkillValidationIssue[];\n\n  constructor(message: string, issues: SkillValidationIssue[]) {\n    super(message);\n    this.name = \"SkillValidationError\";\n    this.issues = issues;\n  }\n}\n"],"mappings":"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","names":["skill","skill","readFile","relative","resolve","resolve","readFile","relative"]}

package/dist/chunk-X6FBOU2P.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/tool/dynamic-tools.ts","../src/tool/think-tool.ts"],"sourcesContent":["import type { ToolDefinition } from \"../completion\";\nimport type { EmbeddedDocument, EmbeddingModel, VectorMetadata } from \"../embeddings\";\nimport { embedDocuments } from \"../embeddings\";\nimport type { VectorSearchResult, VectorSearchToolOptions } from \"../vector-store\";\nimport {\n  InMemoryVectorStore,\n  type VectorSearchIndex,\n  type VectorSearchRequest,\n} from \"../vector-store\";\nimport type { AnyTool, Tool } from \"./tool\";\nimport { ToolSet } from \"./tool-set\";\n\nexport type ToolSearchDocument<Metadata extends VectorMetadata = VectorMetadata> = {\n  toolName: string;\n  definition: ToolDefinition;\n  text: string;\n  metadata?: Metadata | undefined;\n};\n\nexport type EmbedToolsOptions<Metadata extends VectorMetadata = VectorMetadata> = {\n  content?: ((tool: AnyTool, definition: ToolDefinition) => string | string[]) | undefined;\n  metadata?: ((tool: AnyTool, definition: ToolDefinition) => Metadata | undefined) | undefined;\n  concurrency?: number | undefined;\n};\n\nexport interface DynamicToolIndex<Metadata extends VectorMetadata = VectorMetadata>\n  extends VectorSearchIndex<ToolSearchDocument<Metadata>, Metadata> {\n  readonly toolSet: ToolSet;\n}\n\nexport async function embedTools<Metadata extends VectorMetadata = VectorMetadata>(\n  model: EmbeddingModel,\n  tools: AnyTool[] | ToolSet,\n  options: EmbedToolsOptions<Metadata> = {},\n): Promise<Array<EmbeddedDocument<ToolSearchDocument<Metadata>, Metadata>>> {\n  const toolList = Array.isArray(tools) ? tools : tools.values();\n  const definitions = await Promise.all(\n    toolList.map(async (tool) => ({ tool, definition: await tool.definition(\"\") })),\n  );\n  const documents = definitions.map(({ tool, definition }) => {\n    const content = options.content?.(tool, definition) ?? defaultToolEmbeddingText(definition);\n    const texts = Array.isArray(content) ? content : [content];\n    const metadata = options.metadata?.(tool, definition);\n    const document: ToolSearchDocument<Metadata> = {\n      toolName: tool.name,\n      definition,\n      text: texts.join(\"\\n\"),\n      ...(metadata === undefined ? {} : { metadata }),\n    };\n    return { tool, document, texts, metadata };\n  });\n\n  return embedDocuments(model, documents, {\n    id: (item) => item.tool.name,\n    content: (item) => item.texts,\n    metadata: (item) => item.metadata,\n    concurrency: options.concurrency,\n  }).then((embedded) =>\n    embedded.map((item) => ({\n      ...item,\n      document: item.document.document,\n    })),\n  );\n}\n\nexport async function createToolIndex<Metadata extends VectorMetadata = VectorMetadata>(\n  model: EmbeddingModel,\n  tools: AnyTool[] | ToolSet,\n  options: EmbedToolsOptions<Metadata> = {},\n): Promise<DynamicToolIndex<Metadata>> {\n  const toolSet = Array.isArray(tools) ? ToolSet.fromTools(tools) : tools;\n  const embedded = await embedTools(model, toolSet, options);\n  const index = InMemoryVectorStore.fromDocuments(embedded).index(model);\n  return new DynamicToolSearchIndex(index, toolSet);\n}\n\nexport function isDynamicToolIndex(value: unknown): value is DynamicToolIndex {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"toolSet\" in value &&\n    (value as { toolSet?: unknown }).toolSet instanceof ToolSet\n  );\n}\n\nclass DynamicToolSearchIndex<Metadata extends VectorMetadata>\n  implements DynamicToolIndex<Metadata>\n{\n  constructor(\n    private readonly index: VectorSearchIndex<ToolSearchDocument<Metadata>, Metadata>,\n    readonly toolSet: ToolSet,\n  ) {}\n\n  search(\n    request: VectorSearchRequest,\n  ): Promise<Array<VectorSearchResult<ToolSearchDocument<Metadata>, Metadata>>> {\n    return this.index.search(request);\n  }\n\n  searchIds(request: VectorSearchRequest): Promise<Array<{ score: number; id: string }>> {\n    return this.index.searchIds(request);\n  }\n\n  asTool(options: VectorSearchToolOptions): Tool<{ query: string; topK?: number }, unknown> {\n    return this.index.asTool(options);\n  }\n}\n\nfunction defaultToolEmbeddingText(definition: ToolDefinition): string[] {\n  return [definition.name, definition.description, JSON.stringify(definition.parameters)];\n}\n","import { z } from \"zod\";\nimport { createTool } from \"./create-tool\";\n\nconst defaultThinkToolDescription =\n  \"Use this tool to record a thought while reasoning through a complex task. It does not retrieve information, store memory, or change external state.\";\n\nconst thinkToolInput = z.object({\n  thought: z.string().describe(\"A thought to record while reasoning through a task.\"),\n});\n\nexport type CreateThinkToolOptions = {\n  name?: string;\n  description?: string;\n};\n\nexport function createThinkTool(options: CreateThinkToolOptions = {}) {\n  return createTool({\n    name: options.name ?? \"think\",\n    description: options.description ?? defaultThinkToolDescription,\n    input: thinkToolInput,\n    output: z.string(),\n    execute: (args) => args.thought,\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;AA8BA,eAAsB,WACpB,OACA,OACA,UAAuC,CAAC,GACkC;AAC1E,QAAM,WAAW,MAAM,QAAQ,KAAK,IAAI,QAAQ,MAAM,OAAO;AAC7D,QAAM,cAAc,MAAM,QAAQ;AAAA,IAChC,SAAS,IAAI,OAAO,UAAU,EAAE,MAAM,YAAY,MAAM,KAAK,WAAW,EAAE,EAAE,EAAE;AAAA,EAChF;AACA,QAAM,YAAY,YAAY,IAAI,CAAC,EAAE,MAAM,WAAW,MAAM;AAC1D,UAAM,UAAU,QAAQ,UAAU,MAAM,UAAU,KAAK,yBAAyB,UAAU;AAC1F,UAAM,QAAQ,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC,OAAO;AACzD,UAAM,WAAW,QAAQ,WAAW,MAAM,UAAU;AACpD,UAAM,WAAyC;AAAA,MAC7C,UAAU,KAAK;AAAA,MACf;AAAA,MACA,MAAM,MAAM,KAAK,IAAI;AAAA,MACrB,GAAI,aAAa,SAAY,CAAC,IAAI,EAAE,SAAS;AAAA,IAC/C;AACA,WAAO,EAAE,MAAM,UAAU,OAAO,SAAS;AAAA,EAC3C,CAAC;AAED,SAAO,eAAe,OAAO,WAAW;AAAA,IACtC,IAAI,CAAC,SAAS,KAAK,KAAK;AAAA,IACxB,SAAS,CAAC,SAAS,KAAK;AAAA,IACxB,UAAU,CAAC,SAAS,KAAK;AAAA,IACzB,aAAa,QAAQ;AAAA,EACvB,CAAC,EAAE;AAAA,IAAK,CAAC,aACP,SAAS,IAAI,CAAC,UAAU;AAAA,MACtB,GAAG;AAAA,MACH,UAAU,KAAK,SAAS;AAAA,IAC1B,EAAE;AAAA,EACJ;AACF;AAEA,eAAsB,gBACpB,OACA,OACA,UAAuC,CAAC,GACH;AACrC,QAAM,UAAU,MAAM,QAAQ,KAAK,IAAI,QAAQ,UAAU,KAAK,IAAI;AAClE,QAAM,WAAW,MAAM,WAAW,OAAO,SAAS,OAAO;AACzD,QAAM,QAAQ,oBAAoB,cAAc,QAAQ,EAAE,MAAM,KAAK;AACrE,SAAO,IAAI,uBAAuB,OAAO,OAAO;AAClD;AAEO,SAAS,mBAAmB,OAA2C;AAC5E,SACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACZ,MAAgC,mBAAmB;AAExD;AAEA,IAAM,yBAAN,MAEA;AAAA,EACE,YACmB,OACR,SACT;AAFiB;AACR;AAAA,EACR;AAAA,EAFgB;AAAA,EACR;AAAA,EAGX,OACE,SAC4E;AAC5E,WAAO,KAAK,MAAM,OAAO,OAAO;AAAA,EAClC;AAAA,EAEA,UAAU,SAA6E;AACrF,WAAO,KAAK,MAAM,UAAU,OAAO;AAAA,EACrC;AAAA,EAEA,OAAO,SAAmF;AACxF,WAAO,KAAK,MAAM,OAAO,OAAO;AAAA,EAClC;AACF;AAEA,SAAS,yBAAyB,YAAsC;AACtE,SAAO,CAAC,WAAW,MAAM,WAAW,aAAa,KAAK,UAAU,WAAW,UAAU,CAAC;AACxF;;;AC9GA,SAAS,SAAS;AAGlB,IAAM,8BACJ;AAEF,IAAM,iBAAiB,EAAE,OAAO;AAAA,EAC9B,SAAS,EAAE,OAAO,EAAE,SAAS,qDAAqD;AACpF,CAAC;AAOM,SAAS,gBAAgB,UAAkC,CAAC,GAAG;AACpE,SAAO,WAAW;AAAA,IAChB,MAAM,QAAQ,QAAQ;AAAA,IACtB,aAAa,QAAQ,eAAe;AAAA,IACpC,OAAO;AAAA,IACP,QAAQ,EAAE,OAAO;AAAA,IACjB,SAAS,CAAC,SAAS,KAAK;AAAA,EAC1B,CAAC;AACH;","names":[]}