import { BaseTool, ToolResponse, ToolMetadata } from './base.js';
import { PathValidationUtil, PathValidationType } from '../utils/PathValidationUtil.js';
import { FILE_PATH_SCHEMA } from '../utils/validation.js';
import { SimpleAppendArgs } from './types/SimpleAppendArgs.js';
import { hasHttpResponse } from '../utils/errorTypeGuards.js';
export class SimpleAppendTool extends BaseTool<SimpleAppendArgs> {
name = 'obsidian_simple_append';
description = 'Append text to vault note. Requires existing file (no auto-create by default).';
metadata: ToolMetadata = {
category: 'editing',
keywords: ['append', 'add', 'text', 'simple', 'edit'],
version: '1.0.0'
};
inputSchema = {
type: 'object' as const,
properties: {
filepath: FILE_PATH_SCHEMA,
content: {
type: 'string' as const,
description: 'Text to append to the end of the file'
},
create_file_if_missing: {
type: 'boolean' as const,
description: 'Create the file if it doesn\'t exist (default: false)',
default: false
}
},
required: ['filepath', 'content']
};
async executeTyped(args: SimpleAppendArgs): Promise<ToolResponse> {
const { filepath, content, create_file_if_missing = false } = args;
// Input validation
if (!filepath || content === undefined) {
return this.handleSimplifiedError(
new Error('Missing required parameters'),
'Provide filepath and content parameters',
{ filepath: 'notes.md', content: 'Text to append' }
);
}
try {
// Validate the filepath
PathValidationUtil.validate(filepath, 'filepath', { type: PathValidationType.FILE });
const client = this.getClient();
// Use the existing append_content functionality
await client.appendContent(filepath, content, create_file_if_missing);
// Notify that file was updated
this.notifyFileOperation('update', filepath, {
operation: 'append',
contentLength: content.length,
createFileIfMissing: create_file_if_missing
});
return this.formatResponse({
success: true,
message: `Successfully appended content to ${filepath}`,
operation: 'append',
filepath
});
} catch (error: unknown) {
// Use the new handleHttpError method with custom handlers
if (hasHttpResponse(error) && error.response?.status) {
// Special handling for 404 - suggest creating the file
if (error.response.status === 404 && !create_file_if_missing) {
return this.handleHttpError(error, {
404: {
message: 'File not found',
suggestion: 'File does not exist. Try setting create_file_if_missing to true',
example: { filepath, content, create_file_if_missing: true }
}
});
}
return this.handleHttpError(error);
}
return this.handleSimplifiedError(error);
}
}
}
