@datalayer/agent-runtimes 1.6.9 → 1.6.12

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.
@@ -28,6 +28,7 @@ export const BACKEND_TOOL_ACTIONS = {
28
28
  'generate-haiku': ['read'],
29
29
  'generate-task-steps': ['read'],
30
30
  'get-weather': ['read'],
31
+ 'github-repositories': ['read'],
31
32
  'runtime-echo': ['read'],
32
33
  'runtime-send-mail': ['send'],
33
34
  'runtime-sensitive-echo': ['read'],
@@ -38,6 +39,12 @@ export const BACKEND_TOOL_ACTIONS = {
38
39
  * names were read off the running server; absent when nobody looked.
39
40
  */
40
41
  export const SERVER_ACTIONS = {
42
+ 'agentcore-gateway-example': {
43
+ default: [],
44
+ tools: {},
45
+ conditions: {},
46
+ signs: {},
47
+ },
41
48
  alphavantage: {
42
49
  default: [],
43
50
  tools: {},
@@ -4,7 +4,7 @@
4
4
  */
5
5
  import { ALPHAVANTAGE_MCP_SERVER_0_0_1, BLUESKY_MCP_SERVER_0_0_1, CHART_MCP_SERVER_0_0_1, DISCORD_MCP_SERVER_0_0_1, EARTHDATA_MCP_SERVER_0_0_1, EURUS_MCP_SERVER_0_0_1, FILESYSTEM_MCP_SERVER_0_0_1, GITHUB_MCP_SERVER_0_0_1, GOOGLE_WORKSPACE_MCP_SERVER_0_0_1, HUGGINGFACE_MCP_SERVER_0_0_1, KAGGLE_MCP_SERVER_0_0_1, LINKEDIN_MCP_SERVER_0_0_1, ODOO_MCP_SERVER_0_0_1, ODOO_ACCOUNTING_MCP_SERVER_0_0_1, SALESFORCE_MCP_SERVER_0_0_1, SLACK_MCP_SERVER_0_0_1, TAVILY_MCP_SERVER_0_0_1, X_MCP_SERVER_0_0_1, } from '../mcpServers.js';
6
6
  import { ACCOUNTING_SKILL_SPEC_0_0_1, CRAWL_SKILL_SPEC_0_0_1, EVENTS_SKILL_SPEC_0_0_1, GITHUB_SKILL_SPEC_0_0_1, IMAGE_SKILL_SPEC_0_0_1, JOKES_SKILL_SPEC_0_0_1, PDF_SKILL_SPEC_0_0_1, TEXT_SUMMARIZER_SKILL_SPEC_0_0_1, VIDEO_SKILL_SPEC_0_0_1, } from '../skills.js';
7
- import { DECIDE_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_CREATE_PLAN_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_CURRENT_TIME_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_DISPLAY_RECIPE_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_GENERATE_HAIKU_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_GENERATE_TASK_STEPS_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_GET_WEATHER_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_RENDER_A2UI_SURFACE_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_UPDATE_PLAN_STEP_BACKEND_TOOL_SPEC_0_0_1, RUNTIME_ECHO_BACKEND_TOOL_SPEC_0_0_1, RUNTIME_SEND_MAIL_BACKEND_TOOL_SPEC_0_0_1, RUNTIME_SENSITIVE_ECHO_BACKEND_TOOL_SPEC_0_0_1, } from '../backendTools.js';
7
+ import { DECIDE_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_CREATE_PLAN_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_CURRENT_TIME_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_DISPLAY_RECIPE_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_GENERATE_HAIKU_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_GENERATE_TASK_STEPS_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_GET_WEATHER_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_RENDER_A2UI_SURFACE_BACKEND_TOOL_SPEC_0_0_1, EXAMPLE_UPDATE_PLAN_STEP_BACKEND_TOOL_SPEC_0_0_1, GITHUB_REPOSITORIES_BACKEND_TOOL_SPEC_0_0_1, RUNTIME_ECHO_BACKEND_TOOL_SPEC_0_0_1, RUNTIME_SEND_MAIL_BACKEND_TOOL_SPEC_0_0_1, RUNTIME_SENSITIVE_ECHO_BACKEND_TOOL_SPEC_0_0_1, } from '../backendTools.js';
8
8
  import { ARENA_INVADERS_FRONTEND_TOOL_SPEC_0_0_1, ARENA_PONG_FRONTEND_TOOL_SPEC_0_0_1, CELLS_FRONTEND_TOOL_SPEC_0_0_1, DECKS_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_EDIT_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_PROPOSE_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_READ_FRONTEND_TOOL_SPEC_0_0_1, JUPYTER_NOTEBOOK_FRONTEND_TOOL_SPEC_0_0_1, LEXICAL_DOCUMENT_FRONTEND_TOOL_SPEC_0_0_1, } from '../frontendTools.js';
9
9
  // ============================================================================
10
10
  // MCP Server Lookup
@@ -79,6 +79,8 @@ function toAgentSkillSpec(skill) {
79
79
  tags: skill.tags,
80
80
  enabled: skill.enabled,
81
81
  requiredEnvVars: skill.requiredEnvVars,
82
+ icon: skill.icon,
83
+ emoji: skill.emoji,
82
84
  };
83
85
  }
84
86
  /**
@@ -103,6 +105,8 @@ const TOOL_MAP = {
103
105
  'example-render-a2ui-surface': EXAMPLE_RENDER_A2UI_SURFACE_BACKEND_TOOL_SPEC_0_0_1,
104
106
  'example-update-plan-step:0.0.1': EXAMPLE_UPDATE_PLAN_STEP_BACKEND_TOOL_SPEC_0_0_1,
105
107
  'example-update-plan-step': EXAMPLE_UPDATE_PLAN_STEP_BACKEND_TOOL_SPEC_0_0_1,
108
+ 'github-repositories:0.0.1': GITHUB_REPOSITORIES_BACKEND_TOOL_SPEC_0_0_1,
109
+ 'github-repositories': GITHUB_REPOSITORIES_BACKEND_TOOL_SPEC_0_0_1,
106
110
  'runtime-echo:0.0.1': RUNTIME_ECHO_BACKEND_TOOL_SPEC_0_0_1,
107
111
  'runtime-echo': RUNTIME_ECHO_BACKEND_TOOL_SPEC_0_0_1,
108
112
  'runtime-send-mail:0.0.1': RUNTIME_SEND_MAIL_BACKEND_TOOL_SPEC_0_0_1,
@@ -11035,7 +11039,7 @@ export const WORKER_MARKETER_AGENTSPEC_0_0_1 = {
11035
11039
  ? toAgentSkillSpec(SKILL_MAP['datalayer-memory-delete:0.0.1'])
11036
11040
  : undefined,
11037
11041
  ].filter(Boolean),
11038
- backendTools: [],
11042
+ backendTools: [TOOL_MAP['github-repositories:0.0.1']],
11039
11043
  frontendTools: [],
11040
11044
  environmentName: 'ai-agents-env',
11041
11045
  icon: 'megaphone',
@@ -22,6 +22,7 @@ export declare const EXAMPLE_UPDATE_PLAN_STEP_BACKEND_TOOL_SPEC_0_0_1: BackendTo
22
22
  export declare const GENERATE_HAIKU_BACKEND_TOOL_SPEC_0_0_1: BackendToolSpec;
23
23
  export declare const GENERATE_TASK_STEPS_BACKEND_TOOL_SPEC_0_0_1: BackendToolSpec;
24
24
  export declare const GET_WEATHER_BACKEND_TOOL_SPEC_0_0_1: BackendToolSpec;
25
+ export declare const GITHUB_REPOSITORIES_BACKEND_TOOL_SPEC_0_0_1: BackendToolSpec;
25
26
  export declare const RUNTIME_ECHO_BACKEND_TOOL_SPEC_0_0_1: BackendToolSpec;
26
27
  export declare const RUNTIME_SEND_MAIL_BACKEND_TOOL_SPEC_0_0_1: BackendToolSpec;
27
28
  export declare const RUNTIME_SENSITIVE_ECHO_BACKEND_TOOL_SPEC_0_0_1: BackendToolSpec;
@@ -275,6 +275,24 @@ export const GET_WEATHER_BACKEND_TOOL_SPEC_0_0_1 = {
275
275
  icon: '@primer/octicons-react:sun',
276
276
  emoji: '🌤️',
277
277
  };
278
+ export const GITHUB_REPOSITORIES_BACKEND_TOOL_SPEC_0_0_1 = {
279
+ id: 'github-repositories',
280
+ version: '0.0.1',
281
+ name: 'GitHub Repositories',
282
+ description: "List the GitHub repositories of the person the agent works for, with the person's own GitHub grant; the first time, the person is asked to connect GitHub in the chat.",
283
+ tags: ['github', 'identity'],
284
+ enabled: true,
285
+ approval: 'auto',
286
+ timeout: undefined,
287
+ requiresApproval: false,
288
+ runtime: {
289
+ language: 'python',
290
+ package: 'agent_runtimes.tools.github',
291
+ method: 'github_repositories',
292
+ },
293
+ icon: '@primer/octicons-react:mark-github',
294
+ emoji: '🐙',
295
+ };
278
296
  export const RUNTIME_ECHO_BACKEND_TOOL_SPEC_0_0_1 = {
279
297
  id: 'runtime-echo',
280
298
  version: '0.0.1',
@@ -366,6 +384,7 @@ export const BACKEND_TOOL_CATALOG = {
366
384
  'generate-haiku': GENERATE_HAIKU_BACKEND_TOOL_SPEC_0_0_1,
367
385
  'generate-task-steps': GENERATE_TASK_STEPS_BACKEND_TOOL_SPEC_0_0_1,
368
386
  'get-weather': GET_WEATHER_BACKEND_TOOL_SPEC_0_0_1,
387
+ 'github-repositories': GITHUB_REPOSITORIES_BACKEND_TOOL_SPEC_0_0_1,
369
388
  'runtime-echo': RUNTIME_ECHO_BACKEND_TOOL_SPEC_0_0_1,
370
389
  'runtime-send-mail': RUNTIME_SEND_MAIL_BACKEND_TOOL_SPEC_0_0_1,
371
390
  'runtime-sensitive-echo': RUNTIME_SENSITIVE_ECHO_BACKEND_TOOL_SPEC_0_0_1,
package/lib/specs/cogs.js CHANGED
@@ -35,6 +35,8 @@ function toAgentSkillSpec(skill) {
35
35
  tags: skill.tags,
36
36
  enabled: skill.enabled,
37
37
  requiredEnvVars: skill.requiredEnvVars,
38
+ icon: skill.icon,
39
+ emoji: skill.emoji,
38
40
  };
39
41
  }
40
42
  /**
@@ -248,6 +250,7 @@ Check your output against every Guard before you hand it over, and say which you
248
250
  toolHooks: undefined,
249
251
  parameters: undefined,
250
252
  subagents: undefined,
253
+ identity: 'web-bot-auth-agent',
251
254
  };
252
255
  const COG_CUSTOMER_INTERVIEWER_AGENTSPEC_0_0_1 = {
253
256
  id: 'cog-customer-interviewer',
@@ -435,6 +438,7 @@ Check your output against every Guard before you hand it over, and say which you
435
438
  required: ['research_goal'],
436
439
  },
437
440
  subagents: undefined,
441
+ identity: 'datalayer-acting-agent',
438
442
  };
439
443
  const COG_SALES_PIPELINE_BOARD_REPORT_AGENTSPEC_0_0_1 = {
440
444
  id: 'cog-sales-pipeline-board-report',
@@ -593,6 +597,7 @@ Check your output against every Guard before you hand it over, and say which you
593
597
  toolHooks: undefined,
594
598
  parameters: undefined,
595
599
  subagents: undefined,
600
+ identity: 'datalayer-acting-agent',
596
601
  };
597
602
  // ============================================================================
598
603
  // Cog Catalog
@@ -226,7 +226,7 @@ export const TAVILY_API_KEY_SPEC_0_0_1 = {
226
226
  version: '0.0.1',
227
227
  name: 'Tavily API Key',
228
228
  description: 'API key for Tavily web search and research capabilities. Required for web crawling, content extraction, and search operations.',
229
- registrationUrl: 'https://tavily.com/api-keys',
229
+ registrationUrl: 'https://app.tavily.com/home',
230
230
  tags: ['authentication', 'api-key', 'search', 'web', 'research'],
231
231
  icon: 'key',
232
232
  emoji: '🔑',
@@ -7,6 +7,7 @@
7
7
  * DO NOT EDIT MANUALLY - run 'make specs' to regenerate.
8
8
  */
9
9
  import type { MCPServer } from '../types';
10
+ export declare const AGENTCORE_GATEWAY_EXAMPLE_MCP_SERVER_0_0_1: MCPServer;
10
11
  export declare const ALPHAVANTAGE_MCP_SERVER_0_0_1: MCPServer;
11
12
  export declare const BLUESKY_MCP_SERVER_0_0_1: MCPServer;
12
13
  export declare const CHART_MCP_SERVER_0_0_1: MCPServer;
@@ -5,6 +5,34 @@
5
5
  // ============================================================================
6
6
  // MCP Server Definitions
7
7
  // ============================================================================
8
+ export const AGENTCORE_GATEWAY_EXAMPLE_MCP_SERVER_0_0_1 = {
9
+ id: 'agentcore-gateway-example',
10
+ version: '0.0.1',
11
+ name: 'AgentCore Gateway (example)',
12
+ description: "An Amazon Bedrock AgentCore Gateway, its targets as MCP tools — copy it with your gateway's URL",
13
+ icon: '@primer/octicons-react:plug',
14
+ emoji: '🔌',
15
+ url: 'https://example-gateway-a1b2c3d4e5.gateway.bedrock-agentcore.us-east-1.amazonaws.com/mcp',
16
+ args: [],
17
+ auth: { kind: 'agentcore-gateway', identity: 'aws-agentcore-gateway' },
18
+ transport: 'streamable-http',
19
+ enabled: false,
20
+ isAvailable: false,
21
+ tools: [],
22
+ requiredEnvVars: [],
23
+ tags: ['aws', 'agentcore', 'gateway'],
24
+ documentationUrl: 'https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/gateway.html',
25
+ setup: "Copy this spec with your gateway's MCP URL. The gateway's inbound authorizer trusts Datalayer IAM ([the aws-agentcore-gateway identity](https://agentspecs.datalayer.tech/identities)): the runtime sends the token it obtains for the run as the bearer, and no key is written here.",
26
+ install: {
27
+ type: 'remote',
28
+ command: '',
29
+ note: 'Nothing to install: an AgentCore Gateway in your AWS account, reached at its URL with a token Datalayer IAM signs.',
30
+ },
31
+ actions: {
32
+ tools: {},
33
+ note: "A gateway's tools are its targets, the organization's own: list them on the running gateway and class each one in your copy of this spec.",
34
+ },
35
+ };
8
36
  export const ALPHAVANTAGE_MCP_SERVER_0_0_1 = {
9
37
  id: 'alphavantage',
10
38
  version: '0.0.1',
@@ -26,6 +54,11 @@ export const ALPHAVANTAGE_MCP_SERVER_0_0_1 = {
26
54
  signupUrl: 'https://www.alphavantage.co/support/#api-key',
27
55
  apiKeyUrl: 'https://www.alphavantage.co/support/#api-key',
28
56
  setup: "A free key, sent by email from [Alpha Vantage's support page](https://www.alphavantage.co/support/#api-key); put it in `ALPHAVANTAGE_API_KEY`. The API is documented [there](https://www.alphavantage.co/documentation/).",
57
+ install: {
58
+ type: 'python',
59
+ command: 'uv tool install av-mcp==0.2.1',
60
+ note: 'Needs uv (`pip install uv`); the runtime image installs it the same way. It starts as `uvx av-mcp==0.2.1`.',
61
+ },
29
62
  actions: {
30
63
  tools: {},
31
64
  note: 'Not read off the running server yet: its tools are unknown, and unknown is the most restricted. Run the server, list its tools, and class each one here.',
@@ -40,7 +73,9 @@ export const BLUESKY_MCP_SERVER_0_0_1 = {
40
73
  emoji: '🦋',
41
74
  url: '',
42
75
  command: 'node',
43
- args: ['/opt/mcp-servers/bsky-mcp-server/build/src/index.js'],
76
+ args: [
77
+ '${BLUESKY_MCP_SERVER_DIR:-/opt/mcp-servers/bsky-mcp-server}/build/src/index.js',
78
+ ],
44
79
  transport: 'stdio',
45
80
  enabled: true,
46
81
  isAvailable: false,
@@ -60,6 +95,11 @@ export const BLUESKY_MCP_SERVER_0_0_1 = {
60
95
  signupUrl: 'https://bsky.app',
61
96
  apiKeyUrl: 'https://bsky.app/settings/app-passwords',
62
97
  setup: "Sign in to [Bluesky](https://bsky.app), make an [app password](https://bsky.app/settings/app-passwords) under Settings, Privacy and security, App passwords, and put the account's handle in `BLUESKY_IDENTIFIER`, the app password in `BLUESKY_APP_PASSWORD` and `https://bsky.social` in `BLUESKY_SERVICE_URL`; the server is built into the runtime image and runs with node.",
98
+ install: {
99
+ type: 'git',
100
+ command: 'git clone --depth 1 https://github.com/brianellin/bsky-mcp-server ~/.local/share/mcp-servers/bsky-mcp-server && cd ~/.local/share/mcp-servers/bsky-mcp-server && npm install && npm run build',
101
+ note: 'Not on npm: built from its repository with Node.js. Then `export BLUESKY_MCP_SERVER_DIR=~/.local/share/mcp-servers/bsky-mcp-server`; without it the server is looked for where the runtime image builds it, /opt/mcp-servers/bsky-mcp-server.',
102
+ },
63
103
  actions: {
64
104
  tools: {
65
105
  'get-pinned-feeds': 'read',
@@ -103,6 +143,11 @@ export const CHART_MCP_SERVER_0_0_1 = {
103
143
  tags: ['visualization', 'charts', 'graphics'],
104
144
  documentationUrl: 'https://github.com/antvis/mcp-server-chart',
105
145
  setup: 'Runs with `npx`; no account and no key ([mcp-server-chart](https://github.com/antvis/mcp-server-chart)).',
146
+ install: {
147
+ type: 'npm',
148
+ command: 'npm install -g @antv/mcp-server-chart',
149
+ note: 'Needs Node.js; `npx -y` also fetches it at start.',
150
+ },
106
151
  actions: {
107
152
  tools: {
108
153
  generate_area_chart: 'read',
@@ -157,6 +202,11 @@ export const DATALAYER_MCP_SERVER_0_0_1 = {
157
202
  signupUrl: 'https://datalayer.ai/signin',
158
203
  apiKeyUrl: 'https://datalayer.ai/settings/api-keys',
159
204
  setup: "Datalayer's own gateway, reached at its url with your Datalayer API key as the bearer: create one under [Settings, API keys](https://datalayer.ai/settings/api-keys) and put it in `DATALAYER_API_KEY`.",
205
+ install: {
206
+ type: 'remote',
207
+ command: '',
208
+ note: "Nothing to install: Datalayer's MCP gateway, reached at its URL with your DATALAYER_API_KEY.",
209
+ },
160
210
  actions: {
161
211
  tools: {
162
212
  read_notebook: 'read',
@@ -353,6 +403,11 @@ export const DISCORD_MCP_SERVER_0_0_1 = {
353
403
  signupUrl: 'https://discord.com/developers/applications',
354
404
  apiKeyUrl: 'https://discord.com/developers/applications',
355
405
  setup: "Create an application in the [Discord Developer Portal](https://discord.com/developers/applications), add a bot, copy its token into `DISCORD_BOT_TOKEN`, invite the bot to the server with the permissions of what the agent may do (and the Message Content intent to read messages); put the server's id in `DISCORD_GUILD_ID`. The server runs in Docker, [saseq/discord-mcp](https://github.com/SaseQ/discord-mcp).",
406
+ install: {
407
+ type: 'docker',
408
+ command: 'docker pull saseq/discord-mcp:latest',
409
+ note: 'Needs Docker where the agent runs; the runtime image has none, so it stays off on the platform.',
410
+ },
356
411
  actions: {
357
412
  tools: {
358
413
  get_server_info: 'read',
@@ -462,6 +517,11 @@ export const EARTHDATA_MCP_SERVER_0_0_1 = {
462
517
  signupUrl: 'https://urs.earthdata.nasa.gov/users/new',
463
518
  apiKeyUrl: 'https://datalayer.ai/settings/api-keys',
464
519
  setup: "Searching NASA's catalogue is anonymous, through Datalayer's gateway with your [Datalayer API key](https://datalayer.ai/settings/api-keys); a download runs in the code sandbox with an [Earthdata Login](https://urs.earthdata.nasa.gov/users/new) (`EARTHDATA_USERNAME`, `EARTHDATA_PASSWORD`).",
520
+ install: {
521
+ type: 'remote',
522
+ command: '',
523
+ note: "Nothing to install: Datalayer's MCP gateway with its earthdata toolset, reached at its URL.",
524
+ },
465
525
  actions: {
466
526
  tools: {
467
527
  search_earth_datasets: 'read',
@@ -489,6 +549,11 @@ export const EURUS_MCP_SERVER_0_0_1 = {
489
549
  requiredEnvVars: [],
490
550
  tags: ['geospatial', 'climate', 'analysis'],
491
551
  setup: 'Runs the `eurus-mcp` command where it is installed; no account and no key.',
552
+ install: {
553
+ type: 'other',
554
+ command: '',
555
+ note: 'Runs the `eurus-mcp` command, from a package that is not published: install it where the agent runs from its source.',
556
+ },
492
557
  actions: {
493
558
  tools: {},
494
559
  note: 'Not read off the running server yet: its tools are unknown, and unknown is the most restricted. Run the server, list its tools, and class each one here.',
@@ -512,6 +577,11 @@ export const FILESYSTEM_MCP_SERVER_0_0_1 = {
512
577
  tags: ['files', 'local', 'storage'],
513
578
  documentationUrl: 'https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem',
514
579
  setup: "Runs with `npx` on the runtime's own files; no account and no key ([the reference server](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem)).",
580
+ install: {
581
+ type: 'npm',
582
+ command: 'npm install -g @modelcontextprotocol/server-filesystem',
583
+ note: 'Needs Node.js; `npx -y` also fetches it at start.',
584
+ },
515
585
  actions: {
516
586
  tools: {
517
587
  read_file: 'read',
@@ -561,6 +631,11 @@ export const GITHUB_MCP_SERVER_0_0_1 = {
561
631
  signupUrl: 'https://github.com/signup',
562
632
  apiKeyUrl: 'https://github.com/settings/tokens',
563
633
  setup: 'A [personal access token](https://github.com/settings/tokens) with the scopes of what the agent may do, in `GITHUB_TOKEN`; the server runs in Docker, see [github-mcp-server](https://github.com/github/github-mcp-server).',
634
+ install: {
635
+ type: 'docker',
636
+ command: 'docker pull ghcr.io/github/github-mcp-server',
637
+ note: 'Needs Docker where the agent runs.',
638
+ },
564
639
  actions: {
565
640
  tools: {},
566
641
  note: 'Not read off the running server yet: its tools are unknown, and unknown is the most restricted. Run the server, list its tools, and class each one here.',
@@ -599,6 +674,11 @@ export const GOOGLE_WORKSPACE_MCP_SERVER_0_0_1 = {
599
674
  signupUrl: 'https://console.cloud.google.com/',
600
675
  apiKeyUrl: 'https://console.cloud.google.com/apis/credentials',
601
676
  setup: "An OAuth client in a Google Cloud project, from [APIs and services, Credentials](https://console.cloud.google.com/apis/credentials) (`GOOGLE_OAUTH_CLIENT_ID` and `GOOGLE_OAUTH_CLIENT_SECRET`); Datalayer mints the person's token per call. See [workspace-mcp](https://github.com/taylorwilsdon/google_workspace_mcp).",
677
+ install: {
678
+ type: 'python',
679
+ command: 'uv tool install workspace-mcp',
680
+ note: 'Needs uv (`pip install uv`); the runtime image installs it the same way.',
681
+ },
602
682
  actions: {
603
683
  tools: {
604
684
  start_google_auth: 'write',
@@ -746,6 +826,11 @@ export const HUGGINGFACE_MCP_SERVER_0_0_1 = {
746
826
  signupUrl: 'https://huggingface.co/join',
747
827
  apiKeyUrl: 'https://huggingface.co/settings/tokens',
748
828
  setup: "A read token from your [Hugging Face settings](https://huggingface.co/settings/tokens), in `HF_TOKEN`; the server is Hugging Face's own, reached at its url ([docs](https://huggingface.co/docs/hub/mcp)).",
829
+ install: {
830
+ type: 'remote',
831
+ command: '',
832
+ note: "Nothing to install: Hugging Face's hosted MCP server, reached at its URL.",
833
+ },
749
834
  actions: {
750
835
  tools: {},
751
836
  note: 'Not read off the running server yet: its tools are unknown, and unknown is the most restricted. Run the server, list its tools, and class each one here.',
@@ -771,6 +856,11 @@ export const KAGGLE_MCP_SERVER_0_0_1 = {
771
856
  signupUrl: 'https://www.kaggle.com/account/login',
772
857
  apiKeyUrl: 'https://www.kaggle.com/settings/account',
773
858
  setup: "An API token from your [Kaggle account settings](https://www.kaggle.com/settings/account), in `KAGGLE_API_TOKEN`; the server is Kaggle's own, reached at its url ([docs](https://www.kaggle.com/docs/api)).",
859
+ install: {
860
+ type: 'remote',
861
+ command: '',
862
+ note: "Nothing to install: Kaggle's hosted MCP server, reached at its URL.",
863
+ },
774
864
  actions: {
775
865
  tools: {},
776
866
  note: 'Not read off the running server yet: its tools are unknown, and unknown is the most restricted. Run the server, list its tools, and class each one here.',
@@ -797,6 +887,11 @@ export const LINKEDIN_MCP_SERVER_0_0_1 = {
797
887
  signupUrl: 'https://www.linkedin.com/signup',
798
888
  apiKeyUrl: 'https://github.com/stickerdaniel/linkedin-mcp-server#installation',
799
889
  setup: 'No key: the server uses a signed-in browser session. On your own machine, run `uvx mcp-server-linkedin --login` once (or `--import-from-browser`) and it keeps the session under `~/.linkedin-mcp`; a runtime needs that directory mounted — see [its README](https://github.com/stickerdaniel/linkedin-mcp-server#installation). LinkedIn restricts automated access: use an account you can afford to see restricted.',
890
+ install: {
891
+ type: 'python',
892
+ command: 'uv tool install --python 3.12 mcp-server-linkedin',
893
+ note: 'Needs uv (`pip install uv`); the runtime image installs it the same way. It reads a signed-in browser session mounted at ~/.linkedin-mcp.',
894
+ },
800
895
  actions: {
801
896
  tools: {
802
897
  get_person_profile: 'read',
@@ -849,6 +944,11 @@ export const ODOO_ACCOUNTING_MCP_SERVER_0_0_1 = {
849
944
  signupUrl: 'https://datalayer.ai/signin',
850
945
  apiKeyUrl: 'https://datalayer.ai/settings/api-keys',
851
946
  setup: "Datalayer's gateway with its odoo-accounting toolset: your Datalayer API key as the bearer, made under [Settings, API keys](https://datalayer.ai/settings/api-keys) and put in `DATALAYER_API_KEY`; your Odoo in your Datalayer secrets (`DATALAYER_ODOO_URL`, `DATALAYER_ODOO_API_KEY`, and `DATALAYER_ODOO_DATABASE` when the host does not name it). One company per session: your default in Odoo, or the one the url names with `&odoo-company=<name or id>`.",
947
+ install: {
948
+ type: 'remote',
949
+ command: '',
950
+ note: "Nothing to install: Datalayer's MCP gateway with its odoo-accounting toolset, reached at its URL.",
951
+ },
852
952
  actions: {
853
953
  tools: {
854
954
  odoo_accounting_list_invoices: 'read',
@@ -937,6 +1037,11 @@ export const ODOO_MCP_SERVER_0_0_1 = {
937
1037
  signupUrl: 'https://datalayer.ai/signin',
938
1038
  apiKeyUrl: 'https://datalayer.ai/settings/api-keys',
939
1039
  setup: "Datalayer's gateway with its generic odoo toolset: your Datalayer API key as the bearer, made under [Settings, API keys](https://datalayer.ai/settings/api-keys) and put in `DATALAYER_API_KEY`; your Odoo in your Datalayer secrets (`DATALAYER_ODOO_URL`, `DATALAYER_ODOO_API_KEY`, and `DATALAYER_ODOO_DATABASE` when the host does not name it). One company per session: your default in Odoo, or the one the url names with `&odoo-company=<name or id>`.",
1040
+ install: {
1041
+ type: 'remote',
1042
+ command: '',
1043
+ note: "Nothing to install: Datalayer's MCP gateway with its odoo toolset, reached at its URL.",
1044
+ },
940
1045
  actions: {
941
1046
  tools: {
942
1047
  odoo_get_context: 'read',
@@ -984,6 +1089,11 @@ export const SALESFORCE_MCP_SERVER_0_0_1 = {
984
1089
  signupUrl: 'https://developer.salesforce.com/signup',
985
1090
  apiKeyUrl: 'https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/quickstart_oauth.htm',
986
1091
  setup: 'An access token and the instance url (`SALESFORCE_ACCESS_TOKEN`, `SALESFORCE_INSTANCE_URL`) from a [connected app](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/quickstart_oauth.htm) of your org; [sign up](https://developer.salesforce.com/signup) for a developer org if you have none.',
1092
+ install: {
1093
+ type: 'npm',
1094
+ command: 'npm install -g @anthropic/salesforce-mcp-server',
1095
+ note: 'Needs Node.js; `npx -y` also fetches it at start.',
1096
+ },
987
1097
  actions: {
988
1098
  tools: {},
989
1099
  note: 'Not read off the running server yet: its tools are unknown, and unknown is the most restricted. Run the server, list its tools, and class each one here.',
@@ -1018,6 +1128,11 @@ export const SLACK_MCP_SERVER_0_0_1 = {
1018
1128
  signupUrl: 'https://slack.com/get-started',
1019
1129
  apiKeyUrl: 'https://api.slack.com/apps',
1020
1130
  setup: "A [Slack app](https://api.slack.com/apps) with a bot token (`SLACK_BOT_TOKEN`), the workspace id (`SLACK_TEAM_ID`) and the channels it may read (`SLACK_CHANNEL_IDS`); see [Slack's docs](https://api.slack.com/docs).",
1131
+ install: {
1132
+ type: 'npm',
1133
+ command: 'npm install -g @datalayer/slack-mcp-server',
1134
+ note: 'Needs Node.js; `npx -y` also fetches it at start.',
1135
+ },
1021
1136
  actions: {
1022
1137
  tools: {
1023
1138
  slack_list_channels: 'read',
@@ -1054,6 +1169,11 @@ export const TAVILY_MCP_SERVER_0_0_1 = {
1054
1169
  signupUrl: 'https://app.tavily.com',
1055
1170
  apiKeyUrl: 'https://app.tavily.com/home',
1056
1171
  setup: 'A key from the [Tavily dashboard](https://app.tavily.com/home), in `TAVILY_API_KEY`; the docs are at [docs.tavily.com](https://docs.tavily.com).',
1172
+ install: {
1173
+ type: 'npm',
1174
+ command: 'npm install -g tavily-mcp',
1175
+ note: 'Needs Node.js; `npx -y` also fetches it at start.',
1176
+ },
1057
1177
  actions: {
1058
1178
  tools: {
1059
1179
  tavily_search: 'read',
@@ -1086,6 +1206,11 @@ export const X_MCP_SERVER_0_0_1 = {
1086
1206
  signupUrl: 'https://developer.x.com',
1087
1207
  apiKeyUrl: 'https://developer.x.com/en/portal/dashboard',
1088
1208
  setup: "Create an app in the [X Developer Portal](https://developer.x.com/en/portal/dashboard), copy its App-only Bearer Token from **Keys and tokens** into `X_BEARER_TOKEN`; the runtime reaches [https://api.x.com/mcp](https://api.x.com/mcp) with it and reads. For bookmarks and articles, run the [xurl bridge](https://docs.x.com/tools/mcp) on a machine with a browser instead, with the app's `CLIENT_ID` and `CLIENT_SECRET`.",
1209
+ install: {
1210
+ type: 'remote',
1211
+ command: '',
1212
+ note: "Nothing to install: X's hosted MCP server, reached at https://api.x.com/mcp with your X_BEARER_TOKEN.",
1213
+ },
1089
1214
  actions: {
1090
1215
  tools: {},
1091
1216
  note: "Read off X's documentation, not the running server: posts, search, users, news and trends are reads; bookmarks are read and written; articles are drafted and published (`article_publish` is the one tool named there). A server not read off classes nothing: run it, list its tools, and class each one here.",
@@ -1095,6 +1220,7 @@ export const X_MCP_SERVER_0_0_1 = {
1095
1220
  // MCP Server Library
1096
1221
  // ============================================================================
1097
1222
  export const MCP_SERVER_LIBRARY = {
1223
+ 'agentcore-gateway-example': AGENTCORE_GATEWAY_EXAMPLE_MCP_SERVER_0_0_1,
1098
1224
  alphavantage: ALPHAVANTAGE_MCP_SERVER_0_0_1,
1099
1225
  bluesky: BLUESKY_MCP_SERVER_0_0_1,
1100
1226
  chart: CHART_MCP_SERVER_0_0_1,
@@ -8,6 +8,11 @@
8
8
  */
9
9
  import type { PolicySpec } from '../types/agentspecs';
10
10
  export declare const DEFAULT_POLICY_0_0_1: PolicySpec;
11
+ export declare const DOGWOOD_APPROVAL_BEFORE_PAYMENT_POLICY_0_0_1: PolicySpec;
12
+ export declare const DOGWOOD_DISTINCT_PAYEES_POLICY_0_0_1: PolicySpec;
13
+ export declare const DOGWOOD_RUNNING_TOTAL_POLICY_0_0_1: PolicySpec;
14
+ export declare const DOGWOOD_SPEND_PER_SESSION_POLICY_0_0_1: PolicySpec;
15
+ export declare const DOGWOOD_TRANSFERS_PER_HOUR_POLICY_0_0_1: PolicySpec;
11
16
  export declare const ORGANIZATION_BASELINE_POLICY_0_0_1: PolicySpec;
12
17
  export declare const POLICY_CATALOGUE: Record<string, PolicySpec>;
13
18
  /** A policy by id. */
@@ -139,6 +139,86 @@ export const DEFAULT_POLICY_0_0_1 = {
139
139
  },
140
140
  },
141
141
  };
142
+ export const DOGWOOD_APPROVAL_BEFORE_PAYMENT_POLICY_0_0_1 = {
143
+ id: 'dogwood-approval-before-payment',
144
+ version: '0.0.1',
145
+ name: 'Approval before a payment',
146
+ description: 'An example of a Dogwood set an administrator writes for the organization: a payment is permitted only when an approval of the same invoice completed in the session within the hour before it; every other action is left to the rules. Deny by default: without the approval, the payment is refused.',
147
+ enabled: false,
148
+ tags: ['policy', 'organization', 'dogwood', 'example'],
149
+ policy: {
150
+ scope: 'organization',
151
+ version: 1,
152
+ dogwood: {
153
+ mode: 'enforce',
154
+ policies: '@id("everything but a payment")\npermit (principal, action, resource)\nunless { action == Datalayer::Action::"payments___pay" };\n\n@id("a payment needs its invoice approved within the hour")\npermit (principal, action == Datalayer::Action::"payments___pay", resource)\nwhen temporal {\n formerly within 1h Datalayer::Action::"payments___approve"::response{\n eventResource: resource,\n input.invoice: context.input.invoice\n }\n};\n',
155
+ },
156
+ },
157
+ };
158
+ export const DOGWOOD_DISTINCT_PAYEES_POLICY_0_0_1 = {
159
+ id: 'dogwood-distinct-payees',
160
+ version: '0.0.1',
161
+ name: 'At most three payees a day',
162
+ description: 'An example of a Dogwood set for the organization: a transfer to a fourth distinct payee within 24 hours of the session is refused; paying the same payee again counts once. A distinct count: the domain names the payee, not the timepoint.',
163
+ enabled: false,
164
+ tags: ['policy', 'organization', 'dogwood', 'example'],
165
+ policy: {
166
+ scope: 'organization',
167
+ version: 1,
168
+ dogwood: {
169
+ mode: 'enforce',
170
+ policies: 'permit (principal, action, resource);\n\n@id("at most three payees a day")\nforbid (principal, action == Datalayer::Action::"bank___transfer", resource)\nwhen temporal {\n exists (n: Long).\n (count for (p: String).\n where (formerly within 24h Datalayer::Action::"bank___transfer"::request{ eventResource: resource, input.payee: p })) == n\n && n > 3\n};\n',
171
+ },
172
+ },
173
+ };
174
+ export const DOGWOOD_RUNNING_TOTAL_POLICY_0_0_1 = {
175
+ id: 'dogwood-running-total',
176
+ version: '0.0.1',
177
+ name: 'A running total of payments',
178
+ description: 'An example of a Dogwood set for the organization: payments are permitted until their total within 24 hours of the session, the one being decided included, would pass 5 000.00 (500 000 cents); the payment that would cross it is refused. Amounts are integers (cents): Dogwood sums and orders integers alone.',
179
+ enabled: false,
180
+ tags: ['policy', 'organization', 'dogwood', 'example'],
181
+ policy: {
182
+ scope: 'organization',
183
+ version: 1,
184
+ dogwood: {
185
+ mode: 'enforce',
186
+ policies: 'permit (principal, action, resource);\n\n@id("payments total at most 500000 cents a day")\nforbid (principal, action == Datalayer::Action::"payments___pay", resource)\nwhen temporal {\n exists (total: Long).\n (sum amount for (amount: Long), (t: Timepoint).\n where (formerly within 24h (Datalayer::Action::"payments___pay"::request{ eventResource: resource, input.amountCents: amount } && tp(t)))) == total\n && total > 500000\n};\n',
187
+ },
188
+ },
189
+ };
190
+ export const DOGWOOD_SPEND_PER_SESSION_POLICY_0_0_1 = {
191
+ id: 'dogwood-spend-per-session',
192
+ version: '0.0.1',
193
+ name: 'Spend per session, as Dogwood',
194
+ description: "An example of a Dogwood set for the organization: the session's model requests are refused once the credits they asked for within 24 hours, the one being decided included, would pass 1 000 (10 USD); a model request is the Shield's action shield___model. The form `agent-shield policy export --dogwood` gives a document's spend limit, in log_only: decided and recorded, never refused.",
195
+ enabled: false,
196
+ tags: ['policy', 'organization', 'dogwood', 'example'],
197
+ policy: {
198
+ scope: 'organization',
199
+ version: 1,
200
+ dogwood: {
201
+ mode: 'log_only',
202
+ policies: 'permit (principal, action, resource);\n\n@id("spend")\nforbid (principal, action == Datalayer::Action::"shield___model", resource)\nwhen temporal {\n exists (total: Long).\n (sum v for (v: Long), (t: Timepoint).\n where (formerly within 24h (Datalayer::Action::"shield___model"::request{ eventResource: resource, input.credits: v } && tp(t)))) == total\n && total > 1000\n};\n',
203
+ },
204
+ },
205
+ };
206
+ export const DOGWOOD_TRANSFERS_PER_HOUR_POLICY_0_0_1 = {
207
+ id: 'dogwood-transfers-per-hour',
208
+ version: '0.0.1',
209
+ name: 'At most five transfers an hour',
210
+ description: 'An example of a Dogwood set for the organization: a sixth transfer within an hour of the session is refused, the transfer being decided counted; the others are left to the rules. The count is per session, so it shapes a cooperative agent (one stuck in a loop), not a caller who starts new sessions.',
211
+ enabled: false,
212
+ tags: ['policy', 'organization', 'dogwood', 'example'],
213
+ policy: {
214
+ scope: 'organization',
215
+ version: 1,
216
+ dogwood: {
217
+ mode: 'enforce',
218
+ policies: 'permit (principal, action, resource);\n\n@id("at most five transfers an hour")\nforbid (principal, action == Datalayer::Action::"bank___transfer", resource)\nwhen temporal {\n exists (n: Long).\n (count for (t: Timepoint).\n where (formerly within 1h (Datalayer::Action::"bank___transfer"::request{ eventResource: resource } && tp(t)))) == n\n && n > 5\n};\n',
219
+ },
220
+ },
221
+ };
142
222
  export const ORGANIZATION_BASELINE_POLICY_0_0_1 = {
143
223
  id: 'organization-baseline',
144
224
  version: '0.0.1',
@@ -217,6 +297,11 @@ export const ORGANIZATION_BASELINE_POLICY_0_0_1 = {
217
297
  };
218
298
  export const POLICY_CATALOGUE = {
219
299
  default: DEFAULT_POLICY_0_0_1,
300
+ 'dogwood-approval-before-payment': DOGWOOD_APPROVAL_BEFORE_PAYMENT_POLICY_0_0_1,
301
+ 'dogwood-distinct-payees': DOGWOOD_DISTINCT_PAYEES_POLICY_0_0_1,
302
+ 'dogwood-running-total': DOGWOOD_RUNNING_TOTAL_POLICY_0_0_1,
303
+ 'dogwood-spend-per-session': DOGWOOD_SPEND_PER_SESSION_POLICY_0_0_1,
304
+ 'dogwood-transfers-per-hour': DOGWOOD_TRANSFERS_PER_HOUR_POLICY_0_0_1,
220
305
  'organization-baseline': ORGANIZATION_BASELINE_POLICY_0_0_1,
221
306
  };
222
307
  /** A policy by id. */
@@ -17,6 +17,11 @@ export const ACCOUNTING_SKILL_SPEC_0_0_1 = {
17
17
  requiredEnvVars: [],
18
18
  optionalEnvVars: [],
19
19
  dependencies: ['pandas>=2.0.0'],
20
+ install: {
21
+ type: 'python',
22
+ command: 'pip install "agent-skills[skills]"',
23
+ note: "agent-skills with every skill's dependencies; the runtime image installs it the same way.",
24
+ },
20
25
  tags: ['accounting', 'finance', 'reconciliation', 'close'],
21
26
  icon: '@primer/octicons-react:book',
22
27
  emoji: '🧮',
@@ -34,6 +39,11 @@ export const CRAWL_SKILL_SPEC_0_0_1 = {
34
39
  requiredEnvVars: ['TAVILY_API_KEY:0.0.1'],
35
40
  optionalEnvVars: [],
36
41
  dependencies: ['requests>=2.31.0', 'beautifulsoup4>=4.12.0'],
42
+ install: {
43
+ type: 'python',
44
+ command: 'pip install "agent-skills[skills]"',
45
+ note: "agent-skills with every skill's dependencies; the runtime image installs it the same way.",
46
+ },
37
47
  tags: ['web', 'crawl', 'scraping'],
38
48
  icon: '@primer/octicons-react:globe',
39
49
  emoji: '🌐',
@@ -51,6 +61,11 @@ export const EVENTS_SKILL_SPEC_0_0_1 = {
51
61
  requiredEnvVars: [],
52
62
  optionalEnvVars: [],
53
63
  dependencies: ['httpx>=0.27.0'],
64
+ install: {
65
+ type: 'python',
66
+ command: 'pip install "agent-skills[skills]"',
67
+ note: "agent-skills with every skill's dependencies; the runtime image installs it the same way.",
68
+ },
54
69
  tags: ['events', 'orchestration', 'automation'],
55
70
  icon: '@primer/octicons-react:calendar',
56
71
  emoji: '📅',
@@ -68,6 +83,11 @@ export const GITHUB_SKILL_SPEC_0_0_1 = {
68
83
  requiredEnvVars: ['GITHUB_TOKEN:0.0.1'],
69
84
  optionalEnvVars: [],
70
85
  dependencies: ['PyGithub>=2.1.0'],
86
+ install: {
87
+ type: 'python',
88
+ command: 'pip install "agent-skills[skills]"',
89
+ note: "agent-skills with every skill's dependencies; the runtime image installs it the same way.",
90
+ },
71
91
  tags: ['github', 'git', 'code'],
72
92
  icon: '@datalayer/icons-react:github-mark',
73
93
  emoji: '🐙',
@@ -85,6 +105,11 @@ export const IMAGE_SKILL_SPEC_0_0_1 = {
85
105
  requiredEnvVars: [],
86
106
  optionalEnvVars: [],
87
107
  dependencies: ['Pillow>=10.0', 'playwright>=1.45'],
108
+ install: {
109
+ type: 'python',
110
+ command: 'pip install "agent-skills[skills]" && python -m playwright install chromium',
111
+ note: 'Chromium for its page snapshots; the runtime image carries it.',
112
+ },
88
113
  tags: ['image', 'snapshot', 'media'],
89
114
  icon: '@primer/octicons-react:image',
90
115
  emoji: '🖼️',
@@ -102,6 +127,11 @@ export const JOKES_SKILL_SPEC_0_0_1 = {
102
127
  requiredEnvVars: [],
103
128
  optionalEnvVars: [],
104
129
  dependencies: [],
130
+ install: {
131
+ type: 'python',
132
+ command: 'pip install agent-skills',
133
+ note: 'No dependencies of its own.',
134
+ },
105
135
  tags: ['fun', 'humor', 'demo'],
106
136
  icon: '@primer/octicons-react:smiley',
107
137
  emoji: '😄',
@@ -118,7 +148,12 @@ export const PDF_SKILL_SPEC_0_0_1 = {
118
148
  path: undefined,
119
149
  requiredEnvVars: [],
120
150
  optionalEnvVars: [],
121
- dependencies: ['PyPDF2>=3.0.0', 'pdfplumber>=0.10.0'],
151
+ dependencies: ['pypdf>=4.0', 'pdf2image>=1.17', 'Pillow>=10.0'],
152
+ install: {
153
+ type: 'python',
154
+ command: 'pip install "agent-skills[skills]"',
155
+ note: "agent-skills with every skill's dependencies; the runtime image installs it the same way.",
156
+ },
122
157
  tags: ['pdf', 'documents', 'extraction'],
123
158
  icon: '@primer/octicons-react:file',
124
159
  emoji: '📄',
@@ -136,6 +171,11 @@ export const TEXT_SUMMARIZER_SKILL_SPEC_0_0_1 = {
136
171
  requiredEnvVars: [],
137
172
  optionalEnvVars: [],
138
173
  dependencies: ['agent-skills>=0.0.1'],
174
+ install: {
175
+ type: 'python',
176
+ command: 'pip install agent-skills',
177
+ note: 'No dependencies of its own.',
178
+ },
139
179
  tags: ['nlp', 'summarization', 'text-processing'],
140
180
  icon: '@primer/octicons-react:note',
141
181
  emoji: '📝',
@@ -153,6 +193,11 @@ export const VIDEO_SKILL_SPEC_0_0_1 = {
153
193
  requiredEnvVars: [],
154
194
  optionalEnvVars: [],
155
195
  dependencies: ['imageio-ffmpeg>=0.5', 'playwright>=1.45'],
196
+ install: {
197
+ type: 'python',
198
+ command: 'pip install "agent-skills[skills]" && python -m playwright install chromium',
199
+ note: 'Chromium for its recordings, and ffmpeg (imageio-ffmpeg brings one); the runtime image carries both.',
200
+ },
156
201
  tags: ['video', 'recording', 'media'],
157
202
  icon: '@primer/octicons-react:video',
158
203
  emoji: '🎬',