@aigne/doc-smith 0.8.11-beta.5 → 0.8.11-beta.7

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.8.11-beta.5"
+  ".": "0.8.11-beta.7"
 }

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.8.11-beta.7](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.11-beta.6...v0.8.11-beta.7) (2025-10-03)
+
+
+### Features
+
+* enhance document generator and updater by fs tools ([#156](https://github.com/AIGNE-io/aigne-doc-smith/issues/156)) ([64ee91c](https://github.com/AIGNE-io/aigne-doc-smith/commit/64ee91c59498b4fd788e287cb81bbc640d042bcc))
+* use shared context for faster structure and doc tuning ([#157](https://github.com/AIGNE-io/aigne-doc-smith/issues/157)) ([e5cb30e](https://github.com/AIGNE-io/aigne-doc-smith/commit/e5cb30ec114d51a19f0086b3e4aaf2ec70aea046))
+
+
+### Bug Fixes
+
+* update docs and refine custom component prompts ([#160](https://github.com/AIGNE-io/aigne-doc-smith/issues/160)) ([233f3ca](https://github.com/AIGNE-io/aigne-doc-smith/commit/233f3ca449646b39a3e493d2bb1fe59e50376827))
+
+## [0.8.11-beta.6](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.11-beta.5...v0.8.11-beta.6) (2025-10-02)
+
+
+### Miscellaneous Chores
+
+* release 0.8.11-beta.6 ([ecc8f5c](https://github.com/AIGNE-io/aigne-doc-smith/commit/ecc8f5c4ff9cc813e5cf7e35cbfdb915826cd183))
+
 ## [0.8.11-beta.5](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.11-beta.4...v0.8.11-beta.5) (2025-10-01)
 
 
@@ -79,7 +99,7 @@
 ### Bug Fixes
 
 * polish code test ([#122](https://github.com/AIGNE-io/aigne-doc-smith/issues/122)) ([0629705](https://github.com/AIGNE-io/aigne-doc-smith/commit/0629705ebd271282411d507421c1ba5dd01473b9))
-* update document structure review prompts and display ([#119](https://github.com/AIGNE-io/aigne-doc-smith/issues/119)) ([e2d99db](https://github.com/AIGNE-io/aigne-doc-smith/commit/e2d99db83ff3a6266b32dd450a79b6e000aff09e))
+* update documentation structure review prompts and display ([#119](https://github.com/AIGNE-io/aigne-doc-smith/issues/119)) ([e2d99db](https://github.com/AIGNE-io/aigne-doc-smith/commit/e2d99db83ff3a6266b32dd450a79b6e000aff09e))
 * update usage rules for field elements ([#120](https://github.com/AIGNE-io/aigne-doc-smith/issues/120)) ([434f161](https://github.com/AIGNE-io/aigne-doc-smith/commit/434f161ab7dd989d57ca670f36d0828c09abe38a))
 
 ## [0.8.10-beta.1](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.10-beta...v0.8.10-beta.1) (2025-09-18)
@@ -87,7 +107,7 @@
 
 ### Features
 
-* support document structure review workflow ([#117](https://github.com/AIGNE-io/aigne-doc-smith/issues/117)) ([ec7ae80](https://github.com/AIGNE-io/aigne-doc-smith/commit/ec7ae80b26a1b66928bddef7ac401f633a0f5a2b))
+* support documentation structure review workflow ([#117](https://github.com/AIGNE-io/aigne-doc-smith/issues/117)) ([ec7ae80](https://github.com/AIGNE-io/aigne-doc-smith/commit/ec7ae80b26a1b66928bddef7ac401f633a0f5a2b))
 
 
 ### Bug Fixes

package/README.md

@@ -45,7 +45,7 @@ As shown in the diagram, DocSmith integrates seamlessly with other [AIGNE](https
 
 - **AIGNE Hub Integration**: Use [AIGNE Hub](https://www.aigne.io/en/hub) without API keys, switch between Google Gemini, OpenAI GPT, Claude, and more
 - **Multiple LLM Support**: Bring your own API keys for OpenAI, Anthropic, Google, and other providers
-- **Discuss Kit Publishing**: Deploy to [docsmith.aigne.io](https://docsmith.aigne.io/app/) or your own [Discuss Kit](https://www.web3kit.rocks/discuss-kit) instance
+- **One-Click Publishing**: Make your docs live and generate shareable links for your team - publish to [docsmith.aigne.io](https://docsmith.aigne.io/app/) or your own [Discuss Kit](https://www.web3kit.rocks/discuss-kit) instance
 
 ### 🔄 Smart Updates
 
@@ -107,7 +107,7 @@ DocSmith supports multiple AI providers:
 ```bash
 # Switch models effortlessly
 aigne doc generate --model google:gemini-2.5-pro
-aigne doc generate --model claude:claude-3-5-sonnet
+aigne doc generate --model anthropic:claude-sonnet-4-5
 aigne doc generate --model openai:gpt-4o
 ```
 

package/agents/clear/choose-contents.mjs

@@ -5,8 +5,8 @@ const TARGET_METADATA = {
     agent: "clearGeneratedDocs",
   },
   documentStructure: {
-    label: "document structure",
-    description: "Delete the document structure and all generated documents.",
+    label: "documentation structure",
+    description: "Delete the documentation structure and all generated documents.",
     agent: "clearDocumentStructure",
   },
   documentConfig: {

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

@@ -20,8 +20,8 @@ export default async function clearDocumentStructure(input = {}, _options = {})
 
     const structureDisplayPath = toDisplayPath(structurePlanPath);
     const structureMessage = structureExists
-      ? `Cleared document structure plan (${structureDisplayPath})`
-      : `Document structure plan already empty (${structureDisplayPath})`;
+      ? `Cleared documentation structure (${structureDisplayPath})`
+      : `Documentation structure already empty (${structureDisplayPath})`;
 
     results.push({
       type: "structure",
@@ -33,7 +33,7 @@ export default async function clearDocumentStructure(input = {}, _options = {})
     results.push({
       type: "structure",
       error: true,
-      message: `Failed to clear document structure plan: ${error.message}`,
+      message: `Failed to clear documentation structure: ${error.message}`,
     });
   }
 
@@ -69,11 +69,11 @@ export default async function clearDocumentStructure(input = {}, _options = {})
 
   let header;
   if (errorItems > 0) {
-    header = "Document structure cleanup finished with some issues.";
+    header = "Documentation Structure cleanup finished with some issues.";
   } else if (clearedItems > 0) {
-    header = "Document structure cleared successfully!";
+    header = "Documentation Structure cleared successfully!";
   } else {
-    header = "Document structure already empty.";
+    header = "Documentation Structure already empty.";
   }
 
   const detailLines = results.map((item) => `- ${item.message}`).join("\n");
@@ -101,6 +101,6 @@ clearDocumentStructure.input_schema = {
   },
 };
 
-clearDocumentStructure.taskTitle = "Clear document structure and all generated documents";
+clearDocumentStructure.taskTitle = "Clear documentation structure and all generated documents";
 clearDocumentStructure.description =
-  "Clear the document structure plan (structure-plan.json) and optionally the documents directory";
+  "Clear the documentation structure (structure-plan.json) and optionally the documents directory";

package/agents/clear/index.yaml

@@ -2,7 +2,7 @@ type: team
 name: clear
 alias:
   - clear
-description: Clear various types of data including document structure, generated documents, configuration, and authorization tokens
+description: Clear various types of data including documentation structure, generated documents, configuration, and authorization tokens
 skills:
   - url: ../init/index.mjs
     default_input:

package/agents/evaluate/document-structure.yaml

@@ -11,7 +11,7 @@ input_schema:
   properties:
     documentStructureYaml:
       type: string
-      description: Document structure planning
+      description: Documentation structure data
     purposes:
       type: string
       description: User-selected document goals

package/agents/generate/check-document-structure.yaml

@@ -1,5 +1,5 @@
 name: checkDocumentStructure
-description: Check the Document Structure to ensure it meets expectations, especially in scenarios with previous generation results and user feedback.
+description: Check the Documentation Structure to ensure it meets expectations, especially in scenarios with previous generation results and user feedback.
 instructions:
   url: ../../prompts/structure/check-document-structure.md
 input_schema:
@@ -7,10 +7,10 @@ input_schema:
   properties:
     documentStructure:
       $ref: ../schema/document-structure.yaml
-      description: Newly generated document structure.
+      description: Newly generated documentation structure.
     originalDocumentStructure:
       $ref: ../schema/document-structure.yaml
-      description: Previous generation's document structure for comparison. If it doesn't exist, the check passes by default.
+      description: Previous generation's documentation structure for comparison. If it doesn't exist, the check passes by default.
     feedback:
       type: string
       description: User feedback provided for the previous generation's results.

package/agents/generate/check-need-generate-structure.mjs

@@ -18,10 +18,10 @@ export default async function checkNeedGenerateStructure(
   if (!originalDocumentStructure) {
     const choice = await options.prompts.select({
       message:
-        "Your project configuration is complete. Would you like to generate the document structure now?",
+        "Your project configuration is complete. Would you like to generate the documentation structure now?",
       choices: [
         {
-          name: "Generate now - Start generating the document structure",
+          name: "Generate now - Start generating the documentation structure",
           value: "generate",
         },
         {
@@ -49,7 +49,7 @@ export default async function checkNeedGenerateStructure(
     }
   }
 
-  // Check if we need to regenerate document structure
+  // Check if we need to regenerate documentation structure
   let shouldRegenerate = false;
   let finalFeedback = feedback;
 
@@ -82,7 +82,7 @@ export default async function checkNeedGenerateStructure(
       finalFeedback = `
       ${finalFeedback || ""}
 
-      Update document structure based on the latest DataSources:
+      Update documentation structure based on the latest DataSources:
         1. For new content, add new sections as needed or supplement existing section displays
         2. Be cautious when deleting sections, unless all associated sourceIds have been removed
         3. Do not modify the path of existing sections
@@ -97,11 +97,11 @@ export default async function checkNeedGenerateStructure(
     finalFeedback = `
     ${finalFeedback || ""}
 
-    User requested forced regeneration of document structure. Please regenerate based on the latest Data Sources and user requirements, **allowing any modifications**.
+    User requested forced regeneration of documentation structure. Please regenerate based on the latest Data Sources and user requirements, **allowing any modifications**.
     `;
   }
 
-  // If no regeneration needed, return original document structure
+  // If no regeneration needed, return original documentation structure
   if (originalDocumentStructure && !finalFeedback && !shouldRegenerate) {
     return {
       documentStructure: originalDocumentStructure,
@@ -110,7 +110,7 @@ export default async function checkNeedGenerateStructure(
 
   const planningAgent = options.context.agents["refineDocumentStructure"];
 
-  // Get user preferences for document structure and global scope
+  // Get user preferences for documentation structure and global scope
   const structureRules = getActiveRulesForScope("structure", []);
   const globalRules = getActiveRulesForScope("global", []);
 
@@ -185,4 +185,4 @@ export default async function checkNeedGenerateStructure(
   };
 }
 
-checkNeedGenerateStructure.taskTitle = "Check if document structure needs generate or update";
+checkNeedGenerateStructure.taskTitle = "Check if documentation structure needs generate or update";

package/agents/generate/document-structure-tools/add-document.mjs

@@ -4,32 +4,47 @@ import {
   validateAddDocumentInput,
 } from "../../../types/document-structure-schema.mjs";
 
-export default async function addDocument(input) {
+export default async function addDocument(input, options) {
   // Validate input using Zod schema
   const validation = validateAddDocumentInput(input);
   if (!validation.success) {
-    console.log(`⚠️  Cannot add document: ${validation.error}`);
-    return { documentStructure: input.documentStructure };
+    const errorMessage = `Cannot add document: ${validation.error}`;
+    console.log(`⚠️  ${errorMessage}`);
+    return {
+      documentStructure: input.documentStructure,
+      error: { message: errorMessage },
+    };
   }
 
-  const { documentStructure, title, description, path, parentId, sourceIds } = validation.data;
+  const { title, description, path, parentId, sourceIds } = validation.data;
+  let documentStructure = options?.context?.userContext?.currentStructure;
+
+  if (!documentStructure) {
+    documentStructure = input.documentStructure;
+  }
 
   // Validate parent exists if parentId is provided
   if (parentId && parentId !== "null") {
     const parentExists = documentStructure.some((item) => item.path === parentId);
     if (!parentExists) {
-      console.log(`⚠️  Cannot add document: Parent document '${parentId}' not found.`);
-      return { documentStructure };
+      const errorMessage = `Cannot add document: Parent document '${parentId}' not found.`;
+      console.log(`⚠️  ${errorMessage}`);
+      return {
+        documentStructure,
+        error: { message: errorMessage },
+      };
     }
   }
 
   // Check if document with same path already exists
   const existingDocument = documentStructure.find((item) => item.path === path);
   if (existingDocument) {
-    console.log(
-      `⚠️  Cannot add document: A document with path '${path}' already exists. Choose a different path.`,
-    );
-    return { documentStructure };
+    const errorMessage = `Cannot add document: A document with path '${path}' already exists. Choose a different path.`;
+    console.log(`⚠️  ${errorMessage}`);
+    return {
+      documentStructure,
+      error: { message: errorMessage },
+    };
   }
 
   // Create new document object
@@ -41,16 +56,26 @@ export default async function addDocument(input) {
     sourceIds: [...sourceIds], // Create a copy of the array
   };
 
-  // Add the new document to the document structure
+  // Add the document to the structure
   const updatedStructure = [...documentStructure, newDocument];
 
+  const successMessage = `addDocument executed successfully.
+  Successfully added document '${title}' with path '${path}'.
+  Check if the latest version of documentStructure meets user feedback, if so, just return 'success'.`;
+
+  // update shared document structure
+  if (options?.context?.userContext) {
+    options.context.userContext.currentStructure = updatedStructure;
+  }
+
   return {
     documentStructure: updatedStructure,
+    message: successMessage,
     addedDocument: newDocument,
   };
 }
 
-addDocument.taskTitle = "Add new document";
-addDocument.description = "Add a new document to the document structure";
+addDocument.taskTitle = "Add document";
+addDocument.description = "Add a document to the documentation structure";
 addDocument.inputSchema = getAddDocumentInputJsonSchema();
 addDocument.outputSchema = getAddDocumentOutputJsonSchema();

package/agents/generate/document-structure-tools/delete-document.mjs

@@ -4,23 +4,34 @@ import {
   validateDeleteDocumentInput,
 } from "../../../types/document-structure-schema.mjs";
 
-export default async function deleteDocument(input) {
+export default async function deleteDocument(input, options) {
   // Validate input using Zod schema
   const validation = validateDeleteDocumentInput(input);
   if (!validation.success) {
-    console.log(`⚠️  Cannot delete document: ${validation.error}`);
-    return { documentStructure: input.documentStructure };
+    const errorMessage = `Cannot delete document: ${validation.error}`;
+    console.log(`⚠️  ${errorMessage}`);
+    return {
+      documentStructure: input.documentStructure,
+      error: { message: errorMessage },
+    };
   }
 
-  const { documentStructure, path } = validation.data;
+  const { path } = validation.data;
+  let documentStructure = options?.context?.userContext?.currentStructure;
+
+  if (!documentStructure) {
+    documentStructure = input.documentStructure;
+  }
 
   // Find the document to delete
   const documentIndex = documentStructure.findIndex((item) => item.path === path);
   if (documentIndex === -1) {
-    console.log(
-      `⚠️  Cannot delete document: Document '${path}' does not exist. Please choose an existing document to delete.`,
-    );
-    return { documentStructure };
+    const errorMessage = `Cannot delete document: Document '${path}' does not exist. Please choose an existing document to delete.`;
+    console.log(`⚠️  ${errorMessage}`);
+    return {
+      documentStructure,
+      error: { message: errorMessage },
+    };
   }
 
   const documentToDelete = documentStructure[documentIndex];
@@ -28,22 +39,34 @@ export default async function deleteDocument(input) {
   // Check if any other documents have this document as parent
   const childDocuments = documentStructure.filter((item) => item.parentId === path);
   if (childDocuments.length > 0) {
-    console.log(
-      `⚠️  Cannot delete document: Document '${path}' has ${childDocuments.length} child document(s): ${childDocuments.map((p) => p.path).join(", ")}. Please first move or delete these child documents.`,
-    );
-    return { documentStructure };
+    const errorMessage = `Cannot delete document: Document '${path}' has ${childDocuments.length} child document(s): ${childDocuments.map((p) => p.path).join(", ")}. Please first move or delete these child documents.`;
+    console.log(`⚠️  ${errorMessage}`);
+    return {
+      documentStructure,
+      error: { message: errorMessage },
+    };
   }
 
-  // Remove the document from the document structure
+  // Remove the document from the structure
   const updatedStructure = documentStructure.filter((_, index) => index !== documentIndex);
 
+  const successMessage = `deleteDocument executed successfully.
+  Successfully deleted document '${documentToDelete.title}' with path '${path}'.
+  Check if the latest version of documentStructure meets user feedback, if so, just return 'success'.`;
+
+  // update shared document structure
+  if (options?.context?.userContext) {
+    options.context.userContext.currentStructure = updatedStructure;
+  }
+
   return {
     documentStructure: updatedStructure,
+    message: successMessage,
     deletedDocument: documentToDelete,
   };
 }
 
 deleteDocument.taskTitle = "Delete document";
-deleteDocument.description = "Delete a document from the document structure";
+deleteDocument.description = "Remove a document from the documentation structure";
 deleteDocument.inputSchema = getDeleteDocumentInputJsonSchema();
 deleteDocument.outputSchema = getDeleteDocumentOutputJsonSchema();

package/agents/generate/document-structure-tools/move-document.mjs

@@ -4,23 +4,34 @@ import {
   validateMoveDocumentInput,
 } from "../../../types/document-structure-schema.mjs";
 
-export default async function moveDocument(input) {
+export default async function moveDocument(input, options) {
   // Validate input using Zod schema
   const validation = validateMoveDocumentInput(input);
   if (!validation.success) {
-    console.log(`Error: Cannot move document - ${validation.error}`);
-    return { documentStructure: input.documentStructure };
+    const errorMessage = `Cannot move document: ${validation.error}`;
+    console.log(`⚠️  ${errorMessage}`);
+    return {
+      documentStructure: input.documentStructure,
+      error: { message: errorMessage },
+    };
   }
 
-  const { documentStructure, path, newParentId } = validation.data;
+  const { path, newParentId } = validation.data;
+  let documentStructure = options?.context?.userContext?.currentStructure;
+
+  if (!documentStructure) {
+    documentStructure = input.documentStructure;
+  }
 
   // Find the document to move
   const documentIndex = documentStructure.findIndex((item) => item.path === path);
   if (documentIndex === -1) {
-    console.log(
-      `Error: Cannot move document - Document '${path}' does not exist. Please select an existing document to move.`,
-    );
-    return { documentStructure };
+    const errorMessage = `Cannot move document: Document '${path}' does not exist. Please select an existing document to move.`;
+    console.log(`⚠️  ${errorMessage}`);
+    return {
+      documentStructure,
+      error: { message: errorMessage },
+    };
   }
 
   const documentToMove = documentStructure[documentIndex];
@@ -34,10 +45,12 @@ export default async function moveDocument(input) {
   ) {
     const newParentExists = documentStructure.some((item) => item.path === newParentId);
     if (!newParentExists) {
-      console.log(
-        `Error: Cannot move document - Target parent document '${newParentId}' does not exist. Please select an existing parent document.`,
-      );
-      return { documentStructure };
+      const errorMessage = `Cannot move document: Target parent document '${newParentId}' does not exist. Please select an existing parent document.`;
+      console.log(`⚠️  ${errorMessage}`);
+      return {
+        documentStructure,
+        error: { message: errorMessage },
+      };
     }
 
     // Check for circular dependency: the new parent cannot be a descendant of the document being moved
@@ -52,10 +65,12 @@ export default async function moveDocument(input) {
     };
 
     if (isDescendant(path, newParentId)) {
-      console.log(
-        `Error: Cannot move document - Moving '${path}' under '${newParentId}' would create an invalid hierarchy. Please select a parent that is not nested under the document being moved.`,
-      );
-      return { documentStructure };
+      const errorMessage = `Cannot move document: Moving '${path}' under '${newParentId}' would create an invalid hierarchy. Please select a parent that is not nested under the document being moved.`;
+      console.log(`⚠️  ${errorMessage}`);
+      return {
+        documentStructure,
+        error: { message: errorMessage },
+      };
     }
   }
 
@@ -65,18 +80,30 @@ export default async function moveDocument(input) {
     parentId: newParentId || null,
   };
 
-  // Update the document structure
+  // Update the document's position in the structure
   const updatedStructure = [...documentStructure];
   updatedStructure[documentIndex] = updatedDocument;
 
+  const newParentText = newParentId ? `'${newParentId}'` : "root level";
+  const successMessage = `moveDocument executed successfully.
+  Successfully moved document '${documentToMove.title}' to ${newParentText}.
+  Check if the latest version of documentStructure meets user feedback, if so, just return 'success'.`;
+
+  // update shared document structure
+  if (options?.context?.userContext) {
+    options.context.userContext.currentStructure = updatedStructure;
+  }
+
   return {
     documentStructure: updatedStructure,
+    message: successMessage,
     originalDocument: documentToMove,
-    updatedDocument,
+    updatedDocument: updatedDocument,
   };
 }
 
 moveDocument.taskTitle = "Move document";
-moveDocument.description = "Move a document to a different parent in the document structure";
+moveDocument.description =
+  "Relocate a document to a different parent in the documentation structure";
 moveDocument.inputSchema = getMoveDocumentInputJsonSchema();
 moveDocument.outputSchema = getMoveDocumentOutputJsonSchema();

package/agents/generate/document-structure-tools/update-document.mjs

@@ -4,23 +4,34 @@ import {
   validateUpdateDocumentInput,
 } from "../../../types/document-structure-schema.mjs";
 
-export default async function updateDocument(input) {
+export default async function updateDocument(input, options) {
   // Validate input using Zod schema
   const validation = validateUpdateDocumentInput(input);
   if (!validation.success) {
-    console.log(`⚠️  Cannot update document: ${validation.error}`);
-    return { documentStructure: input.documentStructure };
+    const errorMessage = `Cannot update document: ${validation.error}`;
+    console.log(`⚠️  ${errorMessage}`);
+    return {
+      documentStructure: input.documentStructure,
+      error: { message: errorMessage },
+    };
   }
 
-  const { documentStructure, path, title, description, sourceIds } = validation.data;
+  const { path, title, description, sourceIds } = validation.data;
+  let documentStructure = options?.context?.userContext?.currentStructure;
+
+  if (!documentStructure) {
+    documentStructure = input.documentStructure;
+  }
 
   // Find the document to update
   const documentIndex = documentStructure.findIndex((item) => item.path === path);
   if (documentIndex === -1) {
-    console.log(
-      `⚠️  Cannot update document: Document '${path}' does not exist. Choose an existing document to update.`,
-    );
-    return { documentStructure };
+    const errorMessage = `Cannot update document: Document '${path}' does not exist. Choose an existing document to update.`;
+    console.log(`⚠️  ${errorMessage}`);
+    return {
+      documentStructure,
+      error: { message: errorMessage },
+    };
   }
 
   const originalDocument = documentStructure[documentIndex];
@@ -33,18 +44,34 @@ export default async function updateDocument(input) {
     ...(sourceIds !== undefined && { sourceIds: [...sourceIds] }), // Create a copy of the array
   };
 
-  // Update the document structure
+  // Update the document in the structure
   const updatedStructure = [...documentStructure];
   updatedStructure[documentIndex] = updatedDocument;
 
+  const updates = [];
+  if (title !== undefined) updates.push(`title to '${title}'`);
+  if (description !== undefined) updates.push("description");
+  if (sourceIds !== undefined) updates.push("sourceIds");
+  const updatesText = updates.length > 0 ? updates.join(", ") : "properties";
+
+  const successMessage = `updateDocument executed successfully.
+  Successfully updated ${updatesText} for document '${path}'.
+  Check if the latest version of documentStructure meets user feedback, if so, just return 'success'.`;
+
+  // update shared document structure
+  if (options?.context?.userContext) {
+    options.context.userContext.currentStructure = updatedStructure;
+  }
+
   return {
     documentStructure: updatedStructure,
-    originalDocument,
-    updatedDocument,
+    message: successMessage,
+    originalDocument: originalDocument,
+    updatedDocument: updatedDocument,
   };
 }
 
 updateDocument.taskTitle = "Update document";
-updateDocument.description = "Update properties of an existing document in the document structure";
+updateDocument.description = "Modify properties of a document in the documentation structure";
 updateDocument.inputSchema = getUpdateDocumentInputJsonSchema();
 updateDocument.outputSchema = getUpdateDocumentOutputJsonSchema();

package/agents/generate/generate-structure.yaml

@@ -13,7 +13,7 @@ input_schema:
       description: Primary language for documentation (e.g., zh, en, ja)
     datasources:
       type: string
-      description: Project content and context to help generate document structure
+      description: Project content and context to help generate documentation structure
     targetAudience:
       type: string
       description: Target audience for the documentation

package/agents/generate/update-document-structure.yaml

@@ -1,6 +1,6 @@
 type: ai
 name: updateDocumentStructure
-description: Update document structure based on user feedback and intentions using structure modification tools
+description: Update documentation structure based on user feedback and intentions using structure modification tools
 instructions:
   url: ../../prompts/structure/update-document-structure.md
 input_schema:
@@ -15,7 +15,7 @@ input_schema:
       description: User language, e.g. zh, en
     datasources:
       type: string
-      description: Context for document structure
+      description: Context for documentation structure
     glossary:
       type: string
       description: Glossary of terms
@@ -28,13 +28,7 @@ input_schema:
   required:
     - documentStructure
     - feedback
-output_schema:
-  type: object
-  properties:
-    documentStructure: ../schema/document-structure.yaml
-    operationSummary:
-      type: string
-      description: Summary of the operations performed on the document structure
+output_key: message
 skills:
   - ./document-structure-tools/add-document.mjs
   - ./document-structure-tools/delete-document.mjs