1import { ScalarTypeEnum, SchemaModel } from '@lssm-tech/lib.schema';
2import { docId } from '../../docs/registry';
3import type { DocBlock } from '../../docs/types';
4import { defineCommand } from '../../operations';
5import {
6	AGENT_DOMAIN,
7	AGENT_OWNERS,
8	AGENT_STABILITY,
9	AGENT_TAGS,
10} from '../constants';
11import { AgentRunStartedEvent } from '../events/agentRunStarted.event';
12
13export const AgentRunCommand = defineCommand({
14	meta: {
15		key: 'agent.run',
16		title: 'Run Agent',
17		version: '1.0.0',
18		description: 'Submit a background agent run with a context snapshot.',
19		goal: 'Start an auditable agent execution with full provenance.',
20		context:
21			'Used by Studio and API clients to launch background agent workflows.',
22		domain: AGENT_DOMAIN,
23		owners: AGENT_OWNERS,
24		tags: [...AGENT_TAGS, 'run'],
25		stability: AGENT_STABILITY,
26		docId: [docId('docs.tech.agent.run')],
27	},
28	capability: {
29		key: 'agent.execution',
30		version: '1.0.0',
31	},
32	io: {
33		input: AgentRunInput,
34		output: AgentRunOutput,
35	},
36	policy: {
37		auth: 'user',
38		pii: ['prompt'],
39	},
40	sideEffects: {
41		emits: [
42			{
43				ref: AgentRunStartedEvent.meta,
44				when: 'A new agent run is created and queued.',
45			},
46		],
47	},
48});