import { readdirSync, statSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
import { extname, basename, join, dirname } from 'path';

function getMarkdownFilesSync(dir) {
    try {
        const files = readdirSync('mintlify/' + dir);
        const markdownFiles = files
            .filter(file => extname(file) === '.md')
            .map(file =>  dir + '/' + basename(file, '.md'));
        return markdownFiles;
    } catch (err) {
        console.error(`Error reading directory: ${err}`);
        return [];
    }
}

function moveAndUpdateFilesSync(srcDir, destDir) {
    const files = readdirSync(srcDir);

    files.forEach(file => {
        const srcPath = join(srcDir, file);
        const stats = statSync(srcPath);

        if (stats.isDirectory()) {
            moveAndUpdateFilesSync(srcPath, destDir); // Recursively move files in subdirectories
        } else if (stats.isFile() && file !== 'Overview.mdx') {
            let destPath;
            if (srcPath.includes('docs/sdks/') && file === 'README.md') {
                const type = srcPath.split('/').slice(-2, -1)[0];
                destPath = join(destDir, 'sdk-docs', `${type}.mdx`);
            } else if (srcPath.includes('docs/models/components/')) {
                const model = basename(file, '.md');
                destPath = join(destDir, 'sdk-docs', 'models', 'components', `${model}.md`);
            } else if (srcPath.includes('docs/models/operations/')) {
                const model = basename(file, '.md');
                destPath = join(destDir, 'sdk-docs', 'models', 'operations', `${model}.md`);
            } else if (srcPath.includes('docs/models/errors/')) {
                const model = basename(file, '.md');
                destPath = join(destDir, 'sdk-docs', 'models', 'errors', `${model}.md`);
            }

            if (destPath) {
                mkdirSync(dirname(destPath), { recursive: true });

                const data = readFileSync(srcPath, 'utf8');

                const lines = data.split('\n');
                if (lines[0].startsWith('#')) {
                    const title = lines[0].substring(1).trim();
                    lines[0] = `---\ntitle: '${title}'\n---`;
                }

                let updatedData = lines.join('\n');
                updatedData = updatedData.replace(//g, ''); // Remove HTML comments  
                updatedData = updatedData.replace(/<Uint8Array>/g, ''); // Remove HTML conflicts
                updatedData = updatedData.replace(/<string, \*string\*>/g, ''); // Remove HTML conflicts
                updatedData = updatedData.replace(/:heavy_check_mark:/g, 'TRUE'); // Replace :heavy-check-mark: with TRUE
                updatedData = updatedData.replace(/:heavy_minus_sign:/g, 'FALSE'); // Replace :heavy-minus-sign: with FALSE
                updatedData = updatedData.replace(/\[([^\]]+)\]$\.\.\/\.\.\/models\/components\/([^$]+)\.md\)/g, '[$1](/sdk-docs/models/components/$2)'); // Update links
                updatedData = updatedData.replace(/\[([^\]]+)\]$\.\.\/\.\.\/models\/operations\/([^$]+)\.md\)/g, '[$1](/sdk-docs/models/operations/$2)'); // Update links
                updatedData = updatedData.replace(/\[([^\]]+)\]$\.\.\/\.\.\/models\/errors\/([^$]+)\.md\)/g, '[$1](/sdk-docs/models/errors/$2)'); // Update links
                updatedData = updatedData.replace(/\[([^\]]+)\]$\.\.\/\.\.\/models\/errors\/([^$]+)\.md\)/g, '[$1](/sdk-docs/models/errors/$2)'); // Update links
                updatedData = updatedData.replace(/\[([^\]]+)\]$\.\.\/\.\.\/lib\/utils\/([^$]+)\.md\)/g, '[$1](/sdk-docs/lib/utils/$2)'); // Update links
                updatedData = updatedData.replace(/<\[any\]$\.\.\/\.\.\/models\/.*\.md$/g, 'ANY');// Replace <[any](../../models/.md)> with ANY

                // Special fixes for specific files
                updatedData = updatedData.replace("**Promise\\<[ReadableStream](../../models/.md)\\>**", "Promise\\<ReadableStream\\>"); // Fix for ReadableStream
                updatedData = updatedData.replace("**Promise\\<[components.AgentVoice[]](../../models/.md)\\>**", 
                    "Promise\\<[components.AgentVoice[]](/sdk-docs/models/components/agentvoice)\\>"); // Fix for AgentVoice
                updatedData = updatedData.replace("**Promise\\<[components.PromptHistory[]](../../models/.md)\\>**", 
                    "**Promise\\<[components.PromptHistory[]](/sdk-docs/models/components/prompthistory)\\>**"); // Fix for PromptHistory

                writeFileSync(destPath, updatedData, 'utf8');
                console.log(`Moved and updated ${srcPath} to ${destPath}`);
            }
        }
    });
}

function updateMintJsonSync() {
    const mintJsonPath = 'mintlify/mint.json';
    const mintJson = JSON.parse(readFileSync(mintJsonPath, 'utf8'));

    const componentsDir = 'sdk-docs/models/components';
    const operationsDir = 'sdk-docs/models/operations';
    const errorsDir = 'sdk-docs/models/errors';

    const componentsPages = getMarkdownFilesSync(componentsDir);
    const operationsPages = getMarkdownFilesSync(operationsDir);
    const errorsPages = getMarkdownFilesSync(errorsDir);

    const navigation = mintJson.navigation;

    for (let i = 0; i < navigation.length; i++) {
        if (navigation[i].group === 'Models') {
            const modelsGroup = navigation[i].pages;

            for (let j = 0; j < modelsGroup.length; j++) {
                if (modelsGroup[j].group === 'Components') {
                    modelsGroup[j].pages = componentsPages;
                } else if (modelsGroup[j].group === 'Operations') {
                    modelsGroup[j].pages = operationsPages;
                } else if (modelsGroup[j].group === 'Errors') {
                    modelsGroup[j].pages = errorsPages;
                }
            }
        }
    }

    writeFileSync(mintJsonPath, JSON.stringify(mintJson, null, 2), 'utf8');
    console.log('Updated mint.json');
}

// Example usage
moveAndUpdateFilesSync('docs/sdks/', 'mintlify');
moveAndUpdateFilesSync('docs/models/', 'mintlify');
updateMintJsonSync();

Embedding your agent on Shopify Storefront

Syllable SDK

How Syllable works

Key Features

Login and signup

Agents

Sessions

Channels

Data Sources

Language Groups

Messages

Prompts

Tools

Telephony Integration

Web Chat

Agent List

Update Agent

Create Agent

Get Agent By Id

Delete Agent

Get Available Agent Voices

Get Channels

Delete Channel Target

Get Twilio Channel By Id

Update Twilio Channel

Create Twilio Channel

Purchase a Twilio number and associate it with a channel.

Add Twilio Number

Send New Message

Conversations List

Fetch metadata about all data sources, not including their text.

List Data Sources

Update Data Source

Create Data Source

Fetch a given data source, including its text.

Get Data Source

Delete Data Source

Events List

List service incidents with pagination and filtering

List Incidents

Update Incident

Create Incident

Get Organizations

Get Incident By Id

Delete Incident

List the evaluated insights for sessions.

Insights List

List Insights Upload Folders

Create Insights Upload Folder

Get Insights Folder Details

Update Insights Folder

Delete Insights Folder

Upload Insights  Upload Folder

Fetch Insights Upload Files

Move Insights Upload Files

Insight Workflow List

Create Insight Workflow

Get Insight Workflow By Id

Update Insights Workflow

Delete Insights Workflow

Inactivate Insights Workflow

Activate Insights Workflow

Manually queue sessions for insights workflow evaluation.

Queue Insights Workflow For Sessions/Files

List Insight Tool Configurations

Create Insight Tool Configuration

Get Insight Tool Config By Id

Update Insights Tool Configuration

Delete Insight Tool Configuration

Manually run the given insight tool against a session and return the response.

Test Insights Tool

Get Insight Tool Definitions

Custom Messages List

Update Custom Message

Create Custom Message

Get Custom Message By Id

Delete Custom Message

Prompt List

Update Prompt

Create Prompt

Get Prompt By Id

Delete Prompt

Get Prompt History

Get Supported Llm Configs

Service List

Update Service

Create Service

Get Service By Id

Delete a service. A service with linked tools cannot be deleted.

Delete Service

Get Label By Id

Session Labels List

Create Label

Sessions List

Get A Single Session By Id

Generate Recording Urls

Stream Recording

Get Session Transcript By Id

Get Full Session Summary By Id

Inspect Latency For Session

Get Session Data By Sid

Get Session Data By Session Id

Get Session Tool Call Result By Id

Tool List

Update Tool

Create Tool

Tool Info

Delete Tool

Available Targets List

Get Channel Targets

Assign A Channel Target

Get A Channel Target

Edit Channel Target

Directory Member List

Create Directory Member

Get Directory Member By Id

Update Directory Member

Delete Directory Member

Update Directory Members in chunks of 100.

Bulk Load Directory Members

Download the entire directory as a JSON file.

Download Directory Members

METHOD: POST
URL: /dashboard/list
ARGUMENTS: None
RETURNS: List of dashboards

Post List Dashboards

METHOD: POST
URL: /dashboard/fetch_info
ARGUMENTS: None
RETURNS: Dashboard info for embedding

Post Fetch Info

METHOD: POST
URL: /dashboard/session_events
ARGUMENTS: None
RETURNS: Dashboard info for embedding
DEPRECATED: This endpoint is deprecated. Please use /dashboard/list instead

Post Session Events

METHOD: POST
URL: /dashboard/session_summary
ARGUMENTS: None
RETURNS: Dashboard info for embedding
DEPRECATED: This endpoint is deprecated. Please use /dashboard/list instead

Post Session Summary

METHOD: POST
URL: /dashboard/session_transfers
ARGUMENTS: None
RETURNS: Dashboard info for embedding
DEPRECATED: This endpoint is deprecated. Please use /dashboard/list instead

Post Session Transfers

METHOD: POST
URL: /dashboard/sessions
ARGUMENTS: None
RETURNS: Dashboard info for embedding
DEPRECATED: This endpoint is deprecated. Please use /dashboard/list instead

Introduction to Syllable

Tutorials

Workspaces

Resources

Embedding your agent on Shopify Storefront