Skip to main content

AI Tools Integration

External modules can provide AI tools for the Architect Agent.

Define AI Tools​

Location: lib/server/ai/ai-tools.ts

Export getAiTools(userId) and return ToolDefinition[].

import { TaskRepository } from '$lib/repositories/external_modules/MoLOS-Tasks/task-repository';
import type { ToolDefinition } from '$lib/models/external_modules/MoLOS-Tasks';
import { db } from '$lib/server/db';

export function getAiTools(userId: string): ToolDefinition[] {
	const repo = new TaskRepository(db as any);

	return [
		{
			name: 'get_tasks',
			description: 'Retrieve tasks for the current user.',
			parameters: {
				type: 'object',
				properties: { limit: { type: 'number', default: 10 } }
			},
			execute: async (params) => repo.getByUserId(userId, params.limit)
		}
	];
}

How MoLOS Loads Tools​

  • Tools are discovered from lib/server/ai/ai-tools.ts in external modules.
  • Tool names are automatically prefixed with <ModuleId>_.

Key Rules​

  1. Naming: Use snake_case for tool names (e.g., create_task).
  2. Descriptions: Keep them short and unambiguous.
  3. User Isolation: Always scope calls to userId.
  4. Safety: Return enough data for the agent to explain outcomes.