1import { defineCapability } from '../../capabilities';
2import { docId } from '../../docs/registry';
3import {
4	AGENT_DOMAIN,
5	AGENT_OWNERS,
6	AGENT_STABILITY,
7	AGENT_TAGS,
8} from '../constants';
9
10export const AgentExecutionCapability = defineCapability({
11	meta: {
12		key: 'agent.execution',
13		version: '1.0.0',
14		kind: 'integration',
15		title: 'Agent Execution',
16		description: 'Background agent execution, approvals, and artifacts.',
17		domain: AGENT_DOMAIN,
18		owners: AGENT_OWNERS,
19		tags: [...AGENT_TAGS, 'execution'],
20		stability: AGENT_STABILITY,
21		docId: [docId('docs.tech.agent.execution')],
22	},
23	provides: [
24		{
25			surface: 'operation',
26			key: 'agent.run',
27			version: '1.0.0',
28			description: 'Submit an agent run.',
29		},
30		{
31			surface: 'operation',
32			key: 'agent.status',
33			version: '1.0.0',
34			description: 'Query agent run status.',
35		},
36		{
37			surface: 'operation',
38			key: 'agent.cancel',
39			version: '1.0.0',
40			description: 'Cancel an agent run.',
41		},
42		{
43			surface: 'operation',
44			key: 'agent.artifacts',
45			version: '1.0.0',
46			description: 'List agent artifacts.',
47		},
48		{
49			surface: 'operation',
50			key: 'agent.approvals',
51			version: '1.0.0',
52			description: 'Resolve an agent approval request.',
53		},
54		{
55			surface: 'event',
56			key: 'agent.run.started',
57			version: '1.0.0',
58			description: 'Agent run started event.',
59		},
60		{
61			surface: 'event',
62			key: 'agent.run.completed',
63			version: '1.0.0',
64			description: 'Agent run completed event.',
65		},
66		{
67			surface: 'event',
68			key: 'agent.run.failed',
69			version: '1.0.0',
70			description: 'Agent run failed event.',
71		},
72		{
73			surface: 'event',
74			key: 'agent.approval.requested',
75			version: '1.0.0',
76			description: 'Approval requested event.',
77		},
78		{
79			surface: 'presentation',
80			key: 'agent.run.audit',
81			version: '1.0.0',
82			description: 'Audit presentation for agent runs.',
83		},
84	],
85});