@aigne/doc-smith 0.9.8-alpha.3 → 0.9.8-alpha.4

package/agents/chat/index.mjs

@@ -1,59 +0,0 @@
-import { mkdir, readFile } from "node:fs/promises";
-import { parse } from "yaml";
-
-await mkdir(".aigne/doc-smith", { recursive: true });
-const config = await readFile(".aigne/doc-smith/config.yaml", "utf-8")
-  .then((raw) => parse(raw))
-  .catch(() => null);
-
-const docsDir = config?.docsDir || ".aigne/doc-smith/docs";
-await mkdir(docsDir, { recursive: true });
-
-export default {
-  type: "ai",
-  name: "chat",
-  description: "Start interactive document generation assistant",
-  instructions: {
-    url: "./chat-system.md",
-  },
-  input_key: "message",
-  afs: {
-    modules: [
-      {
-        module: "history",
-        options: {
-          storage: {
-            url: "file:.aigne/doc-smith/.local/afs-storage.sqlite3",
-          },
-        },
-      },
-      {
-        module: "system-fs",
-        options: {
-          name: "source",
-          localPath: ".",
-          description: "Project root directory for document generation",
-        },
-      },
-      {
-        module: "system-fs",
-        options: {
-          name: "docs",
-          localPath: docsDir,
-          description: "Generated documentation files directory",
-        },
-      },
-    ],
-  },
-  afs_config: {
-    inject_history: true,
-  },
-  skills: [
-    "./skills/list-documents.mjs",
-    "./skills/generate-document.yaml",
-    "./skills/update-document.yaml",
-    "../publish/index.yaml",
-    "../localize/index.yaml",
-    "../utils/exit.mjs",
-  ],
-};

package/agents/chat/skills/generate-document.yaml

@@ -1,15 +0,0 @@
-type: team
-name: generateDocument
-description: Generate complete documentation for your project, or update/delete existing documents or structure based on user feedback
-input_schema:
-  type: object
-  properties:
-    feedback:
-      type: string
-      description: How to generate or update the document content
-  required:
-    - feedback
-skills:
-  - url: ../../create/index.yaml
-    default_input:
-      isChat: true

package/agents/chat/skills/list-documents.mjs

@@ -1,15 +0,0 @@
-import { getMainLanguageFiles } from "../../../utils/docs-finder-utils.mjs";
-import init from "../../init/index.mjs";
-
-export default async function listDocuments(_, options) {
-  const config = await init({ checkOnly: true }, options);
-
-  // Get all main language .md files in docsDir
-  const mainLanguageFiles = await getMainLanguageFiles(config.docsDir, config.locale);
-
-  return {
-    documents: mainLanguageFiles,
-  };
-}
-
-listDocuments.description = "List all available documentation files";

package/agents/chat/skills/update-document.yaml

@@ -1,24 +0,0 @@
-type: team
-name: updateDocument
-description: Update a existing document based on user feedback
-input_schema:
-  type: object
-  properties:
-    docs:
-      type: array
-      items:
-        type: string
-      description: Documents to update, must from listDocuments output
-    feedback:
-      type: string
-      description: Tell us what to change in this content
-    reset:
-      type: boolean
-      description: Regenerate the document from scratch, ignoring previous versions
-  required:
-    - docs
-    - feedback
-skills:
-  - url: ../../update/index.yaml
-    default_input:
-      isChat: true

package/agents/clear/choose-contents.mjs

@@ -1,192 +0,0 @@
-import {
-  getConfigFilePath,
-  getMediaDescriptionCachePath,
-  getStructurePlanPath,
-  toDisplayPath,
-} from "../../utils/file-utils.mjs";
-
-const TARGET_METADATA = {
-  generatedDocs: {
-    label: "Generated Documents",
-    description: ({ docsDir }) =>
-      `Select and delete specific generated documents in './${toDisplayPath(docsDir)}'. The documentation structure will be preserved.`,
-    agent: "clearGeneratedDocs",
-  },
-  documentStructure: {
-    label: "Documentation Structure",
-    description: ({ docsDir, workDir }) =>
-      `Delete all generated documents in './${toDisplayPath(docsDir)}' and the documentation structure in './${toDisplayPath(
-        getStructurePlanPath(workDir),
-      )}'.`,
-    agent: "clearDocumentStructure",
-  },
-  documentConfig: {
-    label: "Document Configuration",
-    description: ({ workDir }) =>
-      `Delete the configuration file in './${toDisplayPath(
-        getConfigFilePath(workDir),
-      )}'. You will need to run \`aigne doc init\` to regenerate it.`,
-    agent: "clearDocumentConfig",
-  },
-  authTokens: {
-    label: "Authorizations",
-    description: () =>
-      "Delete authorization information. You will need to re-authorize after clearing.",
-    agent: "clearAuthTokens",
-  },
-  deploymentConfig: {
-    label: "Deployment Config",
-    description: ({ workDir }) =>
-      `Delete the appUrl from './${toDisplayPath(getConfigFilePath(workDir))}'.`,
-    agent: "clearDeploymentConfig",
-  },
-  mediaDescription: {
-    label: "Media File Descriptions",
-    description: () =>
-      `Delete AI-generated descriptions in './${toDisplayPath(
-        getMediaDescriptionCachePath(),
-      )}'. They will be regenerated on the next run.`,
-    agent: "clearMediaDescription",
-  },
-};
-
-const TARGET_KEYS = Object.keys(TARGET_METADATA);
-
-function normalizeTarget(value) {
-  if (!value) return null;
-  const trimmed = value.trim();
-  if (TARGET_METADATA[trimmed]) return trimmed;
-
-  const lowerMatched = TARGET_KEYS.find((key) => key.toLowerCase() === trimmed.toLowerCase());
-  return lowerMatched || null;
-}
-
-export default async function chooseContents(input = {}, options = {}) {
-  const { targets: rawTargets, ...rest } = input;
-
-  const normalizedTargets = Array.isArray(rawTargets)
-    ? rawTargets.map(normalizeTarget).filter(Boolean)
-    : [];
-
-  let selectedTargets = [...new Set(normalizedTargets)];
-
-  if (selectedTargets.length === 0) {
-    if (options?.prompts?.checkbox) {
-      const choices = Object.entries(TARGET_METADATA).map(([value, def]) => ({
-        name: def.label,
-        value,
-        description: def.description({ docsDir: input.docsDir, workDir: input.workDir }),
-      }));
-
-      selectedTargets = await options.prompts.checkbox({
-        message: "Please select the items you'd like to clear:",
-        choices,
-        validate: (answer) => (answer.length > 0 ? true : "You must select at least one item."),
-      });
-    } else {
-      return {
-        message: `Available options to clear: ${TARGET_KEYS.join(", ")}`,
-        availableTargets: TARGET_KEYS,
-      };
-    }
-  }
-
-  if (selectedTargets.length === 0) {
-    return {
-      message: "You haven't selected any items to clear.",
-    };
-  }
-
-  const results = [];
-  let hasError = false;
-  let configCleared = false;
-
-  for (const target of selectedTargets) {
-    const metadata = TARGET_METADATA[target];
-    if (!metadata) {
-      results.push({
-        status: "error",
-        message: `Unknown target: ${target}`,
-      });
-      hasError = true;
-      continue;
-    }
-
-    try {
-      const clearAgent = options.context?.agents?.[metadata.agent];
-      if (!clearAgent) {
-        throw new Error(`The clear agent '${metadata.agent}' was not found.`);
-      }
-
-      const result = await options.context.invoke(clearAgent, rest);
-
-      if (result.error) {
-        hasError = true;
-        results.push({
-          status: "error",
-          message: result.message,
-        });
-      } else {
-        const status = result.cleared ? "removed" : "noop";
-        results.push({
-          status,
-          message: result.message,
-          path: result.path,
-          suggestions: result.suggestions,
-        });
-
-        if (target === "documentConfig" && result.cleared) {
-          configCleared = true;
-        }
-      }
-    } catch (error) {
-      hasError = true;
-      results.push({
-        status: "error",
-        message: `Failed to clear ${metadata.label}: ${error.message}`,
-      });
-    }
-  }
-
-  const header = hasError
-    ? "🧹 Cleanup finished with some issues.\n"
-    : "🧹 Cleanup completed successfully!\n";
-  const detailLines = results.map((item) => `${item.message}`).join("\n\n");
-
-  const suggestions = [];
-  results.forEach((result) => {
-    if (result.suggestions) {
-      suggestions.push(...result.suggestions);
-    }
-  });
-
-  if (configCleared && !suggestions.some((s) => s.includes("aigne doc init"))) {
-    suggestions.push("Run `aigne doc init` to generate a fresh configuration file.");
-  }
-
-  const message = [header, "", detailLines, suggestions.length ? "" : null, suggestions.join("\n")]
-    .filter(Boolean)
-    .join("\n");
-
-  return {
-    message,
-  };
-}
-
-chooseContents.input_schema = {
-  type: "object",
-  properties: {
-    targets: {
-      type: "array",
-      description: "A list of items to clear without confirmation.",
-      items: {
-        type: "string",
-        enum: TARGET_KEYS,
-      },
-    },
-  },
-};
-
-chooseContents.taskTitle = "Select and clear project contents";
-chooseContents.description =
-  "Select and clear project contents, such as generated documents, configuration, and authorization tokens.";

package/agents/clear/clear-auth-tokens.mjs

@@ -1,88 +0,0 @@
-import chalk from "chalk";
-import { createStore } from "../../utils/store/index.mjs";
-
-export default async function clearAuthTokens(_input = {}, options = {}) {
-  const store = await createStore();
-
-  try {
-    const listMap = await store.listMap();
-    // Get all available sites
-    const siteHostnames = Object.keys(listMap);
-
-    if (siteHostnames.length === 0) {
-      return {
-        message: "🔑 No site authorizations found to clear",
-      };
-    }
-
-    // Display all sites with their URLs for user selection
-    const choices = siteHostnames.map((hostname) => {
-      return {
-        name: `${chalk.cyan(hostname)}`,
-        value: hostname,
-        checked: false, // Allow multiple selection
-      };
-    });
-
-    // Add an option to clear all site authorizations
-    choices.push({
-      name: chalk.red("🗑️  Clear ALL site authorizations"),
-      value: "__ALL__",
-      checked: false,
-    });
-
-    let selectedSites = [];
-
-    if (options?.prompts?.checkbox) {
-      selectedSites = await options.prompts.checkbox({
-        message: "Select sites to clear authorization from:",
-        choices,
-        validate: (answer) => (answer.length > 0 ? true : "Please select at least one site."),
-      });
-    } else {
-      // If no prompts available, clear all site authorizations
-      selectedSites = ["__ALL__"];
-    }
-
-    if (selectedSites.length === 0) {
-      return {
-        message: "🔑 No sites selected for clearing authorization",
-      };
-    }
-
-    const results = [];
-    let clearedCount = 0;
-
-    if (selectedSites.includes("__ALL__")) {
-      // Clear all site authorizations
-      await store.clear();
-      results.push(`✔ Cleared site authorization for all sites (${siteHostnames.length} sites)`);
-      clearedCount = siteHostnames.length;
-    } else {
-      for (const hostname of selectedSites) {
-        await store.deleteItem(hostname);
-        results.push(`✔ Cleared site authorization for ${chalk.cyan(hostname)}`);
-        clearedCount++;
-      }
-    }
-
-    const header = `🔑 Successfully cleared site authorizations!`;
-    const detailLines = results.map((item) => `  ${item}`).join("\n");
-
-    const message = [header, "", detailLines, ""].filter(Boolean).join("\n");
-
-    return {
-      message,
-      clearedCount,
-      clearedSites: selectedSites.includes("__ALL__") ? siteHostnames : selectedSites,
-    };
-  } catch (error) {
-    return {
-      message: `⚠️ Failed to clear site authorizations: ${error.message}`,
-      error: true,
-    };
-  }
-}
-
-clearAuthTokens.taskTitle = "Clear site authorizations";
-clearAuthTokens.description = "Clear site authorizations for document publishing sites";

package/agents/clear/clear-deployment-config.mjs

@@ -1,49 +0,0 @@
-import { readFile, writeFile } from "node:fs/promises";
-import yaml from "yaml";
-import { pathExists, toDisplayPath, getConfigFilePath } from "../../utils/file-utils.mjs";
-
-export default async function clearDeploymentConfig(input = {}) {
-  const { workDir } = input;
-
-  const configFilePath = getConfigFilePath(workDir);
-  const displayPath = toDisplayPath(configFilePath);
-
-  try {
-    // Check if config file exists
-    const exists = await pathExists(configFilePath);
-    if (!exists) {
-      return {
-        message: `📦 Config file not found (${displayPath}). No need to clear appUrl.`,
-      };
-    }
-
-    // Remove appUrl field while preserving comments
-    const configContent = await readFile(configFilePath, "utf-8");
-    const doc = yaml.parseDocument(configContent);
-
-    if (doc.has("appUrl")) {
-      doc.delete("appUrl");
-      await writeFile(
-        configFilePath,
-        doc.toString({
-          keepSourceTokens: true,
-          indent: 2,
-          lineWidth: 0,
-          minContentWidth: 0,
-        }),
-        "utf-8",
-      );
-    }
-
-    return {
-      message: `📦 Cleared appUrl from config file (${displayPath})`,
-    };
-  } catch (error) {
-    return {
-      error: true,
-      message: `⚠️ Failed to clear deployment config: ${error.message}`,
-    };
-  }
-}
-
-clearDeploymentConfig.taskTitle = "Clear deployment configuration";

package/agents/clear/clear-document-config.mjs

@@ -1,36 +0,0 @@
-import { rm } from "node:fs/promises";
-import { pathExists, toDisplayPath, getConfigFilePath } from "../../utils/file-utils.mjs";
-
-export default async function clearDocumentConfig({ workDir }) {
-  const documentConfigPath = getConfigFilePath(workDir);
-  const displayPath = toDisplayPath(documentConfigPath);
-
-  try {
-    const existed = await pathExists(documentConfigPath);
-    await rm(documentConfigPath, { recursive: true, force: true });
-
-    const message = existed
-      ? `⚙️ Cleared document configuration (${displayPath})`
-      : `⚙️ Document configuration already empty (${displayPath})`;
-
-    const suggestions = existed
-      ? ["Run `aigne doc init` to generate a fresh configuration file."]
-      : [];
-
-    return {
-      message,
-      cleared: existed,
-      path: displayPath,
-      suggestions,
-    };
-  } catch (error) {
-    return {
-      message: `⚠️ Failed to clear document configuration: ${error.message}`,
-      error: true,
-      path: displayPath,
-    };
-  }
-}
-
-clearDocumentConfig.taskTitle = "Clear document configuration";
-clearDocumentConfig.description = "Clear the document configuration file";

package/agents/clear/clear-document-structure.mjs

@@ -1,102 +0,0 @@
-import { rm } from "node:fs/promises";
-import { pathExists, toDisplayPath, getStructurePlanPath } from "../../utils/file-utils.mjs";
-
-export default async function clearDocumentStructure(input = {}, _options = {}) {
-  const { docsDir, workDir } = input;
-
-  const structurePlanPath = getStructurePlanPath(workDir);
-
-  const results = [];
-  let hasError = false;
-
-  // Clear structure-plan.json
-  try {
-    const structureExists = await pathExists(structurePlanPath);
-    await rm(structurePlanPath, { force: true });
-
-    const structureDisplayPath = toDisplayPath(structurePlanPath);
-    const structureMessage = structureExists
-      ? `✔ Cleared documentation structure (${structureDisplayPath})`
-      : `• Documentation structure already empty (${structureDisplayPath})`;
-
-    results.push({
-      type: "structure",
-      cleared: structureExists,
-      message: structureMessage,
-    });
-  } catch (error) {
-    hasError = true;
-    results.push({
-      type: "structure",
-      error: true,
-      message: `✗ Failed to clear documentation structure: ${error.message}`,
-    });
-  }
-
-  // Clear documents directory if provided
-  if (docsDir) {
-    try {
-      const docsExists = await pathExists(docsDir);
-      await rm(docsDir, { recursive: true, force: true });
-
-      const docsDisplayPath = toDisplayPath(docsDir);
-      const docsMessage = docsExists
-        ? `✔ Cleared documents directory (${docsDisplayPath})`
-        : `• Documents directory already empty (${docsDisplayPath})`;
-
-      results.push({
-        type: "documents",
-        cleared: docsExists,
-        message: docsMessage,
-      });
-    } catch (error) {
-      hasError = true;
-      results.push({
-        type: "documents",
-        error: true,
-        message: `✗ Failed to clear documents directory: ${error.message}`,
-      });
-    }
-  }
-
-  // Prepare summary message
-  const clearedItems = results.filter((r) => r.cleared).length;
-  const errorItems = results.filter((r) => r.error).length;
-
-  let header;
-  if (errorItems > 0) {
-    header = "⚠️ Documentation Structure cleanup finished with some issues.";
-  } else if (clearedItems > 0) {
-    header = "📖 Documentation Structure cleared successfully!";
-  } else {
-    header = "📖 Documentation Structure already empty.";
-  }
-
-  const detailLines = results.map((item) => `  ${item.message}`).join("\n");
-  const message = [header, "", detailLines].filter(Boolean).join("\n");
-
-  return {
-    message,
-    results,
-    hasError,
-    clearedCount: clearedItems,
-  };
-}
-
-clearDocumentStructure.input_schema = {
-  type: "object",
-  properties: {
-    docsDir: {
-      type: "string",
-      description: "The documents directory to clear (optional)",
-    },
-    workDir: {
-      type: "string",
-      description: "The working directory (defaults to current directory)",
-    },
-  },
-};
-
-clearDocumentStructure.taskTitle = "Clear documentation structure and all generated documents";
-clearDocumentStructure.description =
-  "Clear the documentation structure (structure-plan.json) and optionally the documents directory";