{"slug":"architecture/13_EXECUTION","title":"13 · Execution","section":"architecture","sectionLabel":"Architecture","status":"unclassified","type":"document","path":"architecture/13_EXECUTION.mdx","bytes":2875,"description":"How work gets done — the mechanisms that perform actions in external systems under governance","updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n\n**How work gets done.**\n\nExecution is the set of mechanisms that perform actions in external systems. Every execution requires a governance token. Every execution is auditable. Every execution feeds back to reconciliation.\n\n---\n\n## Execution Flow\n\n```text\nApproved Action → Execution Token → Routing → Mechanism → External System → Receipt → Reconciliation\n```\n\n---\n\n## Execution Mechanisms\n\n| Mechanism | Purpose |\n|-----------|---------|\n| **APIs & Services** | Direct API calls to external systems |\n| **MCP / Tools** | Model Context Protocol tool invocations |\n| **Workflows** | Multi-step process execution |\n| **Hermes** | Execution service for complex actions |\n| **Functions / Workers** | Serverless compute execution |\n| **External Integrations** | Third-party service calls |\n\n---\n\n## Execution Token\n\n```typescript\ninterface ExecutionToken {\n  id: string;\n  tenantId: string;\n  workItemRef: string;\n  action: ActionDef;\n  approvedBy: ActorRef;\n  approvedAt: string;\n  expiresAt: string;\n  constraints: Constraint[];\n  budget: CostBudget;\n}\n```\n\n### Token Rules\n\n- Single-use\n- Expires after configurable TTL\n- Scoped to specific action\n- Cannot be reused or transferred\n- Invalid or expired tokens reject execution\n\n---\n\n## MCP Tools\n\n| Tool Category | Examples |\n|---------------|----------|\n| **Data Operations** | Read, write, query, transform |\n| **Communication** | Send message, schedule meeting |\n| **File Operations** | Create, update, share document |\n| **Workflow** | Start process, advance stage |\n| **Integration** | Call external API, sync data |\n\n---\n\n## Execution Receipt\n\n```typescript\ninterface ExecutionReceipt {\n  id: string;\n  executionToken: string;\n  action: ActionDef;\n  status: 'success' | 'partial' | 'failure';\n  result: ActionResult;\n  timestamp: string;\n  duration: number;\n}\n```\n\n---\n\n## Execution Rules\n\n| Rule | Description |\n|------|-------------|\n| **Token required** | No execution without a valid token |\n| **Scope limited** | Token scoped to specific action |\n| **Time limited** | Token expires after TTL |\n| **Budget limited** | Execution cost tracked and limited |\n| **Audit logged** | Every execution is audited |\n| **Rollback capable** | Actions can be compensated |\n\n---\n\n## Execution Connects to\n\n| Layer | Relationship |\n|-------|-------------|\n| [Governance](/architecture/10_GOVERNANCE) | Issues execution tokens |\n| [Communication Bridge](/architecture/11_COMMUNICATION_BRIDGE) | Routes to execution mechanisms |\n| [Agents](/architecture/12_AGENTS) | Agents trigger execution |\n| [Source Systems](/architecture/14_SOURCE_SYSTEMS) | Executes in external systems |\n| [Reconciliation](/architecture/15_RECONCILIATION) | Receipts feed reconciliation |\n"}