1import type { DocBlock } from '../docs/types';
2import { defineFeature } from '../features';
3import {
4	AGENT_DOMAIN,
5	AGENT_OWNERS,
6	AGENT_STABILITY,
7	AGENT_TAGS,
8} from './constants';
9
10export const AgentExecutionDocBlock = {
11	id: 'docs.tech.agent.execution',
12	title: 'Agent execution',
13	summary: 'Background agent execution, approvals, and artifacts.',
14	kind: 'reference',
15	visibility: 'public',
16	route: '/docs/tech/agent/execution',
17	tags: ['agent', 'execution'],
18	body: `# Agent execution
19
20Defines the core operations, events, and UI surfaces for background agent runs with auditability and approvals.
21`,
22} satisfies DocBlock;
23
24export const AgentFeature = defineFeature({
25	meta: {
26		key: 'platform.agent',
27		version: '1.0.0',
28		title: 'Agent Execution',
29		description:
30			'Run, cancel, and approve AI agent executions with full audit trail',
31		domain: AGENT_DOMAIN,
32		owners: AGENT_OWNERS,
33		tags: [...AGENT_TAGS],
34		stability: AGENT_STABILITY,
35	},
36
37	operations: [
38		{ key: 'agent.run', version: '1.0.0' },
39		{ key: 'agent.cancel', version: '1.0.0' },
40		{ key: 'agent.approvals', version: '1.0.0' },
41		{ key: 'agent.status', version: '1.0.0' },
42		{ key: 'agent.artifacts', version: '1.0.0' },
43	],
44
45	events: [
46		{ key: 'agent.run.started', version: '1.0.0' },
47		{ key: 'agent.run.completed', version: '1.0.0' },
48		{ key: 'agent.run.failed', version: '1.0.0' },
49		{ key: 'agent.approval.requested', version: '1.0.0' },
50	],
51
52	presentations: [{ key: 'agent.run.audit', version: '1.0.0' }],
53
54	capabilities: {
55		provides: [{ key: 'agent.execution', version: '1.0.0' }],
56	},
57
58	dataViews: [{ key: 'agent.run.index', version: '1.0.0' }],
59
60	forms: [{ key: 'agent.run.form', version: '1.0.0' }],
61});
62