For AI Agents

// ✅ CORRECT: Only import the public contract
import { createTllOS } from '@tll/os/public';

// ❌ WRONG: Never import internal implementations
// import { Kernel } from '@tll/os/core/kernel';
// import { ApiManager } from '@tll/os/core/api';

// Create a TLL OS application
const app = createTllOS();

// Register a module
const module = app.registerModule({
  name: 'my-module',
  version: '1.0.0',
  description: 'My first TLL OS module'
});

// Create an API endpoint
module.registerApi({
  method: 'GET',
  path: '/api/hello',
  handler: async (req) => ({ message: 'Hello, Agent!' })
});

// Create a Tool for Agents
module.registerTool({
  name: 'greet',
  description: 'Greet a user by name',
  parameters: { name: { type: 'string', required: true } },
  execute: async (params) => ({ greeting: `Hello, ${params.name}!` })
});

// Read the Application Graph
const graph = app.getGraph();
console.log(`Nodes: ${graph.listNodes().length}`);
console.log(`Edges: ${graph.listEdges().length}`);

// Run tests
const results = await app.runTests();
console.log(`${results.passed}/${results.total} passed`);