@datalayer/agent-runtimes 1.0.3 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/README.md +13 -131
  2. package/lib/chat/Chat.d.ts +3 -1
  3. package/lib/chat/Chat.js +2 -2
  4. package/lib/chat/base/ChatBase.js +52 -1
  5. package/lib/chat/messages/ChatMessageList.js +17 -4
  6. package/lib/client/AgentsMixin.d.ts +48 -1
  7. package/lib/client/AgentsMixin.js +109 -0
  8. package/lib/components/NotificationEventCard.js +51 -26
  9. package/lib/components/OutputCard.js +21 -7
  10. package/lib/components/ToolApprovalCard.js +20 -2
  11. package/lib/examples/AgentCheckpointsExample.js +2 -8
  12. package/lib/examples/AgentCodemodeExample.js +3 -9
  13. package/lib/examples/AgentEvalsExample.js +3 -9
  14. package/lib/examples/AgentGuardrailsExample.js +3 -9
  15. package/lib/examples/AgentMemoryExample.js +3 -9
  16. package/lib/examples/AgentMonitoringExample.js +3 -9
  17. package/lib/examples/AgentNotificationsExample.js +2 -8
  18. package/lib/examples/AgentOutputsExample.js +3 -9
  19. package/lib/examples/AgentSandboxExample.js +3 -9
  20. package/lib/examples/AgentSkillsExample.js +3 -9
  21. package/lib/examples/AgentToolApprovalsExample.js +89 -24
  22. package/lib/examples/AgentTriggersExample.js +604 -37
  23. package/lib/examples/ChatExample.js +2 -10
  24. package/lib/examples/components/ErrorView.d.ts +14 -0
  25. package/lib/examples/components/ErrorView.js +20 -0
  26. package/lib/examples/components/index.d.ts +2 -0
  27. package/lib/examples/components/index.js +1 -0
  28. package/lib/examples/main.d.ts +1 -0
  29. package/lib/examples/main.js +1 -0
  30. package/lib/protocols/VercelAIAdapter.d.ts +2 -0
  31. package/lib/protocols/VercelAIAdapter.js +86 -20
  32. package/lib/shims/json5.d.ts +4 -0
  33. package/lib/shims/json5.js +8 -0
  34. package/lib/specs/agents/agents.js +241 -1390
  35. package/lib/specs/agents/index.js +1 -3
  36. package/lib/specs/envvars.js +20 -27
  37. package/lib/specs/evals.js +6 -6
  38. package/lib/specs/events.d.ts +10 -2
  39. package/lib/specs/events.js +84 -126
  40. package/lib/specs/frontendTools.js +2 -2
  41. package/lib/specs/guardrails.d.ts +7 -0
  42. package/lib/specs/guardrails.js +159 -240
  43. package/lib/specs/mcpServers.js +6 -35
  44. package/lib/specs/memory.d.ts +2 -0
  45. package/lib/specs/memory.js +17 -4
  46. package/lib/specs/models.js +5 -25
  47. package/lib/specs/notifications.js +18 -102
  48. package/lib/specs/outputs.js +9 -15
  49. package/lib/specs/skills.js +18 -18
  50. package/lib/specs/teams/index.js +1 -3
  51. package/lib/specs/teams/teams.js +348 -468
  52. package/lib/specs/tools.js +6 -3
  53. package/lib/specs/triggers.js +11 -61
  54. package/lib/types/tools.d.ts +2 -0
  55. package/package.json +1 -1
  56. package/scripts/codegen/__pycache__/versioning.cpython-313.pyc +0 -0
  57. package/scripts/codegen/generate_agents.py +4 -1
  58. package/scripts/codegen/generate_events.py +12 -4
  59. package/scripts/codegen/generate_tools.py +20 -0
  60. package/style/primer-primitives.css +1 -6
  61. package/scripts/codegen/__pycache__/generate_agents.cpython-313.pyc +0 -0
  62. package/scripts/codegen/__pycache__/generate_envvars.cpython-313.pyc +0 -0
  63. package/scripts/codegen/__pycache__/generate_evals.cpython-313.pyc +0 -0
  64. package/scripts/codegen/__pycache__/generate_guardrails.cpython-313.pyc +0 -0
  65. package/scripts/codegen/__pycache__/generate_mcp_servers.cpython-313.pyc +0 -0
  66. package/scripts/codegen/__pycache__/generate_memory.cpython-313.pyc +0 -0
  67. package/scripts/codegen/__pycache__/generate_models.cpython-313.pyc +0 -0
  68. package/scripts/codegen/__pycache__/generate_notifications.cpython-313.pyc +0 -0
  69. package/scripts/codegen/__pycache__/generate_outputs.cpython-313.pyc +0 -0
  70. package/scripts/codegen/__pycache__/generate_skills.cpython-313.pyc +0 -0
  71. package/scripts/codegen/__pycache__/generate_teams.cpython-313.pyc +0 -0
  72. package/scripts/codegen/__pycache__/generate_tools.cpython-313.pyc +0 -0
  73. package/scripts/codegen/__pycache__/generate_triggers.cpython-313.pyc +0 -0
@@ -31,9 +31,7 @@ export function getAgentSpecs(agentId) {
31
31
  */
32
32
  export function listAgentSpecs(prefix) {
33
33
  const specs = Object.values(AGENT_SPECS);
34
- return prefix !== undefined
35
- ? specs.filter(s => s.id.startsWith(prefix))
36
- : specs;
34
+ return prefix !== undefined ? specs.filter(s => s.id.startsWith(prefix)) : specs;
37
35
  }
38
36
  /**
39
37
  * Collect all required environment variables for an agent spec.
@@ -11,7 +11,7 @@ export const ALPHAVANTAGE_API_KEY_SPEC_0_0_1 = {
11
11
  name: 'Alpha Vantage API Key',
12
12
  description: 'API key for accessing Alpha Vantage financial market data and stock information. Provides real-time and historical stock prices, forex data, and cryptocurrency information.',
13
13
  registrationUrl: 'https://www.alphavantage.co/support/#api-key',
14
- tags: ['authentication', 'api-key', 'finance', 'stocks', 'market-data'],
14
+ tags: ["authentication", "api-key", "finance", "stocks", "market-data"],
15
15
  icon: 'key',
16
16
  emoji: '🔑',
17
17
  };
@@ -21,7 +21,7 @@ export const GITHUB_TOKEN_SPEC_0_0_1 = {
21
21
  name: 'GitHub Token',
22
22
  description: 'GitHub API token for repository management and code operations. Required for GitHub MCP server and GitHub skill to interact with GitHub repositories programmatically.',
23
23
  registrationUrl: 'https://github.com/settings/tokens',
24
- tags: ['authentication', 'token', 'github', 'git', 'mcp-server', 'skill'],
24
+ tags: ["authentication", "token", "github", "git", "mcp-server", "skill"],
25
25
  icon: 'key',
26
26
  emoji: '🔑',
27
27
  };
@@ -31,7 +31,7 @@ export const GOOGLE_OAUTH_CLIENT_ID_SPEC_0_0_1 = {
31
31
  name: 'Google OAuth Client ID',
32
32
  description: 'OAuth 2.0 client ID for Google Workspace authentication. Required for Google Drive, Gmail, Calendar, and Docs integration through the Google Workspace MCP server.',
33
33
  registrationUrl: 'https://console.cloud.google.com/apis/credentials',
34
- tags: ['authentication', 'oauth', 'google', 'workspace', 'client-id'],
34
+ tags: ["authentication", "oauth", "google", "workspace", "client-id"],
35
35
  icon: 'key',
36
36
  emoji: '🔑',
37
37
  };
@@ -41,14 +41,7 @@ export const GOOGLE_OAUTH_CLIENT_SECRET_SPEC_0_0_1 = {
41
41
  name: 'Google OAuth Client Secret',
42
42
  description: 'OAuth 2.0 client secret for Google Workspace authentication. Used in conjunction with client ID for secure API access to Google services.',
43
43
  registrationUrl: 'https://console.cloud.google.com/apis/credentials',
44
- tags: [
45
- 'authentication',
46
- 'oauth',
47
- 'google',
48
- 'workspace',
49
- 'client-secret',
50
- 'security',
51
- ],
44
+ tags: ["authentication", "oauth", "google", "workspace", "client-secret", "security"],
52
45
  icon: 'lock',
53
46
  emoji: '🔒',
54
47
  };
@@ -58,7 +51,7 @@ export const HF_TOKEN_SPEC_0_0_1 = {
58
51
  name: 'Hugging Face Token',
59
52
  description: 'Access token for Hugging Face API. Required for Hugging Face MCP server authentication. Create a READ token from your settings.',
60
53
  registrationUrl: 'https://huggingface.co/settings/tokens',
61
- tags: ['authentication', 'api-key', 'huggingface', 'machine-learning'],
54
+ tags: ["authentication", "api-key", "huggingface", "machine-learning"],
62
55
  icon: 'key',
63
56
  emoji: '🔑',
64
57
  };
@@ -68,7 +61,7 @@ export const KAGGLE_TOKEN_SPEC_0_0_1 = {
68
61
  name: 'Kaggle API Token',
69
62
  description: 'API token for accessing Kaggle datasets, competitions, notebooks, and models. Required for Kaggle MCP server authentication.',
70
63
  registrationUrl: 'https://www.kaggle.com/settings/account',
71
- tags: ['authentication', 'api-key', 'kaggle', 'data'],
64
+ tags: ["authentication", "api-key", "kaggle", "data"],
72
65
  icon: 'key',
73
66
  emoji: '🔑',
74
67
  };
@@ -78,7 +71,7 @@ export const SLACK_BOT_TOKEN_SPEC_0_0_1 = {
78
71
  name: 'Slack Bot Token',
79
72
  description: 'OAuth token for Slack bot authentication. Required for Slack MCP server to send messages, manage channels, and interact with workspace members.',
80
73
  registrationUrl: 'https://api.slack.com/apps',
81
- tags: ['authentication', 'oauth', 'token', 'slack', 'messaging', 'bot'],
74
+ tags: ["authentication", "oauth", "token", "slack", "messaging", "bot"],
82
75
  icon: 'key',
83
76
  emoji: '🔑',
84
77
  };
@@ -87,7 +80,7 @@ export const SLACK_CHANNEL_IDS_SPEC_0_0_1 = {
87
80
  version: '0.0.1',
88
81
  name: 'Slack Channel IDs',
89
82
  description: 'Comma-separated list of Slack channel IDs that the bot is allowed to access. Restricts bot operations to specific channels for security and organization.',
90
- tags: ['configuration', 'slack', 'channels', 'identifier'],
83
+ tags: ["configuration", "slack", "channels", "identifier"],
91
84
  icon: 'hash',
92
85
  emoji: undefined,
93
86
  };
@@ -97,7 +90,7 @@ export const SLACK_TEAM_ID_SPEC_0_0_1 = {
97
90
  name: 'Slack Team ID',
98
91
  description: 'Unique identifier for the Slack workspace (team). Required to specify which workspace the bot should connect to.',
99
92
  registrationUrl: 'https://api.slack.com/apps',
100
- tags: ['configuration', 'slack', 'workspace', 'identifier'],
93
+ tags: ["configuration", "slack", "workspace", "identifier"],
101
94
  icon: 'organization',
102
95
  emoji: '🏢',
103
96
  };
@@ -107,7 +100,7 @@ export const TAVILY_API_KEY_SPEC_0_0_1 = {
107
100
  name: 'Tavily API Key',
108
101
  description: 'API key for Tavily web search and research capabilities. Required for web crawling, content extraction, and search operations.',
109
102
  registrationUrl: 'https://tavily.com/api-keys',
110
- tags: ['authentication', 'api-key', 'search', 'web', 'research'],
103
+ tags: ["authentication", "api-key", "search", "web", "research"],
111
104
  icon: 'key',
112
105
  emoji: '🔑',
113
106
  };
@@ -115,16 +108,16 @@ export const TAVILY_API_KEY_SPEC_0_0_1 = {
115
108
  // Environment Variable Catalog
116
109
  // ============================================================================
117
110
  export const ENVVAR_CATALOG = {
118
- ALPHAVANTAGE_API_KEY: ALPHAVANTAGE_API_KEY_SPEC_0_0_1,
119
- GITHUB_TOKEN: GITHUB_TOKEN_SPEC_0_0_1,
120
- GOOGLE_OAUTH_CLIENT_ID: GOOGLE_OAUTH_CLIENT_ID_SPEC_0_0_1,
121
- GOOGLE_OAUTH_CLIENT_SECRET: GOOGLE_OAUTH_CLIENT_SECRET_SPEC_0_0_1,
122
- HF_TOKEN: HF_TOKEN_SPEC_0_0_1,
123
- KAGGLE_TOKEN: KAGGLE_TOKEN_SPEC_0_0_1,
124
- SLACK_BOT_TOKEN: SLACK_BOT_TOKEN_SPEC_0_0_1,
125
- SLACK_CHANNEL_IDS: SLACK_CHANNEL_IDS_SPEC_0_0_1,
126
- SLACK_TEAM_ID: SLACK_TEAM_ID_SPEC_0_0_1,
127
- TAVILY_API_KEY: TAVILY_API_KEY_SPEC_0_0_1,
111
+ 'ALPHAVANTAGE_API_KEY': ALPHAVANTAGE_API_KEY_SPEC_0_0_1,
112
+ 'GITHUB_TOKEN': GITHUB_TOKEN_SPEC_0_0_1,
113
+ 'GOOGLE_OAUTH_CLIENT_ID': GOOGLE_OAUTH_CLIENT_ID_SPEC_0_0_1,
114
+ 'GOOGLE_OAUTH_CLIENT_SECRET': GOOGLE_OAUTH_CLIENT_SECRET_SPEC_0_0_1,
115
+ 'HF_TOKEN': HF_TOKEN_SPEC_0_0_1,
116
+ 'KAGGLE_TOKEN': KAGGLE_TOKEN_SPEC_0_0_1,
117
+ 'SLACK_BOT_TOKEN': SLACK_BOT_TOKEN_SPEC_0_0_1,
118
+ 'SLACK_CHANNEL_IDS': SLACK_CHANNEL_IDS_SPEC_0_0_1,
119
+ 'SLACK_TEAM_ID': SLACK_TEAM_ID_SPEC_0_0_1,
120
+ 'TAVILY_API_KEY': TAVILY_API_KEY_SPEC_0_0_1,
128
121
  };
129
122
  function resolveEnvvarId(envvarId) {
130
123
  if (envvarId in ENVVAR_CATALOG)
@@ -69,7 +69,7 @@ export const SWE_BENCH_EVAL_SPEC_0_0_1 = {
69
69
  id: 'swe-bench',
70
70
  version: '0.0.1',
71
71
  name: 'SWE-bench',
72
- description: "Real-world software engineering tasks from GitHub issues. Tests an agent's ability to understand bug reports and feature requests, then produce working code patches that pass existing test suites.",
72
+ description: 'Real-world software engineering tasks from GitHub issues. Tests an agent\'s ability to understand bug reports and feature requests, then produce working code patches that pass existing test suites.',
73
73
  category: 'Coding',
74
74
  task_count: 2294,
75
75
  metric: 'pass@1',
@@ -105,14 +105,14 @@ export const TRUTHFULQA_EVAL_SPEC_0_0_1 = {
105
105
  // Eval Catalog
106
106
  // ============================================================================
107
107
  export const EVAL_CATALOG = {
108
- agentbench: AGENTBENCH_EVAL_SPEC_0_0_1,
108
+ 'agentbench': AGENTBENCH_EVAL_SPEC_0_0_1,
109
109
  'gpqa-diamond': GPQA_DIAMOND_EVAL_SPEC_0_0_1,
110
- humaneval: HUMANEVAL_EVAL_SPEC_0_0_1,
111
- mmlu: MMLU_EVAL_SPEC_0_0_1,
110
+ 'humaneval': HUMANEVAL_EVAL_SPEC_0_0_1,
111
+ 'mmlu': MMLU_EVAL_SPEC_0_0_1,
112
112
  'swe-bench-verified': SWE_BENCH_VERIFIED_EVAL_SPEC_0_0_1,
113
113
  'swe-bench': SWE_BENCH_EVAL_SPEC_0_0_1,
114
- toolbench: TOOLBENCH_EVAL_SPEC_0_0_1,
115
- truthfulqa: TRUTHFULQA_EVAL_SPEC_0_0_1,
114
+ 'toolbench': TOOLBENCH_EVAL_SPEC_0_0_1,
115
+ 'truthfulqa': TRUTHFULQA_EVAL_SPEC_0_0_1,
116
116
  };
117
117
  export function getEvalSpecs() {
118
118
  return Object.values(EVAL_CATALOG);
@@ -7,11 +7,19 @@
7
7
  * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
8
8
  */
9
9
  import type { EventSpec } from '../types';
10
- export declare const AGENT_ENDED_EVENT_SPEC_0_0_1: EventSpec;
10
+ export declare const AGENT_ASSIGNED_EVENT_SPEC_0_0_1: EventSpec;
11
+ export declare const AGENT_OUTPUT_EVENT_SPEC_0_0_1: EventSpec;
12
+ export declare const AGENT_START_REQUESTED_EVENT_SPEC_0_0_1: EventSpec;
11
13
  export declare const AGENT_STARTED_EVENT_SPEC_0_0_1: EventSpec;
14
+ export declare const AGENT_TERMINATED_EVENT_SPEC_0_0_1: EventSpec;
15
+ export declare const AGENT_TERMINATION_REQUESTED_EVENT_SPEC_0_0_1: EventSpec;
12
16
  export declare const TOOL_APPROVAL_REQUESTED_EVENT_SPEC_0_0_1: EventSpec;
13
- export declare const EVENT_KIND_AGENT_ENDED = "agent-ended";
17
+ export declare const EVENT_KIND_AGENT_ASSIGNED = "agent-assigned";
18
+ export declare const EVENT_KIND_AGENT_OUTPUT = "agent-output";
19
+ export declare const EVENT_KIND_AGENT_START_REQUESTED = "agent-start-requested";
14
20
  export declare const EVENT_KIND_AGENT_STARTED = "agent-started";
21
+ export declare const EVENT_KIND_AGENT_TERMINATED = "agent-terminated";
22
+ export declare const EVENT_KIND_AGENT_TERMINATION_REQUESTED = "agent-termination-requested";
15
23
  export declare const EVENT_KIND_TOOL_APPROVAL_REQUESTED = "tool-approval-requested";
16
24
  export declare const EVENT_CATALOG: Record<string, EventSpec>;
17
25
  export declare function getEventSpecs(): EventSpec[];
@@ -5,69 +5,47 @@
5
5
  // ============================================================================
6
6
  // Event Definitions
7
7
  // ============================================================================
8
- export const AGENT_ENDED_EVENT_SPEC_0_0_1 = {
9
- id: 'agent-ended',
8
+ export const AGENT_ASSIGNED_EVENT_SPEC_0_0_1 = {
9
+ id: 'agent-assigned',
10
10
  version: '0.0.1',
11
- name: 'Agent Ended',
12
- description: 'Emitted when an agent finishes execution. Contains timing information, exit status, optional output summary, and error details if applicable.',
13
- kind: 'agent-ended',
11
+ name: 'Agent Assigned',
12
+ description: 'Emitted when an agent runtime is assigned/configured by the companion through the MCP servers start API.',
13
+ kind: 'agent-assigned',
14
14
  fields: [
15
- {
16
- name: 'agent_runtime_id',
17
- label: 'Agent Runtime ID',
18
- type: 'string',
19
- required: true,
20
- description: 'Runtime pod or instance identifier.',
21
- },
22
- {
23
- name: 'agent_spec_id',
24
- label: 'Agent Spec ID',
25
- type: 'string',
26
- required: true,
27
- description: 'Identifier of the agent specification that was executed.',
28
- },
29
- {
30
- name: 'started_at',
31
- label: 'Started At',
32
- type: 'string',
33
- required: true,
34
- description: 'ISO 8601 timestamp when the agent started.',
35
- },
36
- {
37
- name: 'ended_at',
38
- label: 'Ended At',
39
- type: 'string',
40
- required: true,
41
- description: 'ISO 8601 timestamp when the agent ended.',
42
- },
43
- {
44
- name: 'duration_ms',
45
- label: 'Duration (ms)',
46
- type: 'number',
47
- required: true,
48
- description: 'Total execution time in milliseconds.',
49
- },
50
- {
51
- name: 'exit_status',
52
- label: 'Exit Status',
53
- type: 'string',
54
- required: true,
55
- description: 'Final status of the agent run (e.g. completed, error).',
56
- },
57
- {
58
- name: 'outputs',
59
- label: 'Outputs',
60
- type: 'string',
61
- required: false,
62
- description: 'Summary of the agent output or generated artifacts.',
63
- },
64
- {
65
- name: 'error_message',
66
- label: 'Error Message',
67
- type: 'string',
68
- required: false,
69
- description: 'Error description if the agent run failed.',
70
- },
15
+ { name: 'agent_runtime_id', label: 'Agent Runtime ID', type: 'string', required: true, description: 'Runtime pod or instance identifier.' },
16
+ { name: 'assignment_source', label: 'Assignment Source', type: 'string', required: false, description: 'Source that initiated the assignment (for example companion).' },
17
+ { name: 'assigned_at', label: 'Assigned At', type: 'string', required: false, description: 'ISO 8601 timestamp when assignment/configuration completed.' },
18
+ { name: 'origin', label: 'Origin', type: 'string', required: false, description: 'Producer origin (endpoint, companion, runtime, or agent-runtime).' },
19
+ ],
20
+ };
21
+ export const AGENT_OUTPUT_EVENT_SPEC_0_0_1 = {
22
+ id: 'agent-output',
23
+ version: '0.0.1',
24
+ name: 'Agent Output',
25
+ description: 'Emitted when an agent produces output. Contains timing information, exit status, optional output summary, and error details if applicable.',
26
+ kind: 'agent-output',
27
+ fields: [
28
+ { name: 'agent_runtime_id', label: 'Agent Runtime ID', type: 'string', required: true, description: 'Runtime pod or instance identifier.' },
29
+ { name: 'agent_spec_id', label: 'Agent Spec ID', type: 'string', required: true, description: 'Identifier of the agent specification that was executed.' },
30
+ { name: 'started_at', label: 'Started At', type: 'string', required: true, description: 'ISO 8601 timestamp when the agent started.' },
31
+ { name: 'ended_at', label: 'Ended At', type: 'string', required: true, description: 'ISO 8601 timestamp when the agent ended.' },
32
+ { name: 'duration_ms', label: 'Duration (ms)', type: 'number', required: true, description: 'Total execution time in milliseconds.' },
33
+ { name: 'exit_status', label: 'Exit Status', type: 'string', required: true, description: 'Final status of the agent run (e.g. completed, error).' },
34
+ { name: 'outputs', label: 'Outputs', type: 'string', required: false, description: 'Summary of the agent output or generated artifacts.' },
35
+ { name: 'error_message', label: 'Error Message', type: 'string', required: false, description: 'Error description if the agent run failed.' },
36
+ { name: 'origin', label: 'Origin', type: 'string', required: false, description: 'Producer origin (endpoint, companion, runtime, or agent-runtime).' },
37
+ ],
38
+ };
39
+ export const AGENT_START_REQUESTED_EVENT_SPEC_0_0_1 = {
40
+ id: 'agent-start-requested',
41
+ version: '0.0.1',
42
+ name: 'Agent Start Requested',
43
+ description: 'Emitted when the API endpoint receives a request to start an agent runtime.',
44
+ kind: 'agent-start-requested',
45
+ fields: [
46
+ { name: 'agent_runtime_id', label: 'Agent Runtime ID', type: 'string', required: false, description: 'Runtime pod or instance identifier.' },
47
+ { name: 'started_at', label: 'Requested At', type: 'string', required: false, description: 'ISO 8601 timestamp when the start was requested.' },
48
+ { name: 'origin', label: 'Origin', type: 'string', required: false, description: 'Producer origin (endpoint, companion, runtime, or agent-runtime).' },
71
49
  ],
72
50
  };
73
51
  export const AGENT_STARTED_EVENT_SPEC_0_0_1 = {
@@ -77,41 +55,36 @@ export const AGENT_STARTED_EVENT_SPEC_0_0_1 = {
77
55
  description: 'Emitted when an agent begins execution. Contains the runtime identifier, agent spec, trigger type, and the prompt being executed.',
78
56
  kind: 'agent-started',
79
57
  fields: [
80
- {
81
- name: 'agent_runtime_id',
82
- label: 'Agent Runtime ID',
83
- type: 'string',
84
- required: true,
85
- description: 'Runtime pod or instance identifier.',
86
- },
87
- {
88
- name: 'agent_spec_id',
89
- label: 'Agent Spec ID',
90
- type: 'string',
91
- required: true,
92
- description: 'Identifier of the agent specification being executed.',
93
- },
94
- {
95
- name: 'started_at',
96
- label: 'Started At',
97
- type: 'string',
98
- required: true,
99
- description: 'ISO 8601 timestamp when the agent started.',
100
- },
101
- {
102
- name: 'trigger_type',
103
- label: 'Trigger Type',
104
- type: 'string',
105
- required: true,
106
- description: 'Type of trigger that launched the agent (e.g. once, cron, webhook).',
107
- },
108
- {
109
- name: 'trigger_prompt',
110
- label: 'Trigger Prompt',
111
- type: 'string',
112
- required: false,
113
- description: 'The prompt passed to the agent by the trigger.',
114
- },
58
+ { name: 'agent_runtime_id', label: 'Agent Runtime ID', type: 'string', required: true, description: 'Runtime pod or instance identifier.' },
59
+ { name: 'agent_spec_id', label: 'Agent Spec ID', type: 'string', required: true, description: 'Identifier of the agent specification being executed.' },
60
+ { name: 'started_at', label: 'Started At', type: 'string', required: true, description: 'ISO 8601 timestamp when the agent started.' },
61
+ { name: 'trigger_type', label: 'Trigger Type', type: 'string', required: true, description: 'Type of trigger that launched the agent (e.g. once, cron, webhook).' },
62
+ { name: 'trigger_prompt', label: 'Trigger Prompt', type: 'string', required: false, description: 'The prompt passed to the agent by the trigger.' },
63
+ { name: 'origin', label: 'Origin', type: 'string', required: false, description: 'Producer origin (endpoint, companion, runtime, or agent-runtime).' },
64
+ ],
65
+ };
66
+ export const AGENT_TERMINATED_EVENT_SPEC_0_0_1 = {
67
+ id: 'agent-terminated',
68
+ version: '0.0.1',
69
+ name: 'Agent Terminated',
70
+ description: 'Emitted when an agent runtime is fully terminated.',
71
+ kind: 'agent-terminated',
72
+ fields: [
73
+ { name: 'agent_runtime_id', label: 'Agent Runtime ID', type: 'string', required: true, description: 'Runtime pod or instance identifier.' },
74
+ { name: 'ended_at', label: 'Ended At', type: 'string', required: false, description: 'ISO 8601 timestamp when the runtime termination completed.' },
75
+ { name: 'origin', label: 'Origin', type: 'string', required: false, description: 'Producer origin (endpoint, companion, runtime, or agent-runtime).' },
76
+ ],
77
+ };
78
+ export const AGENT_TERMINATION_REQUESTED_EVENT_SPEC_0_0_1 = {
79
+ id: 'agent-termination-requested',
80
+ version: '0.0.1',
81
+ name: 'Agent Termination Requested',
82
+ description: 'Emitted when the API endpoint receives a request to terminate an agent runtime.',
83
+ kind: 'agent-termination-requested',
84
+ fields: [
85
+ { name: 'agent_runtime_id', label: 'Agent Runtime ID', type: 'string', required: true, description: 'Runtime pod or instance identifier.' },
86
+ { name: 'reason', label: 'Reason', type: 'string', required: false, description: 'Optional reason associated with the termination request.' },
87
+ { name: 'origin', label: 'Origin', type: 'string', required: false, description: 'Producer origin (endpoint, companion, runtime, or agent-runtime).' },
115
88
  ],
116
89
  };
117
90
  export const TOOL_APPROVAL_REQUESTED_EVENT_SPEC_0_0_1 = {
@@ -121,46 +94,31 @@ export const TOOL_APPROVAL_REQUESTED_EVENT_SPEC_0_0_1 = {
121
94
  description: 'Emitted when an agent invokes a tool that requires manual approval before execution. The agent pauses until the request is approved or rejected.',
122
95
  kind: 'tool-approval-requested',
123
96
  fields: [
124
- {
125
- name: 'agent_runtime_id',
126
- label: 'Agent Runtime ID',
127
- type: 'string',
128
- required: true,
129
- description: 'Runtime pod or instance identifier.',
130
- },
131
- {
132
- name: 'agent_spec_id',
133
- label: 'Agent Spec ID',
134
- type: 'string',
135
- required: false,
136
- description: 'Identifier of the agent specification requesting approval.',
137
- },
138
- {
139
- name: 'tool_name',
140
- label: 'Tool Name',
141
- type: 'string',
142
- required: true,
143
- description: 'Name of the tool requiring approval.',
144
- },
145
- {
146
- name: 'tool_args',
147
- label: 'Tool Arguments',
148
- type: 'string',
149
- required: false,
150
- description: 'JSON-serialized arguments passed to the tool.',
151
- },
97
+ { name: 'agent_runtime_id', label: 'Agent Runtime ID', type: 'string', required: true, description: 'Runtime pod or instance identifier.' },
98
+ { name: 'agent_spec_id', label: 'Agent Spec ID', type: 'string', required: false, description: 'Identifier of the agent specification requesting approval.' },
99
+ { name: 'tool_name', label: 'Tool Name', type: 'string', required: true, description: 'Name of the tool requiring approval.' },
100
+ { name: 'tool_args', label: 'Tool Arguments', type: 'string', required: false, description: 'JSON-serialized arguments passed to the tool.' },
101
+ { name: 'origin', label: 'Origin', type: 'string', required: false, description: 'Producer origin (endpoint, companion, runtime, or agent-runtime).' },
152
102
  ],
153
103
  };
154
104
  // Event kind constants for programmatic use
155
- export const EVENT_KIND_AGENT_ENDED = 'agent-ended';
105
+ export const EVENT_KIND_AGENT_ASSIGNED = 'agent-assigned';
106
+ export const EVENT_KIND_AGENT_OUTPUT = 'agent-output';
107
+ export const EVENT_KIND_AGENT_START_REQUESTED = 'agent-start-requested';
156
108
  export const EVENT_KIND_AGENT_STARTED = 'agent-started';
109
+ export const EVENT_KIND_AGENT_TERMINATED = 'agent-terminated';
110
+ export const EVENT_KIND_AGENT_TERMINATION_REQUESTED = 'agent-termination-requested';
157
111
  export const EVENT_KIND_TOOL_APPROVAL_REQUESTED = 'tool-approval-requested';
158
112
  // ============================================================================
159
113
  // Event Catalog
160
114
  // ============================================================================
161
115
  export const EVENT_CATALOG = {
162
- 'agent-ended': AGENT_ENDED_EVENT_SPEC_0_0_1,
116
+ 'agent-assigned': AGENT_ASSIGNED_EVENT_SPEC_0_0_1,
117
+ 'agent-output': AGENT_OUTPUT_EVENT_SPEC_0_0_1,
118
+ 'agent-start-requested': AGENT_START_REQUESTED_EVENT_SPEC_0_0_1,
163
119
  'agent-started': AGENT_STARTED_EVENT_SPEC_0_0_1,
120
+ 'agent-terminated': AGENT_TERMINATED_EVENT_SPEC_0_0_1,
121
+ 'agent-termination-requested': AGENT_TERMINATION_REQUESTED_EVENT_SPEC_0_0_1,
164
122
  'tool-approval-requested': TOOL_APPROVAL_REQUESTED_EVENT_SPEC_0_0_1,
165
123
  };
166
124
  export function getEventSpecs() {
@@ -10,7 +10,7 @@ export const JUPYTER_NOTEBOOK_FRONTEND_TOOL_SPEC_0_0_1 = {
10
10
  version: '0.0.1',
11
11
  name: 'Jupyter Notebook',
12
12
  description: 'Frontend tools for interacting with Jupyter notebooks.',
13
- tags: ['frontend', 'notebook', 'jupyter'],
13
+ tags: ["frontend", "notebook", "jupyter"],
14
14
  enabled: true,
15
15
  toolset: 'all',
16
16
  icon: 'notebook',
@@ -21,7 +21,7 @@ export const LEXICAL_DOCUMENT_FRONTEND_TOOL_SPEC_0_0_1 = {
21
21
  version: '0.0.1',
22
22
  name: 'Lexical Document',
23
23
  description: 'Frontend tools for interacting with Lexical documents.',
24
- tags: ['frontend', 'document', 'lexical'],
24
+ tags: ["frontend", "document", "lexical"],
25
25
  enabled: true,
26
26
  toolset: 'all',
27
27
  icon: 'file',
@@ -7,12 +7,19 @@
7
7
  * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
8
8
  */
9
9
  import type { GuardrailSpec } from '../types';
10
+ export declare const ASYNC_GUARDRAIL_POLICY_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
11
+ export declare const BLOCKED_KEYWORDS_INTERNAL_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
10
12
  export declare const DATA_ENGINEERING_POWER_USER_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
11
13
  export declare const DEFAULT_PLATFORM_USER_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
12
14
  export declare const GITHUB_ACTIONS_DEPLOY_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
13
15
  export declare const GITHUB_CI_BOT_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
14
16
  export declare const GOOGLE_WORKSPACE_AGENT_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
17
+ export declare const NO_REFUSALS_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
18
+ export declare const PII_PROTECTION_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
19
+ export declare const PROMPT_INJECTION_STRICT_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
15
20
  export declare const RESTRICTED_VIEWER_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
21
+ export declare const SECRET_REDACTION_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
22
+ export declare const TOOL_GUARD_STRICT_GUARDRAIL_SPEC_0_0_1: GuardrailSpec;
16
23
  export declare const GUARDRAIL_CATALOG: Record<string, GuardrailSpec>;
17
24
  /**
18
25
  * Map identity provider to an icon key for the UI.