agents-inc 0.152.1 → 0.154.0

package/dist/commands/import/skill.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/cli/commands/import/skill.ts"],"sourcesContent":["import { Args, Flags } from \"@oclif/core\";\nimport path from \"path\";\nimport { parse as parseYaml } from \"yaml\";\nimport { BaseCommand } from \"../../base-command.js\";\nimport { getErrorMessage } from \"../../utils/errors.js\";\nimport { EXIT_CODES } from \"../../lib/exit-codes.js\";\nimport { fetchFromSource } from \"../../lib/loading/index.js\";\nimport { importedSkillMetadataSchema } from \"../../lib/schemas.js\";\nimport { writeMetadataYaml } from \"../../lib/skills/skill-metadata.js\";\nimport { toTitleCase } from \"../../utils/string.js\";\nimport { getCurrentDate, computeFileHash } from \"../../lib/versioning.js\";\nimport {\n  copy,\n  directoryExists,\n  fileExists,\n  listDirectories,\n  readFile,\n  ensureDir,\n} from \"../../utils/fs.js\";\nimport { warn } from \"../../utils/logger.js\";\nimport {\n  DEFAULT_SKILLS_SUBDIR,\n  GITHUB_SOURCE,\n  LOCAL_SKILLS_PATH,\n  STANDARD_FILES,\n} from \"../../consts.js\";\nimport { stripYamlSchemaComment } from \"../../utils/yaml-schema.js\";\nimport { IMPORT_DEFAULTS } from \"../../lib/metadata-keys.js\";\nimport { STATUS_MESSAGES, INFO_MESSAGES } from \"../../utils/messages.js\";\n\nexport default class ImportSkill extends BaseCommand {\n  static summary = \"Import a skill from a third-party GitHub repository\";\n  static description =\n    \"Download and import skills from external GitHub repositories into your local \" +\n    \".claude/skills/ directory. Supports importing specific skills or listing available skills.\";\n\n  static examples = [\n    {\n      description: \"List available skills from a repository\",\n      command: \"<%= config.bin %> import skill github:vercel-labs/agent-skills --list\",\n    },\n    {\n      description: \"Import a specific skill\",\n      command:\n        \"<%= config.bin %> import skill github:vercel-labs/agent-skills --skill react-best-practices\",\n    },\n    {\n      description: \"Import all skills from a repository\",\n      command: \"<%= config.bin %> import skill github:vercel-labs/agent-skills --all\",\n    },\n  ];\n\n  static args = {\n    source: Args.string({\n      description:\n        \"GitHub repository source (github:owner/repo, https://github.com/owner/repo, or owner/repo)\",\n      required: true,\n    }),\n  };\n\n  // Override parent baseFlags to drop --source (positional source arg IS the source)\n  static baseFlags = {} as (typeof BaseCommand)[\"baseFlags\"];\n\n  static flags = {\n    skill: Flags.string({\n      char: \"n\",\n      description: \"Name of the specific skill to import\",\n      required: false,\n    }),\n    all: Flags.boolean({\n      char: \"a\",\n      description: \"Import all skills from the repository\",\n      default: false,\n    }),\n    list: Flags.boolean({\n      char: \"l\",\n      description: \"List available skills without importing\",\n      default: false,\n    }),\n    force: Flags.boolean({\n      char: \"f\",\n      description: \"Overwrite existing skills\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    const { args, flags } = await this.parse(ImportSkill);\n    const projectDir = process.cwd();\n\n    this.printHeader();\n    this.validateFlags(flags);\n\n    const { gigetSource, displaySource } = parseGitHubSource(args.source);\n    this.log(`Source: ${displaySource}`);\n\n    const repoPath = await this.fetchRepository(gigetSource, args.source);\n    const skillsDir = this.resolveSkillsDir(repoPath);\n    const availableSkills = await this.discoverAndValidate(skillsDir);\n\n    if (flags.list) {\n      this.listAvailableSkills(availableSkills);\n      return;\n    }\n\n    const skillsToImport = this.resolveSkillsToImport(flags, availableSkills);\n    await this.importSkills(skillsToImport, skillsDir, projectDir, displaySource, flags.force);\n  }\n\n  private printHeader(): void {\n    this.log(\"\");\n    this.log(\"Import Third-Party Skill\");\n    this.log(\"\");\n  }\n\n  private validateFlags(flags: { list: boolean; skill?: string; all: boolean }): void {\n    if (!flags.list && !flags.skill && !flags.all) {\n      this.error(\"Please specify --skill <name>, --all, or --list to list available skills\", {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n\n    if (flags.skill && flags.all) {\n      this.error(\"Cannot use --skill and --all together\", {\n        exit: EXIT_CODES.INVALID_ARGS,\n      });\n    }\n  }\n\n  private async fetchRepository(gigetSource: string, sourceArg: string): Promise<string> {\n    this.log(STATUS_MESSAGES.FETCHING_REPOSITORY);\n\n    try {\n      const result = await fetchSkillSource({ gigetSource });\n      this.log(result.fromCache ? \"Using cached source\" : \"Downloaded fresh copy\");\n      return result.path;\n    } catch (error) {\n      this.error(`Failed to fetch ${sourceArg}: ${getErrorMessage(error)}`, {\n        exit: EXIT_CODES.NETWORK_ERROR,\n      });\n    }\n  }\n\n  private resolveSkillsDir(repoPath: string): string {\n    return path.resolve(path.join(repoPath, DEFAULT_SKILLS_SUBDIR));\n  }\n\n  private async discoverAndValidate(skillsDir: string): Promise<string[]> {\n    if (!(await directoryExists(skillsDir))) {\n      this.error(\n        `Skills directory not found: ${DEFAULT_SKILLS_SUBDIR}\\n` +\n          `The repository doesn't have a '${DEFAULT_SKILLS_SUBDIR}' directory.`,\n        { exit: EXIT_CODES.INVALID_ARGS },\n      );\n    }\n\n    const availableSkills = await discoverValidSkills(skillsDir);\n\n    if (availableSkills.length === 0) {\n      this.error(\n        `No valid skills found in ${DEFAULT_SKILLS_SUBDIR}/\\nSkills must have a SKILL.md file.`,\n        { exit: EXIT_CODES.ERROR },\n      );\n    }\n\n    return availableSkills;\n  }\n\n  private listAvailableSkills(skills: string[]): void {\n    this.log(\"\");\n    this.log(`Available skills (${skills.length}):`);\n    this.log(\"\");\n    for (const skill of skills) {\n      this.log(`  - ${skill}`);\n    }\n    this.log(\"\");\n    this.log(\"Use --skill <name> to import a specific skill, or --all to import all.\");\n  }\n\n  private resolveSkillsToImport(\n    flags: { all: boolean; skill?: string },\n    availableSkills: string[],\n  ): string[] {\n    if (flags.all) {\n      return availableSkills;\n    }\n\n    if (flags.skill) {\n      if (!availableSkills.includes(flags.skill)) {\n        this.error(\n          `Skill '${flags.skill}' not found in repository.\\n` +\n            `Available skills: ${availableSkills.join(\", \")}\\n` +\n            `Use --list to see all available skills.`,\n          { exit: EXIT_CODES.INVALID_ARGS },\n        );\n      }\n      return [flags.skill];\n    }\n\n    return [];\n  }\n\n  private async importSkills(\n    skillsToImport: string[],\n    skillsDir: string,\n    projectDir: string,\n    displaySource: string,\n    force: boolean,\n  ): Promise<void> {\n    const destDir = path.join(projectDir, LOCAL_SKILLS_PATH);\n\n    this.log(\"\");\n    this.log(`Importing ${skillsToImport.length} skill(s)...`);\n\n    let imported = 0;\n    let skipped = 0;\n\n    for (const skillName of skillsToImport) {\n      const sourcePath = path.join(skillsDir, skillName);\n      const destPath = path.join(destDir, skillName);\n\n      if (await directoryExists(destPath)) {\n        if (!force) {\n          this.warn(`Skipping '${skillName}': already exists. Use --force to overwrite.`);\n          skipped++;\n          continue;\n        }\n      }\n\n      try {\n        await importSkillFromSource({ sourcePath, destPath, skillName, displaySource });\n        this.logSuccess(`Imported: ${skillName}`);\n        imported++;\n      } catch (error) {\n        this.warn(`Failed to import '${skillName}': ${getErrorMessage(error)}`);\n        skipped++;\n      }\n    }\n\n    this.log(\"\");\n    this.logSuccess(`Import complete: ${imported} imported, ${skipped} skipped`);\n    this.log(`Skills location: ${destDir}`);\n    this.log(\"\");\n    this.log(INFO_MESSAGES.RUN_COMPILE);\n    this.log(\"\");\n  }\n}\n\ntype ImportedForkedFromMetadata = {\n  source: string;\n  skillName: string;\n  contentHash: string;\n  date: string;\n};\n\ntype SkillMetadata = {\n  forkedFrom?: ImportedForkedFromMetadata;\n  [key: string]: unknown;\n};\n\ntype ParsedGitHubSource = {\n  gigetSource: string;\n  displaySource: string;\n};\n\ntype FetchSourceOptions = {\n  gigetSource: string;\n};\n\ntype FetchedSource = {\n  path: string;\n  fromCache: boolean;\n};\n\ntype ImportSkillOptions = {\n  sourcePath: string;\n  destPath: string;\n  skillName: string;\n  displaySource: string;\n};\n\n/**\n * Parses various GitHub URL formats into a normalized giget source string\n * and a human-readable display URL.\n *\n * Supports: `https://github.com/owner/repo`, `github:owner/repo`,\n * `gh:owner/repo`, and bare `owner/repo` formats.\n */\nfunction parseGitHubSource(source: string): ParsedGitHubSource {\n  if (source.startsWith(GITHUB_SOURCE.HTTPS_PREFIX)) {\n    const path = source.replace(GITHUB_SOURCE.HTTPS_PREFIX, \"\");\n    return {\n      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${path}`,\n      displaySource: source,\n    };\n  }\n\n  if (\n    source.startsWith(GITHUB_SOURCE.GITHUB_PREFIX) ||\n    source.startsWith(GITHUB_SOURCE.GH_PREFIX)\n  ) {\n    const normalized = source.startsWith(GITHUB_SOURCE.GH_PREFIX)\n      ? GITHUB_SOURCE.GITHUB_PREFIX + source.slice(GITHUB_SOURCE.GH_PREFIX.length)\n      : source;\n    return {\n      gigetSource: normalized,\n      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${normalized.replace(GITHUB_SOURCE.GITHUB_PREFIX, \"\")}`,\n    };\n  }\n\n  if (source.includes(\"/\") && !source.includes(\":\")) {\n    return {\n      gigetSource: `${GITHUB_SOURCE.GITHUB_PREFIX}${source}`,\n      displaySource: `${GITHUB_SOURCE.HTTPS_PREFIX}${source}`,\n    };\n  }\n\n  return {\n    gigetSource: source,\n    displaySource: source,\n  };\n}\n\n/**\n * Fetches a source repository using giget. Wraps `fetchFromSource` from the\n * loading layer.\n */\nasync function fetchSkillSource(options: FetchSourceOptions): Promise<FetchedSource> {\n  const result = await fetchFromSource(options.gigetSource);\n  return { path: result.path, fromCache: result.fromCache };\n}\n\n/**\n * Discovers valid skill directories within a source path by checking\n * for the presence of SKILL.md files.\n *\n * @returns Sorted list of directory names that contain a SKILL.md file.\n */\nasync function discoverValidSkills(skillsDir: string): Promise<string[]> {\n  const skillDirs = await listDirectories(skillsDir);\n  const checks = await Promise.all(\n    skillDirs.map(async (skillDir) => ({\n      skillDir,\n      hasSkillMd: await fileExists(path.join(skillsDir, skillDir, STANDARD_FILES.SKILL_MD)),\n    })),\n  );\n  return checks\n    .filter((c) => c.hasSkillMd)\n    .map((c) => c.skillDir)\n    .sort();\n}\n\n/**\n * Imports a single skill from a source directory into the destination.\n *\n * Validates that the source skill has a SKILL.md file, copies the directory,\n * and injects `forkedFrom` metadata into the destination's metadata.yaml.\n *\n * @throws {Error} If the source skill is missing a SKILL.md file.\n */\nasync function importSkillFromSource(options: ImportSkillOptions): Promise<void> {\n  const { sourcePath, destPath, skillName, displaySource } = options;\n  const skillMdPath = path.join(sourcePath, STANDARD_FILES.SKILL_MD);\n\n  if (!(await fileExists(skillMdPath))) {\n    throw new Error(\n      `Missing required SKILL.md file at ${skillMdPath}\\n` +\n        `Every skill must have a SKILL.md file containing the skill's prompt content.\\n` +\n        `Create one with:\\n` +\n        `  echo \"# ${skillName}\" > ${path.join(sourcePath, STANDARD_FILES.SKILL_MD)}`,\n    );\n  }\n\n  const contentHash = await computeFileHash(skillMdPath);\n\n  await ensureDir(path.dirname(destPath));\n  await copy(sourcePath, destPath);\n\n  await injectImportedForkedFromMetadata(destPath, skillName, displaySource, contentHash);\n}\n\n/**\n * Injects `forkedFrom` metadata into a third-party imported skill's metadata.yaml.\n *\n * Handles three cases:\n * 1. Existing metadata.yaml -- preserves fields, adds/overwrites forkedFrom\n * 2. Existing metadata.json -- converts to YAML, adds forkedFrom\n * 3. No metadata file -- creates minimal metadata.yaml with forkedFrom\n *\n * Different from `injectForkedFromMetadata` in `skill-metadata.ts` which tracks\n * internal marketplace fork lineage using `skillId`. This function tracks\n * third-party imports using `source` + `skillName`.\n */\nasync function injectImportedForkedFromMetadata(\n  destPath: string,\n  skillName: string,\n  source: string,\n  contentHash: string,\n): Promise<void> {\n  const forkedFrom: ImportedForkedFromMetadata = {\n    source,\n    skillName,\n    contentHash,\n    date: getCurrentDate(),\n  };\n\n  const yamlPath = path.join(destPath, STANDARD_FILES.METADATA_YAML);\n  const jsonPath = path.join(destPath, STANDARD_FILES.METADATA_JSON);\n\n  if (await fileExists(yamlPath)) {\n    return mergeForkedFromIntoYaml(yamlPath, forkedFrom);\n  }\n  if (await fileExists(jsonPath)) {\n    return convertJsonToYamlWithForkedFrom(jsonPath, yamlPath, forkedFrom);\n  }\n  return createMinimalMetadata(yamlPath, skillName, forkedFrom);\n}\n\nasync function mergeForkedFromIntoYaml(\n  yamlPath: string,\n  forkedFrom: ImportedForkedFromMetadata,\n): Promise<void> {\n  const rawContent = await readFile(yamlPath);\n  const { schemaComment, yamlContent } = stripYamlSchemaComment(rawContent);\n\n  const raw = parseYaml(yamlContent);\n  const parseResult = importedSkillMetadataSchema.safeParse(raw);\n  if (!parseResult.success) {\n    warn(\n      `Malformed metadata.yaml at ${yamlPath} — existing fields may be lost\\n` +\n        `  Validation errors: ${parseResult.error.issues.map((i) => i.message).join(\", \")}\\n` +\n        `  Expected fields: displayName (string), cliDescription (string), category (string)\\n` +\n        `  Validate your YAML syntax at https://yamllint.com`,\n    );\n  }\n  const metadata: SkillMetadata = {\n    ...(parseResult.success ? parseResult.data : {}),\n    forkedFrom,\n  };\n\n  await writeMetadataYaml(yamlPath, metadata, schemaComment);\n}\n\nasync function convertJsonToYamlWithForkedFrom(\n  jsonPath: string,\n  yamlPath: string,\n  forkedFrom: ImportedForkedFromMetadata,\n): Promise<void> {\n  const rawContent = await readFile(jsonPath);\n  let jsonParsed: unknown;\n  try {\n    jsonParsed = JSON.parse(rawContent);\n  } catch {\n    warn(\n      `Malformed JSON in ${jsonPath} — skipping metadata injection\\n` +\n        `  Common issues: trailing commas, unquoted keys, single quotes instead of double quotes\\n` +\n        `  Validate your JSON at https://jsonlint.com`,\n    );\n    return;\n  }\n  const jsonResult = importedSkillMetadataSchema.safeParse(jsonParsed);\n  const metadata: SkillMetadata = {\n    ...(jsonResult.success ? jsonResult.data : {}),\n    forkedFrom,\n  };\n\n  await writeMetadataYaml(yamlPath, metadata);\n}\n\nasync function createMinimalMetadata(\n  yamlPath: string,\n  skillName: string,\n  forkedFrom: ImportedForkedFromMetadata,\n): Promise<void> {\n  const minimalMetadata: SkillMetadata = {\n    displayName: toTitleCase(skillName),\n    cliDescription: \"Imported from third-party repository\",\n    category: IMPORT_DEFAULTS.CATEGORY,\n    author: IMPORT_DEFAULTS.AUTHOR,\n    forkedFrom,\n  };\n\n  await writeMetadataYaml(yamlPath, minimalMetadata);\n}\n"],"mappings":"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","names":["path"]}

package/dist/commands/new/agent.js

@@ -1,300 +0,0 @@
-#!/usr/bin/env node
-import {
-  promptValue
-} from "../../chunk-Q2KG7UV3.js";
-import {
-  FEATURE_FLAGS,
-  featureDisabledError
-} from "../../chunk-WBCPLH66.js";
-import {
-  getAgentDefinitions
-} from "../../chunk-E5X6RJ4E.js";
-import "../../chunk-JFLVEFFP.js";
-import {
-  BaseCommand,
-  EXIT_CODES
-} from "../../chunk-KR65TPKC.js";
-import "../../chunk-ZL7PFNHN.js";
-import {
-  isClaudeCLIAvailable,
-  loadConfigTypesDataInBackground,
-  resolveInstallPaths,
-  resolveSource,
-  writeScaffoldedEntityTypes
-} from "../../chunk-EEPELKOM.js";
-import {
-  fileExists,
-  getErrorMessage,
-  modelNameSchema,
-  readFile
-} from "../../chunk-PMM2MYMA.js";
-import "../../chunk-WKTHWQKM.js";
-import "../../chunk-VASLW636.js";
-import {
-  CLAUDE_DIR,
-  CLI_COLORS,
-  STANDARD_DIRS,
-  STANDARD_FILES
-} from "../../chunk-76ADG7LQ.js";
-import "../../chunk-UBEDZ4FD.js";
-
-// src/cli/commands/new/agent.tsx
-import { useState } from "react";
-import { Args, Flags } from "@oclif/core";
-import { TextInput } from "@inkjs/ui";
-import { spawn } from "child_process";
-import matter from "gray-matter";
-import { z } from "zod";
-import { Box, Text, useApp, useInput } from "ink";
-import path from "path";
-import { jsx, jsxs } from "react/jsx-runtime";
-var SEPARATOR_WIDTH = 60;
-var PurposeInput = ({ onSubmit, onCancel }) => {
-  const { exit } = useApp();
-  const [error, setError] = useState(null);
-  useInput((_input, key) => {
-    if (key.escape) {
-      onCancel();
-      exit();
-    }
-  });
-  const handleSubmit = (value) => {
-    const trimmed = value.trim();
-    if (!trimmed) {
-      setError("Purpose is required");
-      return;
-    }
-    onSubmit(trimmed);
-    exit();
-  };
-  return /* @__PURE__ */ jsxs(Box, { flexDirection: "column", children: [
-    /* @__PURE__ */ jsx(Text, { bold: true, children: "Create New Agent" }),
-    /* @__PURE__ */ jsx(Text, { children: "What should this agent do?" }),
-    /* @__PURE__ */ jsx(Text, { dimColor: true, children: "e.g., Manages database migrations with rollback support" }),
-    /* @__PURE__ */ jsx(Text, { children: " " }),
-    /* @__PURE__ */ jsx(TextInput, { placeholder: "Enter agent purpose...", onSubmit: handleSubmit }),
-    error && /* @__PURE__ */ jsx(Box, { marginTop: 1, children: /* @__PURE__ */ jsx(Text, { color: CLI_COLORS.ERROR, children: error }) })
-  ] });
-};
-var NewAgent = class _NewAgent extends BaseCommand {
-  static summary = "Create a new custom agent using AI generation";
-  static description = "Uses the agent-summoner meta-agent to scaffold a new agent with proper structure and documentation.";
-  static examples = [
-    {
-      description: "Scaffold an agent (interactive prompt)",
-      command: "<%= config.bin %> <%= command.id %> my-agent"
-    },
-    {
-      description: "Scaffold with purpose provided up front",
-      command: '<%= config.bin %> <%= command.id %> my-agent --purpose "Manage DB migrations"'
-    },
-    {
-      description: "Overwrite an existing agent",
-      command: "<%= config.bin %> <%= command.id %> my-agent --force"
-    }
-  ];
-  static args = {
-    name: Args.string({
-      description: "Name of the agent to create",
-      required: true
-    })
-  };
-  static flags = {
-    ...BaseCommand.baseFlags,
-    purpose: Flags.string({
-      char: "p",
-      description: "Purpose/description of the agent",
-      required: false
-    }),
-    force: Flags.boolean({
-      char: "f",
-      description: "Overwrite existing agent",
-      default: false
-    })
-  };
-  async run() {
-    if (!FEATURE_FLAGS.NEW_AGENT_COMMAND) {
-      this.error(featureDisabledError("new agent"), {
-        exit: EXIT_CODES.ERROR
-      });
-    }
-    const { args, flags } = await this.parse(_NewAgent);
-    const projectDir = process.cwd();
-    const configTypesReady = loadConfigTypesDataInBackground(flags.source, projectDir);
-    await this.ensureClaudeCliAvailable();
-    const purpose = flags.purpose ?? await this.promptForPurpose();
-    const outputDir = path.join(resolveInstallPaths(projectDir, "project").agentsDir, "_custom");
-    await this.checkExistingDir(path.join(outputDir, args.name), flags.force);
-    this.logAgentPlan(args.name, purpose, outputDir);
-    await this.generateAgent(args.name, purpose, outputDir, flags, projectDir);
-    await this.updateConfigTypes(projectDir, configTypesReady, args.name);
-    this.log("");
-    this.log("\u2500".repeat(SEPARATOR_WIDTH));
-    this.logSuccess("Agent creation complete!");
-  }
-  async checkExistingDir(agentDir, force) {
-    await this.ensureDirOverwritable(agentDir, force, {
-      exists: `Agent directory already exists: ${agentDir}`,
-      overwriting: `Overwriting existing agent at ${agentDir}`
-    });
-  }
-  async ensureClaudeCliAvailable() {
-    const cliAvailable = await isClaudeCLIAvailable();
-    if (!cliAvailable) {
-      this.error(
-        "Claude CLI not found. Please install it first:\n  npm install -g @anthropic-ai/claude-code",
-        { exit: EXIT_CODES.ERROR }
-      );
-    }
-  }
-  async promptForPurpose() {
-    const outcome = await promptValue(
-      (resolve) => /* @__PURE__ */ jsx(
-        PurposeInput,
-        {
-          onSubmit: (value) => resolve({ status: "submitted", purpose: value }),
-          onCancel: () => resolve({ status: "cancelled" })
-        }
-      ),
-      { onExit: { status: "cancelled" } }
-    );
-    if (outcome.status === "cancelled") {
-      this.log("Cancelled");
-      this.exit(EXIT_CODES.CANCELLED);
-      throw new Error("unreachable");
-    }
-    return outcome.purpose;
-  }
-  logAgentPlan(name, purpose, outputDir) {
-    this.log("");
-    this.log(`Agent name: ${name}`);
-    this.log(`Purpose: ${purpose}`);
-    this.log(`Output: ${outputDir}`);
-    this.log("");
-  }
-  async generateAgent(name, purpose, outputDir, flags, projectDir) {
-    this.log("Fetching agent-summoner from source...");
-    try {
-      const sourceConfig = await resolveSource(flags.source, projectDir);
-      const agentDef = await loadMetaAgent({
-        projectDir,
-        source: sourceConfig.source
-      });
-      this.log("Meta-agent loaded");
-      this.log("");
-      const agentPrompt = buildAgentPrompt(name, purpose, outputDir);
-      this.log("Invoking agent-summoner to create your agent...");
-      this.log("\u2500".repeat(SEPARATOR_WIDTH));
-      this.log("");
-      await invokeMetaAgent({
-        agentDef,
-        prompt: agentPrompt
-      });
-    } catch (error) {
-      this.handleError(error);
-    }
-  }
-  async updateConfigTypes(projectDir, configTypesReady, agentName) {
-    try {
-      await writeScaffoldedEntityTypes(projectDir, configTypesReady, {
-        extraAgentNames: [agentName]
-      });
-    } catch (error) {
-      this.warn(`Could not update ${STANDARD_FILES.CONFIG_TYPES_TS}: ${getErrorMessage(error)}`);
-    }
-  }
-};
-var META_AGENT_NAME = "agent-summoner";
-var metaAgentFrontmatterSchema = z.object({
-  description: z.string().optional(),
-  tools: z.union([z.string(), z.array(z.string())]).optional(),
-  model: modelNameSchema.optional()
-});
-function parseCompiledAgent(content) {
-  const { data, content: body } = matter(content);
-  const frontmatter = metaAgentFrontmatterSchema.parse(data);
-  const tools = typeof frontmatter.tools === "string" ? frontmatter.tools.split(",").map((t) => t.trim()) : frontmatter.tools;
-  return {
-    description: frontmatter.description || "Creates new agents",
-    prompt: body.trim(),
-    model: frontmatter.model,
-    tools
-  };
-}
-async function loadMetaAgent(options) {
-  const { projectDir, source } = options;
-  const compiledFileName = `${META_AGENT_NAME}.md`;
-  const localAgentPath = path.join(
-    resolveInstallPaths(projectDir, "project").agentsDir,
-    compiledFileName
-  );
-  if (await fileExists(localAgentPath)) {
-    return parseCompiledAgent(await readFile(localAgentPath));
-  }
-  try {
-    const agentPaths = await getAgentDefinitions(source, { projectDir });
-    const remoteAgentPath = path.join(
-      agentPaths.sourcePath,
-      CLAUDE_DIR,
-      STANDARD_DIRS.AGENTS,
-      compiledFileName
-    );
-    if (await fileExists(remoteAgentPath)) {
-      return parseCompiledAgent(await readFile(remoteAgentPath));
-    }
-  } catch {
-  }
-  throw new Error(
-    `Agent '${META_AGENT_NAME}' not found.
-
-Run 'compile' first to generate agents.`
-  );
-}
-function buildAgentPrompt(agentName, purpose, outputDir) {
-  return `Create a new Claude Code agent named "${agentName}" in the directory "${outputDir}".
-
-Agent Purpose: ${purpose}
-
-Requirements:
-1. Create the agent directory structure at ${outputDir}/${agentName}/
-2. Create metadata.yaml with appropriate configuration
-3. Create identity.md with the agent's role and context
-4. Create playbook.md with the agent's operational process
-5. Optionally create output.md if output format guidance would help
-6. Optionally create critical-requirements.md for important rules
-7. Include \`custom: true\` in the metadata.yaml configuration
-
-Follow the existing agent patterns in the codebase. Keep the agent focused and practical.`;
-}
-async function invokeMetaAgent(options) {
-  const { agentDef, prompt } = options;
-  const agentsJson = JSON.stringify({
-    [META_AGENT_NAME]: {
-      description: agentDef.description,
-      prompt: agentDef.prompt,
-      model: agentDef.model,
-      tools: agentDef.tools
-    }
-  });
-  const args = ["--agents", agentsJson, "--agent", META_AGENT_NAME, "--prompt", prompt];
-  return new Promise((resolve, reject) => {
-    const child = spawn("claude", args, {
-      stdio: "inherit"
-    });
-    child.on("error", (error) => {
-      reject(new Error(`Failed to spawn claude CLI: ${error.message}`));
-    });
-    child.on("close", (code) => {
-      if (code === 0) {
-        resolve();
-      } else {
-        reject(new Error(`Claude CLI exited with code ${code}`));
-      }
-    });
-  });
-}
-export {
-  buildAgentPrompt,
-  NewAgent as default
-};
-//# sourceMappingURL=agent.js.map

package/dist/commands/new/agent.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../src/cli/commands/new/agent.tsx"],"sourcesContent":["import React, { useState } from \"react\";\n\nimport { Args, Flags } from \"@oclif/core\";\nimport { TextInput } from \"@inkjs/ui\";\nimport { spawn } from \"child_process\";\nimport matter from \"gray-matter\";\nimport { z } from \"zod\";\nimport { Box, Text, useApp, useInput } from \"ink\";\nimport path from \"path\";\n\nimport { BaseCommand } from \"../../base-command.js\";\nimport { promptValue } from \"../../components/common/prompt-confirm.js\";\nimport { CLAUDE_DIR, CLI_COLORS, STANDARD_DIRS, STANDARD_FILES } from \"../../consts.js\";\nimport { resolveInstallPaths } from \"../../lib/installation/index.js\";\nimport { resolveSource } from \"../../lib/configuration/index.js\";\nimport {\n  type ConfigTypesBackgroundData,\n  loadConfigTypesDataInBackground,\n} from \"../../lib/configuration/config-types-writer.js\";\nimport { writeScaffoldedEntityTypes } from \"../../lib/config-gate/index.js\";\nimport { EXIT_CODES } from \"../../lib/exit-codes.js\";\nimport { FEATURE_FLAGS, featureDisabledError } from \"../../lib/feature-flags.js\";\nimport { modelNameSchema } from \"../../lib/schemas.js\";\nimport { getAgentDefinitions } from \"../../lib/agents/index.js\";\nimport type { ModelName } from \"../../types/index.js\";\nimport { getErrorMessage } from \"../../utils/errors.js\";\nimport { isClaudeCLIAvailable } from \"../../utils/exec.js\";\nimport { fileExists, readFile } from \"../../utils/fs.js\";\n\nconst SEPARATOR_WIDTH = 60;\n\ntype PurposeInputProps = {\n  onSubmit: (purpose: string) => void;\n  onCancel: () => void;\n};\n\ntype PurposeOutcome = { status: \"submitted\"; purpose: string } | { status: \"cancelled\" };\n\nconst PurposeInput: React.FC<PurposeInputProps> = ({ onSubmit, onCancel }) => {\n  const { exit } = useApp();\n  const [error, setError] = useState<string | null>(null);\n\n  useInput((_input, key) => {\n    if (key.escape) {\n      onCancel();\n      exit();\n    }\n  });\n\n  const handleSubmit = (value: string) => {\n    const trimmed = value.trim();\n    if (!trimmed) {\n      setError(\"Purpose is required\");\n      return;\n    }\n    onSubmit(trimmed);\n    exit();\n  };\n\n  return (\n    <Box flexDirection=\"column\">\n      <Text bold>Create New Agent</Text>\n      <Text>What should this agent do?</Text>\n      <Text dimColor>e.g., Manages database migrations with rollback support</Text>\n      <Text> </Text>\n      <TextInput placeholder=\"Enter agent purpose...\" onSubmit={handleSubmit} />\n      {error && (\n        <Box marginTop={1}>\n          <Text color={CLI_COLORS.ERROR}>{error}</Text>\n        </Box>\n      )}\n    </Box>\n  );\n};\n\nexport default class NewAgent extends BaseCommand {\n  static summary = \"Create a new custom agent using AI generation\";\n  static description =\n    \"Uses the agent-summoner meta-agent to scaffold a new agent with proper structure and documentation.\";\n\n  static examples = [\n    {\n      description: \"Scaffold an agent (interactive prompt)\",\n      command: \"<%= config.bin %> <%= command.id %> my-agent\",\n    },\n    {\n      description: \"Scaffold with purpose provided up front\",\n      command: '<%= config.bin %> <%= command.id %> my-agent --purpose \"Manage DB migrations\"',\n    },\n    {\n      description: \"Overwrite an existing agent\",\n      command: \"<%= config.bin %> <%= command.id %> my-agent --force\",\n    },\n  ];\n\n  static args = {\n    name: Args.string({\n      description: \"Name of the agent to create\",\n      required: true,\n    }),\n  };\n\n  static flags = {\n    ...BaseCommand.baseFlags,\n    purpose: Flags.string({\n      char: \"p\",\n      description: \"Purpose/description of the agent\",\n      required: false,\n    }),\n    force: Flags.boolean({\n      char: \"f\",\n      description: \"Overwrite existing agent\",\n      default: false,\n    }),\n  };\n\n  async run(): Promise<void> {\n    if (!FEATURE_FLAGS.NEW_AGENT_COMMAND) {\n      this.error(featureDisabledError(\"new agent\"), {\n        exit: EXIT_CODES.ERROR,\n      });\n    }\n\n    const { args, flags } = await this.parse(NewAgent);\n    const projectDir = process.cwd();\n\n    const configTypesReady = loadConfigTypesDataInBackground(flags.source, projectDir);\n    await this.ensureClaudeCliAvailable();\n\n    const purpose = flags.purpose ?? (await this.promptForPurpose());\n    const outputDir = path.join(resolveInstallPaths(projectDir, \"project\").agentsDir, \"_custom\");\n\n    await this.checkExistingDir(path.join(outputDir, args.name), flags.force);\n    this.logAgentPlan(args.name, purpose, outputDir);\n    await this.generateAgent(args.name, purpose, outputDir, flags, projectDir);\n    await this.updateConfigTypes(projectDir, configTypesReady, args.name);\n\n    this.log(\"\");\n    this.log(\"─\".repeat(SEPARATOR_WIDTH));\n    this.logSuccess(\"Agent creation complete!\");\n  }\n\n  private async checkExistingDir(agentDir: string, force: boolean): Promise<void> {\n    await this.ensureDirOverwritable(agentDir, force, {\n      exists: `Agent directory already exists: ${agentDir}`,\n      overwriting: `Overwriting existing agent at ${agentDir}`,\n    });\n  }\n\n  private async ensureClaudeCliAvailable(): Promise<void> {\n    const cliAvailable = await isClaudeCLIAvailable();\n    if (!cliAvailable) {\n      this.error(\n        \"Claude CLI not found. Please install it first:\\n\" +\n          \"  npm install -g @anthropic-ai/claude-code\",\n        { exit: EXIT_CODES.ERROR },\n      );\n    }\n  }\n\n  private async promptForPurpose(): Promise<string> {\n    const outcome = await promptValue<PurposeOutcome>(\n      (resolve) => (\n        <PurposeInput\n          onSubmit={(value) => resolve({ status: \"submitted\", purpose: value })}\n          onCancel={() => resolve({ status: \"cancelled\" })}\n        />\n      ),\n      { onExit: { status: \"cancelled\" } },\n    );\n\n    if (outcome.status === \"cancelled\") {\n      this.log(\"Cancelled\");\n      this.exit(EXIT_CODES.CANCELLED);\n      throw new Error(\"unreachable\");\n    }\n\n    return outcome.purpose;\n  }\n\n  private logAgentPlan(name: string, purpose: string, outputDir: string): void {\n    this.log(\"\");\n    this.log(`Agent name: ${name}`);\n    this.log(`Purpose: ${purpose}`);\n    this.log(`Output: ${outputDir}`);\n    this.log(\"\");\n  }\n\n  private async generateAgent(\n    name: string,\n    purpose: string,\n    outputDir: string,\n    flags: { source: string | undefined },\n    projectDir: string,\n  ): Promise<void> {\n    this.log(\"Fetching agent-summoner from source...\");\n\n    try {\n      const sourceConfig = await resolveSource(flags.source, projectDir);\n      const agentDef = await loadMetaAgent({\n        projectDir,\n        source: sourceConfig.source,\n      });\n      this.log(\"Meta-agent loaded\");\n      this.log(\"\");\n\n      const agentPrompt = buildAgentPrompt(name, purpose, outputDir);\n\n      this.log(\"Invoking agent-summoner to create your agent...\");\n      this.log(\"─\".repeat(SEPARATOR_WIDTH));\n      this.log(\"\");\n\n      await invokeMetaAgent({\n        agentDef,\n        prompt: agentPrompt,\n      });\n    } catch (error) {\n      this.handleError(error);\n    }\n  }\n\n  private async updateConfigTypes(\n    projectDir: string,\n    configTypesReady: Promise<ConfigTypesBackgroundData>,\n    agentName: string,\n  ): Promise<void> {\n    try {\n      await writeScaffoldedEntityTypes(projectDir, configTypesReady, {\n        extraAgentNames: [agentName],\n      });\n    } catch (error) {\n      this.warn(`Could not update ${STANDARD_FILES.CONFIG_TYPES_TS}: ${getErrorMessage(error)}`);\n    }\n  }\n}\n\nconst META_AGENT_NAME = \"agent-summoner\";\n\ntype NewAgentInput = {\n  description: string;\n  prompt: string;\n  model?: ModelName;\n  tools?: string[];\n};\n\n/** Frontmatter shape of the compiled agent-summoner.md read at the matter() parse boundary. */\nconst metaAgentFrontmatterSchema = z.object({\n  description: z.string().optional(),\n  tools: z.union([z.string(), z.array(z.string())]).optional(),\n  model: modelNameSchema.optional(),\n});\n\ntype LoadMetaAgentOptions = {\n  projectDir: string;\n  source: string;\n};\n\ntype InvokeMetaAgentOptions = {\n  agentDef: NewAgentInput;\n  prompt: string;\n};\n\nfunction parseCompiledAgent(content: string): NewAgentInput {\n  const { data, content: body } = matter(content);\n  const frontmatter = metaAgentFrontmatterSchema.parse(data);\n  const tools =\n    typeof frontmatter.tools === \"string\"\n      ? frontmatter.tools.split(\",\").map((t) => t.trim())\n      : frontmatter.tools;\n\n  return {\n    description: frontmatter.description || \"Creates new agents\",\n    prompt: body.trim(),\n    model: frontmatter.model,\n    tools,\n  };\n}\n\nasync function loadMetaAgent(options: LoadMetaAgentOptions): Promise<NewAgentInput> {\n  const { projectDir, source } = options;\n  const compiledFileName = `${META_AGENT_NAME}.md`;\n\n  const localAgentPath = path.join(\n    resolveInstallPaths(projectDir, \"project\").agentsDir,\n    compiledFileName,\n  );\n  if (await fileExists(localAgentPath)) {\n    return parseCompiledAgent(await readFile(localAgentPath));\n  }\n\n  try {\n    const agentPaths = await getAgentDefinitions(source, { projectDir });\n    const remoteAgentPath = path.join(\n      agentPaths.sourcePath,\n      CLAUDE_DIR,\n      STANDARD_DIRS.AGENTS,\n      compiledFileName,\n    );\n    if (await fileExists(remoteAgentPath)) {\n      return parseCompiledAgent(await readFile(remoteAgentPath));\n    }\n  } catch {\n    // Source does not contain agents — fall through to error\n  }\n\n  throw new Error(\n    `Agent '${META_AGENT_NAME}' not found.\\n\\n` + `Run 'compile' first to generate agents.`,\n  );\n}\n\nexport function buildAgentPrompt(agentName: string, purpose: string, outputDir: string): string {\n  return `Create a new Claude Code agent named \"${agentName}\" in the directory \"${outputDir}\".\n\nAgent Purpose: ${purpose}\n\nRequirements:\n1. Create the agent directory structure at ${outputDir}/${agentName}/\n2. Create metadata.yaml with appropriate configuration\n3. Create identity.md with the agent's role and context\n4. Create playbook.md with the agent's operational process\n5. Optionally create output.md if output format guidance would help\n6. Optionally create critical-requirements.md for important rules\n7. Include \\`custom: true\\` in the metadata.yaml configuration\n\nFollow the existing agent patterns in the codebase. Keep the agent focused and practical.`;\n}\n\nasync function invokeMetaAgent(options: InvokeMetaAgentOptions): Promise<void> {\n  const { agentDef, prompt } = options;\n\n  const agentsJson = JSON.stringify({\n    [META_AGENT_NAME]: {\n      description: agentDef.description,\n      prompt: agentDef.prompt,\n      model: agentDef.model,\n      tools: agentDef.tools,\n    },\n  });\n\n  const args = [\"--agents\", agentsJson, \"--agent\", META_AGENT_NAME, \"--prompt\", prompt];\n\n  return new Promise((resolve, reject) => {\n    const child = spawn(\"claude\", args, {\n      stdio: \"inherit\",\n    });\n\n    child.on(\"error\", (error) => {\n      reject(new Error(`Failed to spawn claude CLI: ${error.message}`));\n    });\n\n    child.on(\"close\", (code) => {\n      if (code === 0) {\n        resolve();\n      } else {\n        reject(new Error(`Claude CLI exited with code ${code}`));\n      }\n    });\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,SAAgB,gBAAgB;AAEhC,SAAS,MAAM,aAAa;AAC5B,SAAS,iBAAiB;AAC1B,SAAS,aAAa;AACtB,OAAO,YAAY;AACnB,SAAS,SAAS;AAClB,SAAS,KAAK,MAAM,QAAQ,gBAAgB;AAC5C,OAAO,UAAU;AAoDb,SACE,KADF;AA/BJ,IAAM,kBAAkB;AASxB,IAAM,eAA4C,CAAC,EAAE,UAAU,SAAS,MAAM;AAC5E,QAAM,EAAE,KAAK,IAAI,OAAO;AACxB,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AAEtD,WAAS,CAAC,QAAQ,QAAQ;AACxB,QAAI,IAAI,QAAQ;AACd,eAAS;AACT,WAAK;AAAA,IACP;AAAA,EACF,CAAC;AAED,QAAM,eAAe,CAAC,UAAkB;AACtC,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,CAAC,SAAS;AACZ,eAAS,qBAAqB;AAC9B;AAAA,IACF;AACA,aAAS,OAAO;AAChB,SAAK;AAAA,EACP;AAEA,SACE,qBAAC,OAAI,eAAc,UACjB;AAAA,wBAAC,QAAK,MAAI,MAAC,8BAAgB;AAAA,IAC3B,oBAAC,QAAK,wCAA0B;AAAA,IAChC,oBAAC,QAAK,UAAQ,MAAC,qEAAuD;AAAA,IACtE,oBAAC,QAAK,eAAC;AAAA,IACP,oBAAC,aAAU,aAAY,0BAAyB,UAAU,cAAc;AAAA,IACvE,SACC,oBAAC,OAAI,WAAW,GACd,8BAAC,QAAK,OAAO,WAAW,OAAQ,iBAAM,GACxC;AAAA,KAEJ;AAEJ;AAEA,IAAqB,WAArB,MAAqB,kBAAiB,YAAY;AAAA,EAChD,OAAO,UAAU;AAAA,EACjB,OAAO,cACL;AAAA,EAEF,OAAO,WAAW;AAAA,IAChB;AAAA,MACE,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,IACA;AAAA,MACE,aAAa;AAAA,MACb,SAAS;AAAA,IACX;AAAA,EACF;AAAA,EAEA,OAAO,OAAO;AAAA,IACZ,MAAM,KAAK,OAAO;AAAA,MAChB,aAAa;AAAA,MACb,UAAU;AAAA,IACZ,CAAC;AAAA,EACH;AAAA,EAEA,OAAO,QAAQ;AAAA,IACb,GAAG,YAAY;AAAA,IACf,SAAS,MAAM,OAAO;AAAA,MACpB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,UAAU;AAAA,IACZ,CAAC;AAAA,IACD,OAAO,MAAM,QAAQ;AAAA,MACnB,MAAM;AAAA,MACN,aAAa;AAAA,MACb,SAAS;AAAA,IACX,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,MAAqB;AACzB,QAAI,CAAC,cAAc,mBAAmB;AACpC,WAAK,MAAM,qBAAqB,WAAW,GAAG;AAAA,QAC5C,MAAM,WAAW;AAAA,MACnB,CAAC;AAAA,IACH;AAEA,UAAM,EAAE,MAAM,MAAM,IAAI,MAAM,KAAK,MAAM,SAAQ;AACjD,UAAM,aAAa,QAAQ,IAAI;AAE/B,UAAM,mBAAmB,gCAAgC,MAAM,QAAQ,UAAU;AACjF,UAAM,KAAK,yBAAyB;AAEpC,UAAM,UAAU,MAAM,WAAY,MAAM,KAAK,iBAAiB;AAC9D,UAAM,YAAY,KAAK,KAAK,oBAAoB,YAAY,SAAS,EAAE,WAAW,SAAS;AAE3F,UAAM,KAAK,iBAAiB,KAAK,KAAK,WAAW,KAAK,IAAI,GAAG,MAAM,KAAK;AACxE,SAAK,aAAa,KAAK,MAAM,SAAS,SAAS;AAC/C,UAAM,KAAK,cAAc,KAAK,MAAM,SAAS,WAAW,OAAO,UAAU;AACzE,UAAM,KAAK,kBAAkB,YAAY,kBAAkB,KAAK,IAAI;AAEpE,SAAK,IAAI,EAAE;AACX,SAAK,IAAI,SAAI,OAAO,eAAe,CAAC;AACpC,SAAK,WAAW,0BAA0B;AAAA,EAC5C;AAAA,EAEA,MAAc,iBAAiB,UAAkB,OAA+B;AAC9E,UAAM,KAAK,sBAAsB,UAAU,OAAO;AAAA,MAChD,QAAQ,mCAAmC,QAAQ;AAAA,MACnD,aAAa,iCAAiC,QAAQ;AAAA,IACxD,CAAC;AAAA,EACH;AAAA,EAEA,MAAc,2BAA0C;AACtD,UAAM,eAAe,MAAM,qBAAqB;AAChD,QAAI,CAAC,cAAc;AACjB,WAAK;AAAA,QACH;AAAA,QAEA,EAAE,MAAM,WAAW,MAAM;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAc,mBAAoC;AAChD,UAAM,UAAU,MAAM;AAAA,MACpB,CAAC,YACC;AAAA,QAAC;AAAA;AAAA,UACC,UAAU,CAAC,UAAU,QAAQ,EAAE,QAAQ,aAAa,SAAS,MAAM,CAAC;AAAA,UACpE,UAAU,MAAM,QAAQ,EAAE,QAAQ,YAAY,CAAC;AAAA;AAAA,MACjD;AAAA,MAEF,EAAE,QAAQ,EAAE,QAAQ,YAAY,EAAE;AAAA,IACpC;AAEA,QAAI,QAAQ,WAAW,aAAa;AAClC,WAAK,IAAI,WAAW;AACpB,WAAK,KAAK,WAAW,SAAS;AAC9B,YAAM,IAAI,MAAM,aAAa;AAAA,IAC/B;AAEA,WAAO,QAAQ;AAAA,EACjB;AAAA,EAEQ,aAAa,MAAc,SAAiB,WAAyB;AAC3E,SAAK,IAAI,EAAE;AACX,SAAK,IAAI,eAAe,IAAI,EAAE;AAC9B,SAAK,IAAI,YAAY,OAAO,EAAE;AAC9B,SAAK,IAAI,WAAW,SAAS,EAAE;AAC/B,SAAK,IAAI,EAAE;AAAA,EACb;AAAA,EAEA,MAAc,cACZ,MACA,SACA,WACA,OACA,YACe;AACf,SAAK,IAAI,wCAAwC;AAEjD,QAAI;AACF,YAAM,eAAe,MAAM,cAAc,MAAM,QAAQ,UAAU;AACjE,YAAM,WAAW,MAAM,cAAc;AAAA,QACnC;AAAA,QACA,QAAQ,aAAa;AAAA,MACvB,CAAC;AACD,WAAK,IAAI,mBAAmB;AAC5B,WAAK,IAAI,EAAE;AAEX,YAAM,cAAc,iBAAiB,MAAM,SAAS,SAAS;AAE7D,WAAK,IAAI,iDAAiD;AAC1D,WAAK,IAAI,SAAI,OAAO,eAAe,CAAC;AACpC,WAAK,IAAI,EAAE;AAEX,YAAM,gBAAgB;AAAA,QACpB;AAAA,QACA,QAAQ;AAAA,MACV,CAAC;AAAA,IACH,SAAS,OAAO;AACd,WAAK,YAAY,KAAK;AAAA,IACxB;AAAA,EACF;AAAA,EAEA,MAAc,kBACZ,YACA,kBACA,WACe;AACf,QAAI;AACF,YAAM,2BAA2B,YAAY,kBAAkB;AAAA,QAC7D,iBAAiB,CAAC,SAAS;AAAA,MAC7B,CAAC;AAAA,IACH,SAAS,OAAO;AACd,WAAK,KAAK,oBAAoB,eAAe,eAAe,KAAK,gBAAgB,KAAK,CAAC,EAAE;AAAA,IAC3F;AAAA,EACF;AACF;AAEA,IAAM,kBAAkB;AAUxB,IAAM,6BAA6B,EAAE,OAAO;AAAA,EAC1C,aAAa,EAAE,OAAO,EAAE,SAAS;AAAA,EACjC,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS;AAAA,EAC3D,OAAO,gBAAgB,SAAS;AAClC,CAAC;AAYD,SAAS,mBAAmB,SAAgC;AAC1D,QAAM,EAAE,MAAM,SAAS,KAAK,IAAI,OAAO,OAAO;AAC9C,QAAM,cAAc,2BAA2B,MAAM,IAAI;AACzD,QAAM,QACJ,OAAO,YAAY,UAAU,WACzB,YAAY,MAAM,MAAM,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAChD,YAAY;AAElB,SAAO;AAAA,IACL,aAAa,YAAY,eAAe;AAAA,IACxC,QAAQ,KAAK,KAAK;AAAA,IAClB,OAAO,YAAY;AAAA,IACnB;AAAA,EACF;AACF;AAEA,eAAe,cAAc,SAAuD;AAClF,QAAM,EAAE,YAAY,OAAO,IAAI;AAC/B,QAAM,mBAAmB,GAAG,eAAe;AAE3C,QAAM,iBAAiB,KAAK;AAAA,IAC1B,oBAAoB,YAAY,SAAS,EAAE;AAAA,IAC3C;AAAA,EACF;AACA,MAAI,MAAM,WAAW,cAAc,GAAG;AACpC,WAAO,mBAAmB,MAAM,SAAS,cAAc,CAAC;AAAA,EAC1D;AAEA,MAAI;AACF,UAAM,aAAa,MAAM,oBAAoB,QAAQ,EAAE,WAAW,CAAC;AACnE,UAAM,kBAAkB,KAAK;AAAA,MAC3B,WAAW;AAAA,MACX;AAAA,MACA,cAAc;AAAA,MACd;AAAA,IACF;AACA,QAAI,MAAM,WAAW,eAAe,GAAG;AACrC,aAAO,mBAAmB,MAAM,SAAS,eAAe,CAAC;AAAA,IAC3D;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,QAAM,IAAI;AAAA,IACR,UAAU,eAAe;AAAA;AAAA;AAAA,EAC3B;AACF;AAEO,SAAS,iBAAiB,WAAmB,SAAiB,WAA2B;AAC9F,SAAO,yCAAyC,SAAS,uBAAuB,SAAS;AAAA;AAAA,iBAE1E,OAAO;AAAA;AAAA;AAAA,6CAGqB,SAAS,IAAI,SAAS;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AASnE;AAEA,eAAe,gBAAgB,SAAgD;AAC7E,QAAM,EAAE,UAAU,OAAO,IAAI;AAE7B,QAAM,aAAa,KAAK,UAAU;AAAA,IAChC,CAAC,eAAe,GAAG;AAAA,MACjB,aAAa,SAAS;AAAA,MACtB,QAAQ,SAAS;AAAA,MACjB,OAAO,SAAS;AAAA,MAChB,OAAO,SAAS;AAAA,IAClB;AAAA,EACF,CAAC;AAED,QAAM,OAAO,CAAC,YAAY,YAAY,WAAW,iBAAiB,YAAY,MAAM;AAEpF,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,QAAQ,MAAM,UAAU,MAAM;AAAA,MAClC,OAAO;AAAA,IACT,CAAC;AAED,UAAM,GAAG,SAAS,CAAC,UAAU;AAC3B,aAAO,IAAI,MAAM,+BAA+B,MAAM,OAAO,EAAE,CAAC;AAAA,IAClE,CAAC;AAED,UAAM,GAAG,SAAS,CAAC,SAAS;AAC1B,UAAI,SAAS,GAAG;AACd,gBAAQ;AAAA,MACV,OAAO;AACL,eAAO,IAAI,MAAM,+BAA+B,IAAI,EAAE,CAAC;AAAA,MACzD;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH;","names":[]}