@aigne/doc-smith 0.8.11-beta.4 → 0.8.11-beta.6

package/tests/agents/publish/publish-docs.test.mjs

@@ -15,6 +15,7 @@ import publishDocs from "../../../agents/publish/publish-docs.mjs";
 import * as authUtils from "../../../utils/auth-utils.mjs";
 import * as d2Utils from "../../../utils/d2-utils.mjs";
 import * as utils from "../../../utils/utils.mjs";
+import * as deployUtils from "../../../utils/deploy.mjs";
 
 // Mock all external dependencies
 const mockPublishDocs = {
@@ -51,6 +52,7 @@ describe("publish-docs", () => {
   let getGithubRepoUrlSpy;
   let loadConfigFromFileSpy;
   let saveValueToConfigSpy;
+  let deploySpy;
 
   beforeAll(() => {
     // Apply mocks for external dependencies only
@@ -98,6 +100,10 @@ describe("publish-docs", () => {
     );
     loadConfigFromFileSpy = spyOn(utils, "loadConfigFromFile").mockResolvedValue({});
     saveValueToConfigSpy = spyOn(utils, "saveValueToConfig").mockResolvedValue();
+    deploySpy = spyOn(deployUtils, "deploy").mockResolvedValue({
+      appUrl: "https://deployed.example.com",
+      token: "deploy-token",
+    });
 
     mockOptions = {
       prompts: {
@@ -125,6 +131,7 @@ describe("publish-docs", () => {
     getGithubRepoUrlSpy?.mockRestore();
     loadConfigFromFileSpy?.mockRestore();
     saveValueToConfigSpy?.mockRestore();
+    deploySpy?.mockRestore();
   });
 
   // BASIC FUNCTIONALITY TESTS
@@ -593,6 +600,98 @@ describe("publish-docs", () => {
     expect(mockOptions.prompts.select).not.toHaveBeenCalled();
   });
 
+  // RESUME PREVIOUS WEBSITE SETUP TESTS
+  test("should show resume option when checkoutId exists in config", async () => {
+    loadConfigFromFileSpy.mockResolvedValue({
+      checkoutId: "cached-checkout-123",
+    });
+    mockOptions.prompts.select.mockResolvedValue("default");
+
+    await publishDocs(
+      {
+        docsDir: "./docs",
+        appUrl: "https://docsmith.aigne.io",
+      },
+      mockOptions,
+    );
+
+    expect(mockOptions.prompts.select).toHaveBeenCalledWith(
+      expect.objectContaining({
+        message: "Select platform to publish your documents:",
+        choices: expect.arrayContaining([
+          expect.objectContaining({
+            name: expect.stringContaining("Resume previous website setup"),
+            value: "new-instance-continue",
+          }),
+        ]),
+      }),
+    );
+
+    // Verify the exact text content
+    const selectCall = mockOptions.prompts.select.mock.calls[0][0];
+    const resumeChoice = selectCall.choices.find(
+      (choice) => choice.value === "new-instance-continue",
+    );
+    expect(resumeChoice.name).toContain("Resume previous website setup");
+    expect(resumeChoice.name).toContain("Already paid.");
+    expect(resumeChoice.name).toContain(
+      "Continue where you left off. Your payment has already been processed.",
+    );
+  });
+
+  test("should not show resume option when no checkoutId in config", async () => {
+    loadConfigFromFileSpy.mockResolvedValue({});
+    mockOptions.prompts.select.mockResolvedValue("default");
+
+    await publishDocs(
+      {
+        docsDir: "./docs",
+        appUrl: "https://docsmith.aigne.io",
+      },
+      mockOptions,
+    );
+
+    expect(mockOptions.prompts.select).toHaveBeenCalledWith(
+      expect.objectContaining({
+        message: "Select platform to publish your documents:",
+        choices: expect.not.arrayContaining([
+          expect.objectContaining({
+            value: "new-instance-continue",
+          }),
+        ]),
+      }),
+    );
+  });
+
+  test("should handle resume previous website setup selection", async () => {
+    deploySpy.mockResolvedValue({
+      appUrl: "https://resumed.example.com",
+      token: "resume-token",
+    });
+
+    loadConfigFromFileSpy.mockResolvedValue({
+      checkoutId: "cached-checkout-123",
+      paymentUrl: "https://payment.example.com",
+    });
+    mockOptions.prompts.select.mockResolvedValue("new-instance-continue");
+
+    const consoleSpy = spyOn(console, "log").mockImplementation(() => {});
+
+    await publishDocs(
+      {
+        docsDir: "./docs",
+        appUrl: "https://docsmith.aigne.io",
+      },
+      mockOptions,
+    );
+
+    expect(consoleSpy).toHaveBeenCalledWith("\nResuming your previous website setup...");
+    expect(deploySpy).toHaveBeenCalledWith("cached-checkout-123", "https://payment.example.com");
+    expect(getAccessTokenSpy).toHaveBeenCalledWith("https://resumed.example.com", "resume-token");
+
+    consoleSpy.mockRestore();
+  });
+
   test("should handle URL validation edge cases", async () => {
     loadConfigFromFileSpy.mockResolvedValue({});
     mockOptions.prompts.select.mockResolvedValue("custom");

package/tests/agents/update/check-document.test.mjs

@@ -177,7 +177,7 @@ describe("check-document", () => {
     expect(mockOptions.context.invoke).not.toHaveBeenCalled();
   });
 
-  test("should handle missing original node in document structure", async () => {
+  test("should handle missing original node in documentation structure", async () => {
     accessSpy.mockResolvedValue();
     checkDetailResultSpy.mockResolvedValue({ isApproved: true });
 

package/tests/agents/utils/check-detail-result.test.mjs

@@ -229,7 +229,7 @@ set -euo pipefail
 function deploy_app() {
     local app_name="$1"
     local version="$2"
-    
+
     echo "Deploying $app_name version $version"
     docker run --rm "$app_name:$version"
 }
@@ -337,19 +337,6 @@ This document demonstrates various programming language code blocks.`;
     });
   });
 
-  describe("D2 syntax validation", () => {
-    test("should handle D2 syntax errors", async () => {
-      const documentStructure = [];
-      const reviewContent =
-        "```d2\n" +
-        "invalid d2 syntax {{\n" + // Malformed D2
-        "```\n\n" +
-        "This has proper structure.";
-      const result = await checkDetailResult({ documentStructure, reviewContent });
-      expect(result.isApproved).toBe(false);
-    });
-  });
-
   describe("Advanced table edge cases", () => {
     test("should handle empty table cells correctly", async () => {
       const documentStructure = [];
@@ -660,7 +647,7 @@ flowchart TD
     A["1. Create Backend Implementation<br>api/src/providers/"]
     B["2. Add Backend Configuration<br>api/src/providers/models.ts"]
     C["3. Update Frontend Selector<br>src/pages/config/ai-providers/"]
-    
+
     A --> B --> C
 \`\`\`
 

package/tests/agents/utils/format-document-structure.test.mjs

@@ -104,7 +104,7 @@ describe("format-document-structure", () => {
   });
 
   // BASIC FUNCTIONALITY TESTS
-  test("should format empty document structure", async () => {
+  test("should format empty documentation structure", async () => {
     const result = await formatDocumentStructure({
       documentStructure: [],
     });
@@ -121,7 +121,7 @@ describe("format-document-structure", () => {
     });
   });
 
-  test("should format single item document structure", async () => {
+  test("should format single item documentation structure", async () => {
     const documentStructure = [
       {
         title: "Getting Started",
@@ -152,7 +152,7 @@ describe("format-document-structure", () => {
     expect(result.documentStructureYaml).toBe(expectedYaml);
   });
 
-  test("should format multiple items document structure", async () => {
+  test("should format multiple items documentation structure", async () => {
     const documentStructure = [
       {
         title: "API Reference",
@@ -321,7 +321,7 @@ describe("format-document-structure", () => {
     expect(result.documentStructure).toEqual(documentStructure);
   });
 
-  test("should return both yaml string and original document structure", async () => {
+  test("should return both yaml string and original documentation structure", async () => {
     const documentStructure = [
       {
         title: "Return Test",
@@ -339,7 +339,7 @@ describe("format-document-structure", () => {
     expect(result.documentStructure).toBe(documentStructure); // Should be the same reference
   });
 
-  test("should preserve original document structure unchanged", async () => {
+  test("should preserve original documentation structure unchanged", async () => {
     const originalDocumentStructure = [
       {
         title: "Original",

package/tests/agents/utils/load-sources.test.mjs

@@ -1030,8 +1030,8 @@ describe("load-sources", () => {
     });
   });
 
-  describe("Document path and document structure handling", () => {
-    test("should load existing document structure", async () => {
+  describe("Document path and documentation structure handling", () => {
+    test("should load existing documentation structure", async () => {
       const documentStructure = {
         sections: ["Introduction", "API", "Examples"],
         lastUpdated: new Date().toISOString(),
@@ -1050,7 +1050,7 @@ describe("load-sources", () => {
       expect(result.originalDocumentStructure).toEqual(documentStructure);
     });
 
-    test("should handle malformed document structure JSON", async () => {
+    test("should handle malformed documentation structure JSON", async () => {
       await writeFile(path.join(tempDir, "structure-plan.json"), "{ invalid json content");
 
       const result = await loadSources({
@@ -1064,7 +1064,7 @@ describe("load-sources", () => {
       expect(result.originalDocumentStructure).toBeUndefined();
     });
 
-    test("should handle non-ENOENT errors when reading document structure JSON", async () => {
+    test("should handle non-ENOENT errors when reading documentation structure JSON", async () => {
       // Import fs promises module to spy on
       const fsPromises = await import("node:fs/promises");
 

package/tests/agents/utils/save-docs.test.mjs

@@ -52,7 +52,7 @@ describe("save-docs", () => {
     expect(initialFiles).toContain("getting-started.md");
     expect(initialFiles).toContain("old-file.md");
 
-    // Test document structure
+    // Test documentation structure
     const documentStructure = [
       {
         path: "/overview",

package/tests/utils/auth-utils.test.mjs

@@ -336,7 +336,7 @@ describe("auth-utils", () => {
 
     // Test that openPage calls the mock open function
     await capturedOpenPage("https://auth.example.com");
-    expect(mockOpen).toHaveBeenCalledWith("https://auth.example.com/");
+    expect(mockOpen).toHaveBeenCalledWith("https://auth.example.com/?required_roles=owner%2Cadmin");
   });
 
   test("should handle authorization failure", async () => {

package/tests/utils/conflict-detector.test.mjs

@@ -309,7 +309,7 @@ describe("conflict-detector", () => {
 
       // Should include conflict resolution rules in final rules
       expect(result.rules).toContain("=== Conflict Resolution Guidelines ===");
-      expect(result.rules).toContain("Create layered document structure");
+      expect(result.rules).toContain("Create layered documentation structure");
       expect(result.rules).toContain("Create separate user paths");
 
       // Should also include regular configuration content with enhanced format

package/tests/utils/d2-utils.test.mjs

@@ -6,7 +6,7 @@ import path from "node:path";
 
 import Debug from "debug";
 
-import { TMP_ASSETS_DIR } from "../../utils/constants/index.mjs";
+import { DOC_SMITH_DIR, TMP_ASSETS_DIR, TMP_DIR } from "../../utils/constants/index.mjs";
 import {
   beforePublishHook,
   checkContent,
@@ -346,7 +346,7 @@ E -> F
       try {
         await checkContent({ content });
 
-        const assetDir = path.join(process.cwd(), ".aigne", "doc-smith", ".tmp", "assets", "d2");
+        const assetDir = path.join(process.cwd(), DOC_SMITH_DIR, TMP_DIR, TMP_ASSETS_DIR, "d2");
         const files = await readdir(assetDir);
         const d2File = files.find((file) => file.endsWith(".d2"));
         expect(d2File).toBeDefined();
@@ -365,7 +365,7 @@ E -> F
       try {
         await ensureTmpDir();
 
-        const tmpDir = path.join(tempDir, ".aigne", "doc-smith", ".tmp");
+        const tmpDir = path.join(tempDir, DOC_SMITH_DIR, TMP_DIR);
         const gitignorePath = path.join(tmpDir, ".gitignore");
 
         expect(existsSync(tmpDir)).toBe(true);
@@ -386,7 +386,7 @@ E -> F
         // First call
         await ensureTmpDir();
 
-        const tmpDir = path.join(tempDir, ".aigne", "doc-smith", ".tmp");
+        const tmpDir = path.join(tempDir, DOC_SMITH_DIR, TMP_DIR);
         const gitignorePath = path.join(tmpDir, ".gitignore");
 
         // Modify .gitignore to test if it gets overwritten

package/tests/utils/deploy.test.mjs

@@ -91,15 +91,8 @@ describe("deploy", () => {
 
     // Verify BrokerClient was constructed with correct config
     expect(mockBrokerClientConstructor).toHaveBeenCalledWith({
-      baseUrl: "",
       authToken: "mock-auth-token",
-      paymentLinkKey: "PAYMENT_LINK_ID",
-      timeout: 300000,
-      polling: {
-        interval: 3000,
-        maxAttempts: 100,
-        backoffStrategy: "linear",
-      },
+      baseUrl: "https://docsmith.aigne.io",
     });
 
     // Verify deploy was called with correct parameters
@@ -120,7 +113,6 @@ describe("deploy", () => {
           ACCESS_PREPARING: expect.any(Function),
           ACCESS_READY: expect.any(Function),
         }),
-        onError: expect.any(Function),
       }),
     );
 
@@ -348,7 +340,8 @@ describe("deploy", () => {
     // Verify BrokerClient was constructed with empty baseUrl
     expect(mockBrokerClientConstructor).toHaveBeenCalledWith(
       expect.objectContaining({
-        baseUrl: "",
+        authToken: "mock-auth-token",
+        baseUrl: "https://docsmith.aigne.io",
       }),
     );
   });

package/tests/utils/docs-finder-utils.test.mjs

@@ -125,7 +125,7 @@ describe("docs-finder-utils", () => {
       expect(result).toBeUndefined();
     });
 
-    test("should handle empty document structure", () => {
+    test("should handle empty documentation structure", () => {
       const result = findItemByFlatName([], "any-name");
       expect(result).toBeUndefined();
     });
@@ -243,7 +243,7 @@ describe("docs-finder-utils", () => {
       expect(result).toEqual(["guide.zh.md", "overview.zh.md"]);
     });
 
-    test("should sort files by document structure order", async () => {
+    test("should sort files by documentation structure order", async () => {
       readdirSpy.mockResolvedValue(["guide.md", "overview.md", "advanced.md"]);
 
       const documentStructure = [{ path: "/overview" }, { path: "/guide" }, { path: "/advanced" }];
@@ -253,7 +253,7 @@ describe("docs-finder-utils", () => {
       expect(result).toEqual(["overview.md", "guide.md", "advanced.md"]);
     });
 
-    test("should handle files not in document structure", async () => {
+    test("should handle files not in documentation structure", async () => {
       readdirSpy.mockResolvedValue(["guide.md", "extra.md", "overview.md"]);
 
       const documentStructure = [{ path: "/overview" }, { path: "/guide" }];
@@ -480,7 +480,7 @@ describe("docs-finder-utils", () => {
       ]);
     });
 
-    test("should warn for files not in document structure", async () => {
+    test("should warn for files not in documentation structure", async () => {
       readFileSpy.mockResolvedValue("content");
 
       const selectedFiles = ["unknown.md"];
@@ -488,7 +488,7 @@ describe("docs-finder-utils", () => {
 
       expect(result).toEqual([]);
       expect(consoleWarnSpy).toHaveBeenCalledWith(
-        "⚠️  No document structure item found for file: unknown.md",
+        "⚠️  No documentation structure item found for file: unknown.md",
       );
     });
 
@@ -508,7 +508,7 @@ describe("docs-finder-utils", () => {
         },
       ]);
       expect(consoleWarnSpy).toHaveBeenCalledWith(
-        "⚠️  No document structure item found for file: unknown.md",
+        "⚠️  No documentation structure item found for file: unknown.md",
       );
     });
 
@@ -623,14 +623,14 @@ describe("docs-finder-utils", () => {
       await expect(getMainLanguageFiles("/denied", "en")).rejects.toThrow("Permission denied");
     });
 
-    test("processSelectedFiles should handle empty document structure", async () => {
+    test("processSelectedFiles should handle empty documentation structure", async () => {
       readFileSpy.mockResolvedValue("content");
 
       const result = await processSelectedFiles(["test.md"], [], "/docs");
 
       expect(result).toEqual([]);
       expect(consoleWarnSpy).toHaveBeenCalledWith(
-        "⚠️  No document structure item found for file: test.md",
+        "⚠️  No documentation structure item found for file: test.md",
       );
     });
   });

package/tests/utils/kroki-utils.test.mjs

@@ -6,7 +6,7 @@ import path from "node:path";
 
 import Debug from "debug";
 
-import { TMP_ASSETS_DIR } from "../../utils/constants/index.mjs";
+import { DOC_SMITH_DIR, TMP_ASSETS_DIR, TMP_DIR } from "../../utils/constants/index.mjs";
 import {
   beforePublishHook,
   checkD2Content,
@@ -451,7 +451,7 @@ E -> F
       try {
         await checkD2Content({ content });
 
-        const assetDir = path.join(process.cwd(), ".aigne", "doc-smith", ".tmp", "assets", "d2");
+        const assetDir = path.join(process.cwd(), DOC_SMITH_DIR, TMP_DIR, TMP_ASSETS_DIR, "d2");
         const files = await readdir(assetDir);
         const d2File = files.find((file) => file.endsWith(".d2"));
         expect(d2File).toBeDefined();
@@ -470,7 +470,7 @@ E -> F
       try {
         await ensureTmpDir();
 
-        const tmpDir = path.join(tempDir, ".aigne", "doc-smith", ".tmp");
+        const tmpDir = path.join(tempDir, DOC_SMITH_DIR, TMP_DIR);
         const gitignorePath = path.join(tmpDir, ".gitignore");
 
         expect(existsSync(tmpDir)).toBe(true);
@@ -491,7 +491,7 @@ E -> F
         // First call
         await ensureTmpDir();
 
-        const tmpDir = path.join(tempDir, ".aigne", "doc-smith", ".tmp");
+        const tmpDir = path.join(tempDir, DOC_SMITH_DIR, TMP_DIR);
         const gitignorePath = path.join(tmpDir, ".gitignore");
 
         // Modify .gitignore to test if it gets overwritten
@@ -632,7 +632,7 @@ E -> F
         await Promise.all(promises);
 
         // Should only create directory once
-        const tmpDir = path.join(tempDir, ".aigne", "doc-smith", ".tmp");
+        const tmpDir = path.join(tempDir, DOC_SMITH_DIR, TMP_DIR);
         expect(existsSync(tmpDir)).toBe(true);
 
         // .gitignore should be created properly

package/tests/utils/preferences-utils.test.mjs

@@ -3,6 +3,8 @@ import { existsSync } from "node:fs";
 import { mkdir, rm, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+
+import { DOC_SMITH_DIR } from "../../utils/constants/index.mjs";
 import {
   addPreferenceRule,
   deactivateRule,
@@ -44,7 +46,7 @@ describe("preferences-utils", () => {
 
     test("should read existing preferences file", async () => {
       // Create preferences directory and file
-      const prefsDir = join(testDir, ".aigne", "doc-smith");
+      const prefsDir = join(testDir, DOC_SMITH_DIR);
       await mkdir(prefsDir, { recursive: true });
 
       await writeFile(
@@ -69,7 +71,7 @@ describe("preferences-utils", () => {
 
     test("should handle malformed YAML gracefully", async () => {
       // Create preferences directory and invalid file
-      const prefsDir = join(testDir, ".aigne", "doc-smith");
+      const prefsDir = join(testDir, DOC_SMITH_DIR);
       await mkdir(prefsDir, { recursive: true });
 
       await writeFile(join(prefsDir, "preferences.yml"), "invalid: yaml: content: [", "utf8");
@@ -85,7 +87,7 @@ describe("preferences-utils", () => {
 
       writePreferences(testPreferences);
 
-      const prefsDir = join(testDir, ".aigne", "doc-smith");
+      const prefsDir = join(testDir, DOC_SMITH_DIR);
       expect(existsSync(prefsDir)).toBe(true);
       expect(existsSync(join(prefsDir, "preferences.yml"))).toBe(true);
     });

package/tests/utils/save-value-to-config.test.mjs

@@ -5,6 +5,8 @@ import fsPromisesDefault, * as fsPromises from "node:fs/promises";
 import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
+
+import { DOC_SMITH_DIR } from "../../utils/constants/index.mjs";
 import { saveValueToConfig } from "../../utils/utils.mjs";
 
 const __filename = fileURLToPath(import.meta.url);
@@ -12,7 +14,7 @@ const __dirname = dirname(__filename);
 
 // Test directory for isolated testing
 const TEST_DIR = join(__dirname, "temp-config-test");
-const TEST_CONFIG_DIR = join(TEST_DIR, ".aigne", "doc-smith");
+const TEST_CONFIG_DIR = join(TEST_DIR, DOC_SMITH_DIR);
 const TEST_CONFIG_PATH = join(TEST_CONFIG_DIR, "config.yaml");
 
 // Store original working directory

package/types/document-structure-schema.mjs

@@ -10,7 +10,7 @@ export const documentItemSchema = z.object({
   sourceIds: z.array(z.string()).min(1, "At least one source ID is required"),
 });
 
-// Document structure schema - represents the entire document structure array
+// Documentation structure schema - represents the entire documentation structure array
 export const documentStructureSchema = z.array(documentItemSchema);
 
 // Add document schemas
@@ -80,7 +80,7 @@ export const getAddDocumentInputJsonSchema = () => {
   const schema = zodToJsonSchema(addDocumentInputSchema);
   // Add custom descriptions
   if (schema.properties) {
-    schema.properties.documentStructure.description = "Current document structure array";
+    schema.properties.documentStructure.description = "Current documentation structure array";
     schema.properties.title.description = "Title of the new document";
     schema.properties.description.description = "Description of the new document";
     schema.properties.path.description = "URL path for the new document (must start with '/')";
@@ -96,7 +96,7 @@ export const getAddDocumentOutputJsonSchema = () => {
   const schema = zodToJsonSchema(addDocumentOutputSchema);
   if (schema.properties) {
     schema.properties.documentStructure.description =
-      "Updated document structure array with the new document added";
+      "Updated documentation structure array with the new document added";
     schema.properties.addedDocument.description = "The newly added document object";
   }
   return schema;
@@ -105,7 +105,7 @@ export const getAddDocumentOutputJsonSchema = () => {
 export const getDeleteDocumentInputJsonSchema = () => {
   const schema = zodToJsonSchema(deleteDocumentInputSchema);
   if (schema.properties) {
-    schema.properties.documentStructure.description = "Current document structure array";
+    schema.properties.documentStructure.description = "Current documentation structure array";
     schema.properties.path.description = "URL path of the document to delete";
   }
   return schema;
@@ -115,7 +115,7 @@ export const getDeleteDocumentOutputJsonSchema = () => {
   const schema = zodToJsonSchema(deleteDocumentOutputSchema);
   if (schema.properties) {
     schema.properties.documentStructure.description =
-      "Updated document structure array with the document removed";
+      "Updated documentation structure array with the document removed";
     schema.properties.deletedDocument.description = "The deleted document object";
   }
   return schema;
@@ -124,7 +124,7 @@ export const getDeleteDocumentOutputJsonSchema = () => {
 export const getMoveDocumentInputJsonSchema = () => {
   const schema = zodToJsonSchema(moveDocumentInputSchema);
   if (schema.properties) {
-    schema.properties.documentStructure.description = "Current document structure array";
+    schema.properties.documentStructure.description = "Current documentation structure array";
     schema.properties.path.description = "URL path of the document to move";
     schema.properties.newParentId.description =
       "Path of the new parent document (leave empty for top-level)";
@@ -136,7 +136,7 @@ export const getMoveDocumentOutputJsonSchema = () => {
   const schema = zodToJsonSchema(moveDocumentOutputSchema);
   if (schema.properties) {
     schema.properties.documentStructure.description =
-      "Updated document structure array with the document moved";
+      "Updated documentation structure array with the document moved";
     schema.properties.originalDocument.description = "The original document object before moving";
     schema.properties.updatedDocument.description = "The updated document object after moving";
   }
@@ -146,7 +146,7 @@ export const getMoveDocumentOutputJsonSchema = () => {
 export const getUpdateDocumentInputJsonSchema = () => {
   const schema = zodToJsonSchema(updateDocumentInputSchema);
   if (schema.properties) {
-    schema.properties.documentStructure.description = "Current document structure array";
+    schema.properties.documentStructure.description = "Current documentation structure array";
     schema.properties.path.description = "URL path of the document to update";
     schema.properties.title.description = "New title for the document (optional)";
     schema.properties.description.description = "New description for the document (optional)";
@@ -166,7 +166,7 @@ export const getUpdateDocumentOutputJsonSchema = () => {
   const schema = zodToJsonSchema(updateDocumentOutputSchema);
   if (schema.properties) {
     schema.properties.documentStructure.description =
-      "Updated document structure array with the document modified";
+      "Updated documentation structure array with the document modified";
     schema.properties.originalDocument.description = "The original document object before update";
     schema.properties.updatedDocument.description =
       "The updated document object after modification";

package/utils/auth-utils.mjs

@@ -15,6 +15,7 @@ import {
 } from "./blocklet.mjs";
 import {
   BLOCKLET_ADD_COMPONENT_DOCS,
+  DEFAULT_APP_URL,
   DISCUSS_KIT_DID,
   DISCUSS_KIT_STORE_URL,
   DOC_OFFICIAL_ACCESS_TOKEN,
@@ -97,6 +98,9 @@ export async function getAccessToken(appUrl, ltToken = "") {
       appLogo: "https://docsmith.aigne.io/image-bin/uploads/9645caf64b4232699982c4d940b03b90.svg",
       openPage: (pageUrl) => {
         const url = new URL(pageUrl);
+        if (url.hostname !== DEFAULT_APP_URL) {
+          url.searchParams.set("required_roles", "owner,admin");
+        }
         if (ltToken) {
           url.searchParams.set("__lt", ltToken);
         }

package/utils/conflict-detector.mjs

@@ -76,7 +76,7 @@ export function getFilteredOptions(targetQuestion, currentSelections, allOptions
 }
 
 /**
- * Detect conflicts in user configuration selections that can be resolved through document structure
+ * Detect conflicts in user configuration selections that can be resolved through documentation structure
  * @param {Object} config - User configuration
  * @returns {Array} Array of detected conflicts with resolution strategies
  */