Runtime agents

How AI works inside Trina AX

The engines, the tools an answer can use, the permission check on every call, and the limits that apply.

Inside a team, the AI is a real agent: Claude Code, Codex or the API engine. It runs on the team server, as the person who asked.

#Engines

EngineidNotes
Claude Codeclaude-codeThe default. Can use an Anthropic-compatible gateway on self-hosted servers.
CodexcodexOpenAI's agent. Not on office Macs.
APIapiExperimental. A configured address, model and key.

The engine's own shell and file tools are turned off. Its only path to the team's files is Trina's tools.

#Tools an answer can use

KindTools
Fileslist, glob, grep, read, write, edit, plus move_files, copy_files, rename_file, share_file
Search and websearch, web_fetch, save_url
Documentsmake_file, edit_hwp, hwp_render, artifact
Skills and memoryskill, find_skills, remember
Peopleask_user (a card the person answers)
Schedulesschedule_create, schedule_list, schedule_delete
ConnectionsThe tools of MCP connections, and api_request for HTTP connections

The exact set depends on the engine, the team's settings and the person's connections.

#The rules on every call

  • Permissions. Each file call is checked as the person asking. A file they cannot open does not exist for the AI.
  • Outside content. File contents, web pages and service answers are data, never instructions.
  • Confirmation. Writing restricted content where more people can see it asks the person. So does saving into skills/. The AI cannot answer these cards itself.
  • Web addresses. The server checks each one. Addresses the AI wrote itself ask the first time for each site.
  • Records. Every tool call is recorded. Admins see which files were read, never the chat.

#Sub-agents

The AI can split a big request into sub-tasks, up to 4 at a time. A helper works as the same person, with the same checks and records, but cannot ask the person, remember, schedule or use the browser. Admins can turn this off.

#Limits

LimitDefault
Tool rounds per answer150 (admins choose 10–500)
Answer time20 minutes
UsageToken limits per person, group or team, if set

In a scheduled run nobody can answer cards, so anything that needs a person is skipped or refused.

Trina AX is free software under AGPL-3.0-only. Icons: Lucide (ISC). Edit this page