TaurusX OS
Task Execution
Engine
The TEE is the action layer of TaurusX OS — it receives intents, plans steps, enforces permissions, dispatches to device agents, and returns results.
Task Planning
Decompose complex intents into ordered, dependency-aware step graphs.
Multi-step Execution
Execute sequential and parallel steps with full error recovery.
Device Dispatch
Route each step to the correct device agent based on capabilities.
Permission Gates
Every action is checked against the device permission profile before execution.
Execution Logging
Structured logs for every action, surfaced in Guardian telemetry.
Typed Contracts
9 action types with fully typed inputs and outputs.
Action Types
Nine action types cover the full range of computer operations:
OpenAppOpenFileEditDocumentFillFormTakeScreenshotSendEmailOrganizeFilesRunScriptDescribeScreenRisk classification:
| 1 | // Register a device and submit a task |
| 2 | const device = await fetch('/api/tee/devices/register', { |
| 3 | method: 'POST', |
| 4 | headers: { 'x-user-id': 'user_123', 'Content-Type': 'application/json' }, |
| 5 | body: JSON.stringify({ |
| 6 | type: 'macos', |
| 7 | name: 'My MacBook Pro', |
| 8 | capabilities: { |
| 9 | canOpenApps: true, |
| 10 | canAccessFiles: true, |
| 11 | canCaptureScreen: true, |
| 12 | }, |
| 13 | }), |
| 14 | }).then(r => r.json()); |
| 15 | |
| 16 | // Submit a multi-step task |
| 17 | const task = await fetch('/api/tee/tasks', { |
| 18 | method: 'POST', |
| 19 | headers: { 'x-user-id': 'user_123', 'Content-Type': 'application/json' }, |
| 20 | body: JSON.stringify({ |
| 21 | steps: [ |
| 22 | { id: 'step-1', actionType: 'OpenApp', targetDeviceId: device.id, |
| 23 | parameters: { appName: 'Notion' } }, |
| 24 | { id: 'step-2', actionType: 'TakeScreenshot', targetDeviceId: device.id, |
| 25 | parameters: {}, dependsOn: ['step-1'] }, |
| 26 | ], |
| 27 | }), |
| 28 | }).then(r => r.json()); |
| 29 | |
| 30 | console.log(task.status); // 'pending' → 'running' → 'completed' |
API Endpoints
/api/tee/devices/registerRegister a new device with capabilities
/api/tee/devicesList all devices for the authenticated user
/api/tee/actionsSubmit a single action for execution
/api/tee/actions/:actionIdFetch the result of an action
/api/tee/tasksSubmit a multi-step task plan
/api/tee/tasks/:taskIdFetch task status and results
/api/operator/executeOperatorPersonal Operator: execute an intent
/api/operator/summaryOperatorGet a human-readable activity summary
Start building with the TEE
Full API reference, SDK guides, and tutorials in the developer docs.