@guildai/cli 0.7.1 → 0.8.1

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.
@@ -85,6 +85,16 @@ guild agent test
85
85
  # Ephemeral test (no persistent storage)
86
86
  guild agent test --ephemeral
87
87
 
88
+ # Bundle locally, then test (faster — skips server-side build)
89
+ npm run bundle
90
+ guild agent test --bundle agent.js.gz
91
+
92
+ # Test with structured JSON input (non-interactive)
93
+ npm run bundle
94
+ guild agent test --bundle agent.js.gz --mode json <<-EOF
95
+ { "type": "text", "text": "this is my agent input" }
96
+ EOF
97
+
88
98
  # Test with specific input
89
99
  guild agent chat "Hello, can you help me?"
90
100
  ```
@@ -175,13 +185,31 @@ import { gitHubTools } from '@guildai-services/guildai~github';
175
185
  import { googleComputeTools } from '@guildai-services/guildai~google-compute';
176
186
  import { googleLoggingTools } from '@guildai-services/guildai~google-logging';
177
187
  import { jiraTools } from '@guildai-services/guildai~jira';
188
+ import { linearTools } from '@guildai-services/guildai~linear';
189
+ import { newrelicTools } from '@guildai-services/guildai~newrelic';
178
190
  import { pipedreamTools } from '@guildai-services/guildai~pipedream';
179
191
  import { slackTools } from '@guildai-services/guildai~slack';
180
192
  import { testrailTools } from '@guildai-services/guildai~testrail';
181
193
  import { zendeskTools } from '@guildai-services/guildai~zendesk';
182
194
 
183
195
  // Utilities
184
- import { pick, omit, progressLogNotifyEvent } from '@guildai/agents-sdk';
196
+ import {
197
+ pick,
198
+ omit,
199
+ guildAgentTool,
200
+ progressLogNotifyEvent,
201
+ } from '@guildai/agents-sdk';
202
+
203
+ // Calling another agent as a tool (import from its /tool sub-package)
204
+ import subagentTool from '@guildai/owner~agent-name/tool';
205
+
206
+ // Coding agent (container-based code execution)
207
+ import { ExperimentalCodingTools as codingTools } from '@guildai-services/guildai~experimental-coding';
208
+ import {
209
+ CONTAINER_IMAGE,
210
+ codingAgentToolsFrom,
211
+ } from '@guildai/guildai~sys-experimental-coding';
212
+ import codingAgentTool from '@guildai/guildai~sys-experimental-coding/tool';
185
213
 
186
214
  // Advanced (for compiled agents with LLM tool loops)
187
215
  import { delegatedCallsOf, asToolResultContent } from '@guildai/agents-sdk';
@@ -257,6 +285,7 @@ await task.tools.guild_credentials_request({ service: 'GITHUB' });
257
285
  | `task.restore()` | Retrieve previously saved state (self-managed state agents only) |
258
286
  | `task.guild` | **Deprecated** — use `task.tools.guild_*` instead |
259
287
  | `task.ui` | **Deprecated** — use `task.tools.ui_*` instead |
288
+ | `task.env` | **Deprecated** — do not use |
260
289
 
261
290
  ---
262
291
 
@@ -286,20 +315,35 @@ export default llmAgent({
286
315
  });
287
316
  ```
288
317
 
289
- **Config options:**
318
+ **Structured inputs with `inputSchema` and `inputTemplate`:**
319
+
320
+ By default, `llmAgent` accepts `{ type: "text", text: string }` and sends `text` as the first user message. Override this for structured inputs:
290
321
 
291
322
  ```typescript
292
- llmAgent({
293
- // ...
294
- config: {
295
- provider: 'anthropic', // "anthropic" | "openai" | "gemini"
296
- model: 'claude-sonnet-4-20250514',
297
- maxTokens: 4096,
298
- temperature: 0.7,
323
+ import { guildTools, llmAgent, pick } from '@guildai/agents-sdk';
324
+ import { gitHubTools } from '@guildai-services/guildai~github';
325
+ import { z } from 'zod';
326
+
327
+ export default llmAgent({
328
+ description: 'Analyzes a GitHub repository',
329
+ inputSchema: z.object({
330
+ repo: z.string().describe('Repository in owner/repo format'),
331
+ branch: z.string().default('main'),
332
+ }),
333
+ inputTemplate: 'Analyze repo {{repo}} on branch {{branch}}',
334
+ tools: {
335
+ ...pick(gitHubTools, ['github_repos_get', 'github_pulls_list']),
336
+ ...guildTools,
299
337
  },
338
+ systemPrompt: 'You analyze GitHub repositories.',
300
339
  });
301
340
  ```
302
341
 
342
+ - `inputSchema` — Zod schema for the agent's input (replaces the default `{ type: "text", text: string }`)
343
+ - `inputTemplate` — Mustache-style template that renders the input as the initial LLM user message (default: `"{{text}}"`)
344
+
345
+ **`useWorkspaceAgents`** — When `true`, the agent dynamically discovers and can call other agents installed in the workspace (like Guild's built-in assistant does). Defaults to `true`, but most agents should set this to `false` unless they specifically need dynamic agent discovery. For deterministic orchestration, use `guildAgentTool()` to delegate to specific agents instead.
346
+
303
347
  ### 2. Automatic State Agent (`run()`) — Recommended for Code-First
304
348
 
305
349
  Runtime manages state via continuations. Return the output object directly. Use `task.tools.*` for all tool calls. Requires `"use agent"` directive.
@@ -456,34 +500,188 @@ export default agent({
456
500
 
457
501
  ## Agent-to-Agent Delegation
458
502
 
459
- Tools without an `execute` function are dispatched as child agents by the runtime. Define a tool that delegates to another agent:
503
+ Every published agent exposes a `/tool` sub-package that wraps it as a callable tool. Import it and add it to your tools object — the runtime handles dispatch.
504
+
505
+ ### Using a published agent as a tool (preferred)
506
+
507
+ Add the agent as a dependency in your `package.json`:
508
+
509
+ ```json
510
+ "@guildai/waterson~subagent": "^1.0.0"
511
+ ```
512
+
513
+ Then import from its `/tool` sub-package:
514
+
515
+ ```typescript
516
+ import subagentTool from '@guildai/waterson~subagent/tool';
517
+
518
+ // In an llmAgent:
519
+ export default llmAgent({
520
+ description: 'My agent',
521
+ tools: { subagent: subagentTool },
522
+ systemPrompt: '...',
523
+ });
524
+
525
+ // In an automatic state agent:
526
+ const result = await task.tools.subagent({ type: 'text', text: 'do the thing' });
527
+
528
+ // In a self-managed state agent:
529
+ return callTools([
530
+ {
531
+ type: 'tool-call',
532
+ toolName: 'subagent',
533
+ toolCallId: 'subagent-1',
534
+ input: { type: 'text', text: 'do the thing' },
535
+ },
536
+ ]);
537
+ ```
538
+
539
+ The `/tool` sub-package is auto-generated at build time — every published agent has one. The tool inherits the agent's `inputSchema` and `outputSchema`, so callers get full type safety.
540
+
541
+ ### Manual wiring with `guildAgentTool()` (advanced)
542
+
543
+ Use `guildAgentTool()` when you need to wire up delegation without a published package — for example, co-located agents in the same workspace:
460
544
 
461
545
  ```typescript
462
546
  'use agent';
463
547
 
464
- import { agent, userInterfaceTools } from '@guildai/agents-sdk';
548
+ import { agent, guildAgentTool, userInterfaceTools } from '@guildai/agents-sdk';
465
549
  import { z } from 'zod';
466
- import { tool } from 'ai';
467
550
 
468
- const summarizeAgent = tool({
469
- description: 'Summarize a document (dispatched to summarize-agent)',
470
- parameters: z.object({
471
- type: z.literal('text'),
472
- text: z.string().describe('The document to summarize'),
551
+ const tools = {
552
+ ...userInterfaceTools,
553
+ // No `calls` — tool name IS the agent identifier
554
+ 'summarize-agent': guildAgentTool({
555
+ description: 'Summarize a document',
556
+ inputSchema: z.object({
557
+ type: z.literal('text'),
558
+ text: z.string().describe('The document to summarize'),
559
+ }),
560
+ outputSchema: z.object({
561
+ type: z.literal('text'),
562
+ text: z.string(),
563
+ }),
473
564
  }),
474
- // No execute function runtime dispatches to the agent named "summarize-agent"
475
- });
565
+ // With `calls`explicit package reference
566
+ reviewer: guildAgentTool({
567
+ description: 'Review code changes',
568
+ calls: 'delaneyparker~cli-reviewer',
569
+ inputSchema: z.object({ type: z.literal('text'), text: z.string() }),
570
+ outputSchema: z.object({ type: z.literal('text'), text: z.string() }),
571
+ }),
572
+ };
476
573
 
477
574
  export default agent({
478
575
  description: 'Orchestrates document processing',
479
- tools: {
480
- ...userInterfaceTools,
481
- summarize_agent: summarizeAgent, // tool name maps to agent
482
- },
576
+ tools,
483
577
  // ...
484
578
  });
485
579
  ```
486
580
 
581
+ ### Using the Coding Agent
582
+
583
+ The coding agent runs instructions inside an isolated container. Use it when your agent needs to read/write files, run shell commands, or work with a cloned repository.
584
+
585
+ ```typescript
586
+ import { ExperimentalCodingTools as codingTools } from '@guildai-services/guildai~experimental-coding';
587
+ import { type Task, agent } from '@guildai/agents-sdk';
588
+ import {
589
+ CONTAINER_IMAGE,
590
+ codingAgentToolsFrom,
591
+ } from '@guildai/guildai~sys-experimental-coding';
592
+ import codingAgentTool from '@guildai/guildai~sys-experimental-coding/tool';
593
+
594
+ const tools = { ...codingTools, communicate: codingAgentTool };
595
+ type Tools = typeof tools;
596
+
597
+ async function run(input: Input, task: Task<Tools>): Promise<Output> {
598
+ const { container_id } = await task.tools.experimental_coding_create({
599
+ image: CONTAINER_IMAGE,
600
+ });
601
+ try {
602
+ const { text } = await task.tools.communicate({
603
+ container_id,
604
+ message: 'What files are in the current directory?',
605
+ });
606
+ return { type: 'text', text };
607
+ } finally {
608
+ await task.tools.experimental_coding_delete({ container_id });
609
+ }
610
+ }
611
+ ```
612
+
613
+ **Container lifecycle** — You own the container. Create it before you need it, and always clean up in a `finally` block so you don't leave containers running if your agent throws.
614
+
615
+ **System prompts** — Pass a `system_prompt` to `communicate` to shape how the coding agent behaves. Keep it in a separate `.md` file (see External Prompts below).
616
+
617
+ ```typescript
618
+ import systemPrompt from './system-prompt.md';
619
+
620
+ const { text } = await task.tools.communicate({
621
+ container_id,
622
+ system_prompt: systemPrompt,
623
+ message,
624
+ });
625
+ ```
626
+
627
+ **Giving the coding agent tools** — The container is sandboxed and can't reach external services. Pass tools explicitly using `codingAgentToolsFrom`:
628
+
629
+ ```typescript
630
+ import { pick } from '@guildai/agents-sdk';
631
+ import { gitHubTools } from '@guildai-services/guildai~github';
632
+ import { codingAgentToolsFrom } from '@guildai/guildai~sys-experimental-coding';
633
+
634
+ const { text } = await task.tools.communicate({
635
+ container_id,
636
+ message,
637
+ tools: codingAgentToolsFrom({
638
+ ...pick(gitHubTools, [
639
+ 'github_repos_download_zipball_archive',
640
+ 'github_pulls_create',
641
+ ]),
642
+ }),
643
+ });
644
+ ```
645
+
646
+ Only pass the tools the coding agent actually needs for the task at hand.
647
+
648
+ **Multi-turn conversations** — By default each `communicate` call starts a fresh session. To continue a conversation, capture the `session_id` from the first response and pass it back:
649
+
650
+ ```typescript
651
+ // Step 1: set up the environment
652
+ const { text: setupResult, session_id } = await task.tools.communicate({
653
+ container_id,
654
+ message: 'Clone the repo and set up the workspace',
655
+ tools: codingAgentToolsFrom({
656
+ ...pick(gitHubTools, ['github_repos_download_zipball_archive']),
657
+ }),
658
+ });
659
+
660
+ // Step 2: do the actual work, continuing the same session
661
+ const { text } = await task.tools.communicate({
662
+ container_id,
663
+ session_id,
664
+ message: 'Now implement the feature described above',
665
+ tools: codingAgentToolsFrom({
666
+ ...pick(gitHubTools, ['github_pulls_create']),
667
+ }),
668
+ });
669
+ ```
670
+
671
+ Using `session_id` preserves the container's working directory, environment variables, and conversation history between calls.
672
+
673
+ **GitHub tools for common container tasks:**
674
+
675
+ | Task | Required Tools |
676
+ | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
677
+ | Clone a repository | `github_repos_download_zipball_archive` |
678
+ | Create a branch | `github_git_get_ref`, `github_git_create_ref` |
679
+ | Create a commit | `github_git_get_ref`, `github_git_get_commit`, `github_git_create_blob`, `github_git_create_tree`, `github_git_create_commit`, `github_git_update_ref` |
680
+ | Create a PR | `github_pulls_create` |
681
+ | Create an issue | `github_issues_create` |
682
+ | Comment on issue/PR | `github_issues_create_comment` |
683
+ | Compute a PR diff | `github_pulls_list_files` |
684
+
487
685
  ---
488
686
 
489
687
  ## Advanced: Compiled Agent Patterns
@@ -498,6 +696,7 @@ import {
498
696
  delegatedCallsOf,
499
697
  asToolResultContent,
500
698
  userInterfaceTools,
699
+ type ModelMessage,
501
700
  type Task,
502
701
  type AgentResult,
503
702
  type TypedToolResult,
@@ -505,7 +704,6 @@ import {
505
704
  } from '@guildai/agents-sdk';
506
705
  import { gitHubTools } from '@guildai-services/guildai~github';
507
706
  import { slackTools } from '@guildai-services/guildai~slack';
508
- import type { ModelMessage } from 'ai';
509
707
  import { z } from 'zod';
510
708
 
511
709
  const tools = { ...gitHubTools, ...slackTools, ...userInterfaceTools };
@@ -593,13 +791,22 @@ await task.tools.slack_chat_post_message({
593
791
 
594
792
  **Only use methods and patterns that actually exist.**
595
793
 
596
- <!-- BEGIN GENERATED TOOL CATALOG -->
597
- <!-- Generated by: cli/scripts/generate-tool-catalog.sh -->
598
- <!-- Do NOT edit manually — re-run the script after changing endpoints.txt -->
794
+ ### Discovering Available Tools
599
795
 
600
- ### Available Service Tools (914 tools)
796
+ **Do NOT guess tool names.** Use the Guild CLI to discover what tools exist for each integration:
601
797
 
602
- **CRITICAL: Only use tool names listed below.** If a tool isn't listed here, it doesn't exist. Do not guess tool names based on API patterns.
798
+ ```bash
799
+ # List all available integrations
800
+ guild integration list
801
+
802
+ # List operations for a specific integration
803
+ guild integration operation list guildai~github
804
+
805
+ # Get full schemas (input/output) in JSON
806
+ guild integration operation list guildai~github --json
807
+ ```
808
+
809
+ Tool names follow the pattern `{service_prefix}_{operation_name}` (e.g., `github_pulls_get`). Check the service packages table above for each service's prefix.
603
810
 
604
811
  Use `pick()` to select specific tools, or `omit()` to exclude specific tools:
605
812
 
@@ -617,982 +824,6 @@ const tools = {
617
824
  };
618
825
  ```
619
826
 
620
- #### Azure DevOps (`azure_devops_` prefix, 122 tools)
621
-
622
- ```
623
- azure_devops_builds_list — Gets a list of builds.
624
- azure_devops_builds_queue — Queues a build
625
- azure_devops_builds_update_builds — Updates multiple builds.
626
- azure_devops_builds_get — Gets a build
627
- azure_devops_builds_update_build — Updates a build.
628
- azure_devops_builds_delete — Deletes a build.
629
- azure_devops_artifacts_list — Gets all artifacts for a build.
630
- azure_devops_artifacts_create — Associates an artifact with a build.
631
- azure_devops_builds_get_build_changes — Gets the changes associated with a build
632
- azure_devops_builds_get_build_logs — Gets the logs for a build.
633
- azure_devops_builds_get_build_log — Gets an individual log file for a build.
634
- azure_devops_stages_update — Update a build stage
635
- azure_devops_timeline_get — Gets details for a build
636
- azure_devops_definitions_list — Gets a list of definitions.
637
- azure_devops_definitions_create — Creates a new definition.
638
- azure_devops_definitions_get — Gets a definition, optionally at a specific revision.
639
- azure_devops_definitions_update — Updates an existing build definition. In order for this operation to succeed, the value of the "Revision" property of the request body must match the existing build definition's. It is recommended that you obtain the existing build definition by using GET, modify the build definition as necessary, and then submit the modified definition with PUT.
640
- azure_devops_definitions_restore_definition — Restores a deleted definition
641
- azure_devops_definitions_delete — Deletes a definition and all associated builds.
642
- azure_devops_policy_configurations_get — Retrieve a list of policy configurations by a given set of scope/filtering criteria.
643
- azure_devops_pull_requests_get_pull_requests_by_project — Retrieve all pull requests matching a specified criteria.
644
- azure_devops_pull_requests_get_pull_request_by_id — Retrieve a pull request.
645
- azure_devops_repositories_list — Retrieve git repositories.
646
- azure_devops_repositories_create — Create a git repository in a team project.
647
- azure_devops_repositories_get_repository — Retrieve a git repository.
648
- azure_devops_repositories_update — Updates the Git repository with either a new repo name or a new default branch.
649
- azure_devops_repositories_delete — Delete a git repository
650
- azure_devops_commits_get_push_commits — Retrieve a list of commits associated with a particular push.
651
- azure_devops_commits_get — Retrieve a particular commit.
652
- azure_devops_commits_get_changes — Retrieve changes for a particular commit.
653
- azure_devops_statuses_list — Get statuses associated with the Git commit.
654
- azure_devops_statuses_create — Create Git commit status.
655
- azure_devops_commits_get_commits_batch — Retrieve git commits for a project matching the search criteria
656
- azure_devops_items_list — Get Item Metadata and/or Content for a collection of items. The download parameter is to indicate whether the content should be available as a download or just sent as a stream in the response. Doesn't apply to zipped content which is always returned as a download.
657
- azure_devops_items_get_items_batch — Retrieves a batch of items in a repo / project for a given list of paths or a long path
658
- azure_devops_pull_requests_get_pull_requests — Retrieve all pull requests matching a specified criteria.
659
- azure_devops_pull_requests_create — Create a pull request.
660
- azure_devops_pull_requests_get_pull_request — Retrieve a pull request.
661
- azure_devops_pull_requests_update — Update a pull request
662
- azure_devops_pull_request_statuses_list — Get all the statuses associated with a pull request.
663
- azure_devops_pull_request_statuses_create — Create a pull request status.
664
- azure_devops_pull_request_statuses_update — Update pull request statuses collection. The only supported operation type is `remove`.
665
- azure_devops_pull_request_statuses_get — Get the specific pull request status by ID. The status ID is unique within the pull request across all iterations.
666
- azure_devops_pull_request_statuses_delete — Delete pull request status.
667
- azure_devops_refs_list — Queries the provided repository for its refs and returns them.
668
- azure_devops_refs_update_refs — Creating, updating, or deleting refs(branches).
669
- azure_devops_refs_update_ref — Lock or Unlock a branch.
670
- azure_devops_stats_list — Retrieve statistics about all branches within a repository.
671
- azure_devops_pipelines_list — Get a list of pipelines.
672
- azure_devops_pipelines_create — Create a pipeline.
673
- azure_devops_pipelines_get — Gets a pipeline, optionally at the specified version
674
- azure_devops_runs_list — Gets top 10000 runs for a particular pipeline.
675
- azure_devops_runs_run_pipeline — Runs a pipeline.
676
- azure_devops_runs_get — Gets a run for a particular pipeline.
677
- azure_devops_artifacts_get — Get a specific artifact from a pipeline run
678
- azure_devops_logs_list — Get a list of logs from a pipeline run.
679
- azure_devops_logs_get — Get a specific log from a pipeline run
680
- azure_devops_attachments_create — Uploads an attachment.
681
- azure_devops_attachments_get — Downloads an attachment.
682
- azure_devops_attachments_upload_chunk — Uploads an attachment chunk.
683
- azure_devops_fields_list — Returns information for all fields. The project ID/name parameter is optional.
684
- azure_devops_fields_create — Create a new field.
685
- azure_devops_fields_get — Gets information on a specific field.
686
- azure_devops_fields_update — Update a field.
687
- azure_devops_fields_delete — Deletes the field. To undelete a filed, see "Update Field" API.
688
- azure_devops_queries_list — Gets the root queries and their children
689
- azure_devops_queries_get — Retrieves an individual query and its children
690
- azure_devops_queries_create — Creates a query, or moves a query.
691
- azure_devops_queries_update — Update a query or a folder. This allows you to update, rename and move queries and folders.
692
- azure_devops_queries_delete — Delete a query or a folder. This deletes any permission change on the deleted query or folder and any of its descendants if it is a folder. It is important to note that the deleted permission changes cannot be recovered upon undeleting the query or folder.
693
- azure_devops_work_items_list — Returns a list of work items (Maximum 200)
694
- azure_devops_work_items_get_work_item_template — Returns a single work item from a template.
695
- azure_devops_work_items_create — Creates a single work item.
696
- azure_devops_work_items_get_work_item — Returns a single work item.
697
- azure_devops_work_items_update — Updates a single work item.
698
- azure_devops_work_items_delete — Deletes the specified work item and sends it to the Recycle Bin, so that it can be restored back, if required. Optionally, if the destroy parameter has been set to true, it destroys the work item permanently. WARNING: If the destroy parameter is set to true, work items deleted by this command will NOT go to recycle-bin and there is no way to restore/recover them after deletion. It is recommended NOT to use this parameter. If you do, please use this parameter with extreme caution.
699
- azure_devops_work_items_get_work_items_batch — Gets work items for a list of work item ids (Maximum 200)
700
- azure_devops_work_item_types_list — Returns the list of work item types
701
- azure_devops_work_item_types_get — Returns a work item type definition.
702
- azure_devops_approvals_query — List Approvals. This can be used to get a set of pending approvals in a pipeline, on an user or for a resource..
703
- azure_devops_approvals_update — Update approvals.
704
- azure_devops_approvals_get — Get an approval.
705
- azure_devops_check_configurations_list — Get Check configuration by resource type and id
706
- azure_devops_check_configurations_add — Add a check configuration
707
- azure_devops_check_configurations_get — Get Check configuration by Id
708
- azure_devops_check_configurations_update — Update check configuration
709
- azure_devops_check_configurations_delete — Delete check configuration by id
710
- azure_devops_check_configurations_query — Get check configurations for multiple resources by resource type and id.
711
- azure_devops_check_evaluations_evaluate — Initiate an evaluation for a check in a pipeline
712
- azure_devops_check_evaluations_get — Get details for a specific check evaluation
713
- azure_devops_environments_list — Get all environments.
714
- azure_devops_environments_add — Create an environment.
715
- azure_devops_environments_get — Get an environment by its ID.
716
- azure_devops_environments_update — Update the specified environment.
717
- azure_devops_environments_delete — Delete the specified environment.
718
- azure_devops_environmentdeploymentrecords_list — Get environment deployment execution history
719
- azure_devops_pools_get_agent_pools_by_ids — Get a list of agent pools.
720
- azure_devops_pools_add — Create an agent pool.
721
- azure_devops_pools_get — Get information about an agent pool.
722
- azure_devops_pools_update — Update properties on an agent pool
723
- azure_devops_pools_delete — Delete an agent pool.
724
- azure_devops_agents_list — Get a list of agents.
725
- azure_devops_agents_add — Adds an agent to a pool. You probably don't want to call this endpoint directly. Instead, [configure an agent](https://docs.microsoft.com/azure/devops/pipelines/agents/agents) using the agent download package.
726
- azure_devops_agents_get_pool_permission — Get Permissions on Pool.
727
- azure_devops_agents_replace_agent — Replace an agent. You probably don't want to call this endpoint directly. Instead, [use the agent configuration script](https://docs.microsoft.com/azure/devops/pipelines/agents/agents) to remove and reconfigure an agent from your organization.
728
- azure_devops_agents_update — Update agent details.
729
- azure_devops_agents_delete — Delete an agent. You probably don't want to call this endpoint directly. Instead, [use the agent configuration script](https://docs.microsoft.com/azure/devops/pipelines/agents/agents) to remove an agent from your organization.
730
- azure_devops_variablegroups_add — Add a variable group.
731
- azure_devops_variablegroups_share_variable_group — Add a variable group.
732
- azure_devops_variablegroups_update — Update a variable group.
733
- azure_devops_variablegroups_delete — Delete a variable group
734
- azure_devops_deploymentgroups_list — Get a list of deployment groups by name or IDs.
735
- azure_devops_deploymentgroups_add — Create a deployment group.
736
- azure_devops_deploymentgroups_get — Get a deployment group by its ID.
737
- azure_devops_deploymentgroups_update — Update a deployment group.
738
- azure_devops_deploymentgroups_delete — Delete a deployment group.
739
- azure_devops_targets_list — Get a list of deployment targets in a deployment group.
740
- azure_devops_targets_update — Update tags of a list of deployment targets in a deployment group.
741
- azure_devops_targets_get — Get a deployment target by its ID in a deployment group
742
- azure_devops_targets_delete — Delete a deployment target in a deployment group. This deletes the agent from associated deployment pool too.
743
- azure_devops_variablegroups_get_variable_groups_by_id — Get variable groups by ids.
744
- azure_devops_variablegroups_get — Get a variable group.
745
- ```
746
-
747
- #### Bitbucket (`bitbucket_` prefix, 91 tools)
748
-
749
- ```
750
- bitbucket_get_repositories_workspace — List repositories in a workspace
751
- bitbucket_get_repositories_workspace_repo_slug — Get a repository
752
- bitbucket_post_repositories_workspace_repo_slug — Create a repository
753
- bitbucket_put_repositories_workspace_repo_slug — Update a repository
754
- bitbucket_delete_repositories_workspace_repo_slug — Delete a repository
755
- bitbucket_get_repositories_workspace_repo_slug_branch_restrictions — List branch restrictions
756
- bitbucket_post_repositories_workspace_repo_slug_branch_restrictions — Create a branch restriction rule
757
- bitbucket_get_repositories_workspace_repo_slug_branch_restrictions_id — Get a branch restriction rule
758
- bitbucket_put_repositories_workspace_repo_slug_branch_restrictions_id — Update a branch restriction rule
759
- bitbucket_delete_repositories_workspace_repo_slug_branch_restrictions_id — Delete a branch restriction rule
760
- bitbucket_get_repositories_workspace_repo_slug_branching_model — Get the branching model for a repository
761
- bitbucket_get_repositories_workspace_repo_slug_branching_model_settings — Get the branching model config for a repository
762
- bitbucket_put_repositories_workspace_repo_slug_branching_model_settings — Update the branching model config for a repository
763
- bitbucket_get_repositories_workspace_repo_slug_commit_commit — Get a commit
764
- bitbucket_get_repositories_workspace_repo_slug_commit_commit_comments — List a commit's comments
765
- bitbucket_post_repositories_workspace_repo_slug_commit_commit_comments — Create comment for a commit
766
- bitbucket_get_repositories_workspace_repo_slug_commit_commit_comments_comment_id — Get a commit comment
767
- bitbucket_put_repositories_workspace_repo_slug_commit_commit_comments_comment_id — Update a commit comment
768
- bitbucket_delete_repositories_workspace_repo_slug_commit_commit_comments_comment_id — Delete a commit comment
769
- bitbucket_get_repositories_workspace_repo_slug_commit_commit_statuses — List commit statuses for a commit
770
- bitbucket_get_repositories_workspace_repo_slug_commits — List commits
771
- bitbucket_post_repositories_workspace_repo_slug_commits — List commits with include/exclude
772
- bitbucket_get_repositories_workspace_repo_slug_default_reviewers — List default reviewers
773
- bitbucket_get_repositories_workspace_repo_slug_default_reviewers_target_username — Get a default reviewer
774
- bitbucket_put_repositories_workspace_repo_slug_default_reviewers_target_username — Add a user to the default reviewers
775
- bitbucket_delete_repositories_workspace_repo_slug_default_reviewers_target_username — Remove a user from the default reviewers
776
- bitbucket_get_repositories_workspace_repo_slug_diff_spec — Compare two commits
777
- bitbucket_get_repositories_workspace_repo_slug_diffstat_spec — Compare two commit diff stats
778
- bitbucket_get_repositories_workspace_repo_slug_filehistory_commit_path — List commits that modified a file
779
- bitbucket_get_repositories_workspace_repo_slug_hooks — List webhooks for a repository
780
- bitbucket_post_repositories_workspace_repo_slug_hooks — Create a webhook for a repository
781
- bitbucket_get_repositories_workspace_repo_slug_hooks_uid — Get a webhook for a repository
782
- bitbucket_put_repositories_workspace_repo_slug_hooks_uid — Update a webhook for a repository
783
- bitbucket_delete_repositories_workspace_repo_slug_hooks_uid — Delete a webhook for a repository
784
- bitbucket_get_repositories_workspace_repo_slug_issues — List issues
785
- bitbucket_post_repositories_workspace_repo_slug_issues — Create an issue
786
- bitbucket_get_repositories_workspace_repo_slug_issues_issue_id — Get an issue
787
- bitbucket_put_repositories_workspace_repo_slug_issues_issue_id — Update an issue
788
- bitbucket_delete_repositories_workspace_repo_slug_issues_issue_id — Delete an issue
789
- bitbucket_get_repositories_workspace_repo_slug_issues_issue_id_attachments — List attachments for an issue
790
- bitbucket_post_repositories_workspace_repo_slug_issues_issue_id_attachments — Upload an attachment to an issue
791
- bitbucket_get_repositories_workspace_repo_slug_issues_issue_id_attachments_path — Get attachment for an issue
792
- bitbucket_delete_repositories_workspace_repo_slug_issues_issue_id_attachments_path — Delete an attachment for an issue
793
- bitbucket_get_repositories_workspace_repo_slug_issues_issue_id_comments — List comments on an issue
794
- bitbucket_post_repositories_workspace_repo_slug_issues_issue_id_comments — Create a comment on an issue
795
- bitbucket_get_repositories_workspace_repo_slug_issues_issue_id_comments_comment_id — Get a comment on an issue
796
- bitbucket_put_repositories_workspace_repo_slug_issues_issue_id_comments_comment_id — Update a comment on an issue
797
- bitbucket_delete_repositories_workspace_repo_slug_issues_issue_id_comments_comment_id — Delete a comment on an issue
798
- bitbucket_get_repositories_workspace_repo_slug_issues_issue_id_vote — Check if current user voted for an issue
799
- bitbucket_put_repositories_workspace_repo_slug_issues_issue_id_vote — Vote for an issue
800
- bitbucket_delete_repositories_workspace_repo_slug_issues_issue_id_vote — Remove vote for an issue
801
- bitbucket_get_repositories_workspace_repo_slug_issues_issue_id_watch — Check if current user is watching a issue
802
- bitbucket_put_repositories_workspace_repo_slug_issues_issue_id_watch — Watch an issue
803
- bitbucket_delete_repositories_workspace_repo_slug_issues_issue_id_watch — Stop watching an issue
804
- bitbucket_get_repositories_workspace_repo_slug_pullrequests — List pull requests
805
- bitbucket_post_repositories_workspace_repo_slug_pullrequests — Create a pull request
806
- bitbucket_get_repositories_workspace_repo_slug_pullrequests_activity — List a pull request activity log
807
- bitbucket_get_repositories_workspace_repo_slug_pullrequests_pull_request_id — Get a pull request
808
- bitbucket_put_repositories_workspace_repo_slug_pullrequests_pull_request_id — Update a pull request
809
- bitbucket_get_repositories_workspace_repo_slug_pullrequests_pull_request_id_activity — List a pull request activity log
810
- bitbucket_post_repositories_workspace_repo_slug_pullrequests_pull_request_id_approve — Approve a pull request
811
- bitbucket_delete_repositories_workspace_repo_slug_pullrequests_pull_request_id_approve — Unapprove a pull request
812
- bitbucket_get_repositories_workspace_repo_slug_pullrequests_pull_request_id_comments — List comments on a pull request
813
- bitbucket_post_repositories_workspace_repo_slug_pullrequests_pull_request_id_comments — Create a comment on a pull request
814
- bitbucket_get_repositories_workspace_repo_slug_pullrequests_pull_request_id_comments_comment_id — Get a comment on a pull request
815
- bitbucket_put_repositories_workspace_repo_slug_pullrequests_pull_request_id_comments_comment_id — Update a comment on a pull request
816
- bitbucket_delete_repositories_workspace_repo_slug_pullrequests_pull_request_id_comments_comment_id — Delete a comment on a pull request
817
- bitbucket_get_repositories_workspace_repo_slug_pullrequests_pull_request_id_commits — List commits on a pull request
818
- bitbucket_post_repositories_workspace_repo_slug_pullrequests_pull_request_id_decline — Decline a pull request
819
- bitbucket_get_repositories_workspace_repo_slug_pullrequests_pull_request_id_diff — List changes in a pull request
820
- bitbucket_get_repositories_workspace_repo_slug_pullrequests_pull_request_id_diffstat — Get the diff stat for a pull request
821
- bitbucket_post_repositories_workspace_repo_slug_pullrequests_pull_request_id_merge — Merge a pull request
822
- bitbucket_get_repositories_workspace_repo_slug_pullrequests_pull_request_id_patch — Get the patch for a pull request
823
- bitbucket_post_repositories_workspace_repo_slug_pullrequests_pull_request_id_request_changes — Request changes for a pull request
824
- bitbucket_delete_repositories_workspace_repo_slug_pullrequests_pull_request_id_request_changes — Remove change request for a pull request
825
- bitbucket_get_repositories_workspace_repo_slug_pullrequests_pull_request_id_statuses — List commit statuses for a pull request
826
- bitbucket_get_repositories_workspace_repo_slug_refs_branches — List open branches
827
- bitbucket_post_repositories_workspace_repo_slug_refs_branches — Create a branch
828
- bitbucket_get_repositories_workspace_repo_slug_refs_branches_name — Get a branch
829
- bitbucket_delete_repositories_workspace_repo_slug_refs_branches_name — Delete a branch
830
- bitbucket_get_repositories_workspace_repo_slug_src — Get the root directory of the main branch
831
- bitbucket_post_repositories_workspace_repo_slug_src — Create a commit by uploading a file
832
- bitbucket_get_repositories_workspace_repo_slug_src_commit_path — Get file or directory contents
833
- bitbucket_get_workspaces — List workspaces for user
834
- bitbucket_get_workspaces_workspace — Get a workspace
835
- bitbucket_get_workspaces_workspace_members — List users in a workspace
836
- bitbucket_get_workspaces_workspace_projects — List projects in a workspace
837
- bitbucket_post_workspaces_workspace_projects — Create a project in a workspace
838
- bitbucket_get_workspaces_workspace_projects_project_key — Get a project for a workspace
839
- bitbucket_put_workspaces_workspace_projects_project_key — Update a project for a workspace
840
- bitbucket_delete_workspaces_workspace_projects_project_key — Delete a project for a workspace
841
- ```
842
-
843
- #### Confluence (`confluence_` prefix, 212 tools)
844
-
845
- ```
846
- confluence_get_admin_key — Get Admin Key
847
- confluence_enable_admin_key — Enable Admin Key
848
- confluence_disable_admin_key — Disable Admin Key
849
- confluence_get_attachments — Get attachments
850
- confluence_get_attachment_by_id — Get attachment by id
851
- confluence_delete_attachment — Delete attachment
852
- confluence_get_attachment_labels — Get labels for attachment
853
- confluence_get_attachment_operations — Get permitted operations for attachment
854
- confluence_get_attachment_content_properties — Get content properties for attachment
855
- confluence_create_attachment_property — Create content property for attachment
856
- confluence_get_attachment_content_properties_by_id — Get content property for attachment by id
857
- confluence_update_attachment_property_by_id — Update content property for attachment by id
858
- confluence_delete_attachment_property_by_id — Delete content property for attachment by id
859
- confluence_get_attachment_versions — Get attachment versions
860
- confluence_get_attachment_version_details — Get version details for attachment version
861
- confluence_get_attachment_comments — Get attachment comments
862
- confluence_get_blog_posts — Get blog posts
863
- confluence_create_blog_post — Create blog post
864
- confluence_get_blog_post_by_id — Get blog post by id
865
- confluence_update_blog_post — Update blog post
866
- confluence_delete_blog_post — Delete blog post
867
- confluence_get_blogpost_attachments — Get attachments for blog post
868
- confluence_get_custom_content_by_type_in_blog_post — Get custom content by type in blog post
869
- confluence_get_blog_post_labels — Get labels for blog post
870
- confluence_get_blog_post_like_count — Get like count for blog post
871
- confluence_get_blog_post_like_users — Get account IDs of likes for blog post
872
- confluence_get_blogpost_content_properties — Get content properties for blog post
873
- confluence_create_blogpost_property — Create content property for blog post
874
- confluence_get_blogpost_content_properties_by_id — Get content property for blog post by id
875
- confluence_update_blogpost_property_by_id — Update content property for blog post by id
876
- confluence_delete_blogpost_property_by_id — Delete content property for blogpost by id
877
- confluence_get_blog_post_operations — Get permitted operations for blog post
878
- confluence_get_blog_post_versions — Get blog post versions
879
- confluence_get_blog_post_version_details — Get version details for blog post version
880
- confluence_convert_content_ids_to_content_types — Convert content ids to content types
881
- confluence_get_custom_content_by_type — Get custom content by type
882
- confluence_create_custom_content — Create custom content
883
- confluence_get_custom_content_by_id — Get custom content by id
884
- confluence_update_custom_content — Update custom content
885
- confluence_delete_custom_content — Delete custom content
886
- confluence_get_custom_content_attachments — Get attachments for custom content
887
- confluence_get_custom_content_comments — Get custom content comments
888
- confluence_get_custom_content_labels — Get labels for custom content
889
- confluence_get_custom_content_operations — Get permitted operations for custom content
890
- confluence_get_custom_content_content_properties — Get content properties for custom content
891
- confluence_create_custom_content_property — Create content property for custom content
892
- confluence_get_custom_content_content_properties_by_id — Get content property for custom content by id
893
- confluence_update_custom_content_property_by_id — Update content property for custom content by id
894
- confluence_delete_custom_content_property_by_id — Delete content property for custom content by id
895
- confluence_get_labels — Get labels
896
- confluence_get_label_attachments — Get attachments for label
897
- confluence_get_label_blog_posts — Get blog posts for label
898
- confluence_get_label_pages — Get pages for label
899
- confluence_get_pages — Get pages
900
- confluence_create_page — Create page
901
- confluence_get_page_by_id — Get page by id
902
- confluence_update_page — Update page
903
- confluence_delete_page — Delete page
904
- confluence_get_page_attachments — Get attachments for page
905
- confluence_get_custom_content_by_type_in_page — Get custom content by type in page
906
- confluence_get_page_labels — Get labels for page
907
- confluence_get_page_like_count — Get like count for page
908
- confluence_get_page_like_users — Get account IDs of likes for page
909
- confluence_get_page_operations — Get permitted operations for page
910
- confluence_get_page_content_properties — Get content properties for page
911
- confluence_create_page_property — Create content property for page
912
- confluence_get_page_content_properties_by_id — Get content property for page by id
913
- confluence_update_page_property_by_id — Update content property for page by id
914
- confluence_delete_page_property_by_id — Delete content property for page by id
915
- confluence_post_redact_page — Redact Content in a Confluence Page
916
- confluence_post_redact_blog — Redact Content in a Confluence Blog Post
917
- confluence_update_page_title — Update page title
918
- confluence_get_page_versions — Get page versions
919
- confluence_create_whiteboard — Create whiteboard
920
- confluence_get_whiteboard_by_id — Get whiteboard by id
921
- confluence_delete_whiteboard — Delete whiteboard
922
- confluence_get_whiteboard_content_properties — Get content properties for whiteboard
923
- confluence_create_whiteboard_property — Create content property for whiteboard
924
- confluence_get_whiteboard_content_properties_by_id — Get content property for whiteboard by id
925
- confluence_update_whiteboard_property_by_id — Update content property for whiteboard by id
926
- confluence_delete_whiteboard_property_by_id — Delete content property for whiteboard by id
927
- confluence_get_whiteboard_operations — Get permitted operations for a whiteboard
928
- confluence_get_whiteboard_direct_children — Get direct children of a whiteboard
929
- confluence_get_whiteboard_descendants — Get descendants of a whiteboard
930
- confluence_get_whiteboard_ancestors — Get all ancestors of whiteboard
931
- confluence_create_database — Create database
932
- confluence_get_database_by_id — Get database by id
933
- confluence_delete_database — Delete database
934
- confluence_get_database_content_properties — Get content properties for database
935
- confluence_create_database_property — Create content property for database
936
- confluence_get_database_content_properties_by_id — Get content property for database by id
937
- confluence_update_database_property_by_id — Update content property for database by id
938
- confluence_delete_database_property_by_id — Delete content property for database by id
939
- confluence_get_database_operations — Get permitted operations for a database
940
- confluence_get_database_direct_children — Get direct children of a database
941
- confluence_get_database_descendants — Get descendants of a database
942
- confluence_get_database_ancestors — Get all ancestors of database
943
- confluence_create_smart_link — Create Smart Link in the content tree
944
- confluence_get_smart_link_by_id — Get Smart Link in the content tree by id
945
- confluence_delete_smart_link — Delete Smart Link in the content tree
946
- confluence_get_smart_link_content_properties — Get content properties for Smart Link in the content tree
947
- confluence_create_smart_link_property — Create content property for Smart Link in the content tree
948
- confluence_get_smart_link_content_properties_by_id — Get content property for Smart Link in the content tree by id
949
- confluence_update_smart_link_property_by_id — Update content property for Smart Link in the content tree by id
950
- confluence_delete_smart_link_property_by_id — Delete content property for Smart Link in the content tree by id
951
- confluence_get_smart_link_operations — Get permitted operations for a Smart Link in the content tree
952
- confluence_get_smart_link_direct_children — Get direct children of a Smart Link
953
- confluence_get_smart_link_descendants — Get descendants of a smart link
954
- confluence_get_smart_link_ancestors — Get all ancestors of Smart Link in content tree
955
- confluence_create_folder — Create folder
956
- confluence_get_folder_by_id — Get folder by id
957
- confluence_delete_folder — Delete folder
958
- confluence_get_folder_content_properties — Get content properties for folder
959
- confluence_create_folder_property — Create content property for folder
960
- confluence_get_folder_content_properties_by_id — Get content property for folder by id
961
- confluence_update_folder_property_by_id — Update content property for folder by id
962
- confluence_delete_folder_property_by_id — Delete content property for folder by id
963
- confluence_get_folder_operations — Get permitted operations for a folder
964
- confluence_get_folder_direct_children — Get direct children of a folder
965
- confluence_get_folder_descendants — Get descendants of folder
966
- confluence_get_folder_ancestors — Get all ancestors of folder
967
- confluence_get_page_version_details — Get version details for page version
968
- confluence_get_custom_content_versions — Get custom content versions
969
- confluence_get_custom_content_version_details — Get version details for custom content version
970
- confluence_get_spaces — Get spaces
971
- confluence_create_space — Create space
972
- confluence_get_space_by_id — Get space by id
973
- confluence_get_blog_posts_in_space — Get blog posts in space
974
- confluence_get_space_labels — Get labels for space
975
- confluence_get_space_content_labels — Get labels for space content
976
- confluence_get_custom_content_by_type_in_space — Get custom content by type in space
977
- confluence_get_space_operations — Get permitted operations for space
978
- confluence_get_pages_in_space — Get pages in space
979
- confluence_get_space_properties — Get space properties in space
980
- confluence_create_space_property — Create space property in space
981
- confluence_get_space_property_by_id — Get space property by id
982
- confluence_update_space_property_by_id — Update space property by id
983
- confluence_delete_space_property_by_id — Delete space property by id
984
- confluence_get_space_permissions_assignments — Get space permissions assignments
985
- confluence_get_available_space_permissions — Get available space permissions
986
- confluence_get_available_space_roles — Get available space roles
987
- confluence_create_space_role — Create a space role
988
- confluence_get_space_roles_by_id — Get space role by ID
989
- confluence_update_space_role — Update a space role
990
- confluence_delete_space_role — Delete a space role
991
- confluence_get_space_role_mode — Get space role mode
992
- confluence_get_space_role_assignments — Get space role assignments
993
- confluence_set_space_role_assignments — Set space role assignments
994
- confluence_get_page_footer_comments — Get footer comments for page
995
- confluence_get_page_inline_comments — Get inline comments for page
996
- confluence_get_blog_post_footer_comments — Get footer comments for blog post
997
- confluence_get_blog_post_inline_comments — Get inline comments for blog post
998
- confluence_get_footer_comments — Get footer comments
999
- confluence_create_footer_comment — Create footer comment
1000
- confluence_get_footer_comment_by_id — Get footer comment by id
1001
- confluence_update_footer_comment — Update footer comment
1002
- confluence_delete_footer_comment — Delete footer comment
1003
- confluence_get_footer_comment_children — Get children footer comments
1004
- confluence_get_footer_like_count — Get like count for footer comment
1005
- confluence_get_footer_like_users — Get account IDs of likes for footer comment
1006
- confluence_get_footer_comment_operations — Get permitted operations for footer comment
1007
- confluence_get_footer_comment_versions — Get footer comment versions
1008
- confluence_get_footer_comment_version_details — Get version details for footer comment version
1009
- confluence_get_inline_comments — Get inline comments
1010
- confluence_create_inline_comment — Create inline comment
1011
- confluence_get_inline_comment_by_id — Get inline comment by id
1012
- confluence_update_inline_comment — Update inline comment
1013
- confluence_delete_inline_comment — Delete inline comment
1014
- confluence_get_inline_comment_children — Get children inline comments
1015
- confluence_get_inline_like_count — Get like count for inline comment
1016
- confluence_get_inline_like_users — Get account IDs of likes for inline comment
1017
- confluence_get_inline_comment_operations — Get permitted operations for inline comment
1018
- confluence_get_inline_comment_versions — Get inline comment versions
1019
- confluence_get_inline_comment_version_details — Get version details for inline comment version
1020
- confluence_get_comment_content_properties — Get content properties for comment
1021
- confluence_create_comment_property — Create content property for comment
1022
- confluence_get_comment_content_properties_by_id — Get content property for comment by id
1023
- confluence_update_comment_property_by_id — Update content property for comment by id
1024
- confluence_delete_comment_property_by_id — Delete content property for comment by id
1025
- confluence_get_tasks — Get tasks
1026
- confluence_get_task_by_id — Get task by id
1027
- confluence_update_task — Update task
1028
- confluence_get_child_pages — Get child pages
1029
- confluence_get_child_custom_content — Get child custom content
1030
- confluence_get_page_direct_children — Get direct children of a page
1031
- confluence_get_page_ancestors — Get all ancestors of page
1032
- confluence_get_page_descendants — Get descendants of page
1033
- confluence_create_bulk_user_lookup — Create bulk user lookup using ids
1034
- confluence_check_access_by_email — Check site access for a list of emails
1035
- confluence_invite_by_email — Invite a list of emails to the site
1036
- confluence_get_data_policy_metadata — Get data policy metadata for the workspace
1037
- confluence_get_data_policy_spaces — Get spaces with data policies
1038
- confluence_get_classification_levels — Get list of classification levels
1039
- confluence_get_space_default_classification_level — Get space default classification level
1040
- confluence_put_space_default_classification_level — Update space default classification level
1041
- confluence_delete_space_default_classification_level — Delete space default classification level
1042
- confluence_get_page_classification_level — Get page classification level
1043
- confluence_put_page_classification_level — Update page classification level
1044
- confluence_post_page_classification_level — Reset page classification level
1045
- confluence_get_blog_post_classification_level — Get blog post classification level
1046
- confluence_put_blog_post_classification_level — Update blog post classification level
1047
- confluence_post_blog_post_classification_level — Reset blog post classification level
1048
- confluence_get_whiteboard_classification_level — Get whiteboard classification level
1049
- confluence_put_whiteboard_classification_level — Update whiteboard classification level
1050
- confluence_post_whiteboard_classification_level — Reset whiteboard classification level
1051
- confluence_get_database_classification_level — Get database classification level
1052
- confluence_put_database_classification_level — Update database classification level
1053
- confluence_post_database_classification_level — Reset database classification level
1054
- confluence_get_forge_app_properties — Get Forge app properties.
1055
- confluence_get_forge_app_property — Get a Forge app property by key.
1056
- confluence_put_forge_app_property — Create or update a Forge app property.
1057
- confluence_delete_forge_app_property — Deletes a Forge app property.
1058
- ```
1059
-
1060
- #### Figma (`figma_` prefix, 46 tools)
1061
-
1062
- ```
1063
- figma_get_file — Get file JSON
1064
- figma_get_file_nodes — Get file JSON for specific nodes
1065
- figma_get_images — Render images of file nodes
1066
- figma_get_image_fills — Get image fills
1067
- figma_get_file_meta — Get file metadata
1068
- figma_get_team_projects — Get projects in a team
1069
- figma_get_project_files — Get files in a project
1070
- figma_get_file_versions — Get versions of a file
1071
- figma_get_comments — Get comments in a file
1072
- figma_post_comment — Add a comment to a file
1073
- figma_delete_comment — Delete a comment
1074
- figma_get_comment_reactions — Get reactions for a comment
1075
- figma_post_comment_reaction — Add a reaction to a comment
1076
- figma_delete_comment_reaction — Delete a reaction
1077
- figma_get_me — Get current user
1078
- figma_get_team_components — Get team components
1079
- figma_get_file_components — Get file components
1080
- figma_get_component — Get component
1081
- figma_get_team_component_sets — Get team component sets
1082
- figma_get_file_component_sets — Get file component sets
1083
- figma_get_component_set — Get component set
1084
- figma_get_team_styles — Get team styles
1085
- figma_get_file_styles — Get file styles
1086
- figma_get_style — Get style
1087
- figma_get_webhooks — Get webhooks by context or plan
1088
- figma_post_webhook — Create a webhook
1089
- figma_get_webhook — Get a webhook
1090
- figma_put_webhook — Update a webhook
1091
- figma_delete_webhook — Delete a webhook
1092
- figma_get_team_webhooks — [Deprecated] Get team webhooks
1093
- figma_get_webhook_requests — Get webhook requests
1094
- figma_get_activity_logs — Get activity logs
1095
- figma_get_payments — Get payments
1096
- figma_get_local_variables — Get local variables
1097
- figma_get_published_variables — Get published variables
1098
- figma_post_variables — Create/modify/delete variables
1099
- figma_get_dev_resources — Get dev resources
1100
- figma_post_dev_resources — Create dev resources
1101
- figma_put_dev_resources — Update dev resources
1102
- figma_delete_dev_resource — Delete dev resource
1103
- figma_get_library_analytics_component_actions — Get library analytics component action data.
1104
- figma_get_library_analytics_component_usages — Get library analytics component usage data.
1105
- figma_get_library_analytics_style_actions — Get library analytics style action data.
1106
- figma_get_library_analytics_style_usages — Get library analytics style usage data.
1107
- figma_get_library_analytics_variable_actions — Get library analytics variable action data.
1108
- figma_get_library_analytics_variable_usages — Get library analytics variable usage data.
1109
- ```
1110
-
1111
- #### GitHub (`github_` prefix, 185 tools)
1112
-
1113
- ```
1114
- github_gists_list — List gists for the authenticated user
1115
- github_gists_create — Create a gist
1116
- github_gists_list_public — List public gists
1117
- github_gists_get — Get a gist
1118
- github_gists_update — Update a gist
1119
- github_gists_delete — Delete a gist
1120
- github_gists_list_comments — List gist comments
1121
- github_gists_create_comment — Create a gist comment
1122
- github_orgs_list_issue_types — List issue types for an organization
1123
- github_orgs_create_issue_type — Create issue type for an organization
1124
- github_orgs_list_members — List organization members
1125
- github_repos_list_for_org — List organization repositories
1126
- github_repos_create_in_org — Create an organization repository
1127
- github_repos_get — Get a repository
1128
- github_repos_update — Update a repository
1129
- github_repos_delete — Delete a repository
1130
- github_actions_download_job_logs_for_workflow_run — Download job logs for a workflow run
1131
- github_actions_re_run_job_for_workflow_run — Re-run a job from a workflow run
1132
- github_actions_list_workflow_runs_for_repo — List workflow runs for a repository
1133
- github_actions_get_workflow_run — Get a workflow run
1134
- github_actions_delete_workflow_run — Delete a workflow run
1135
- github_actions_list_workflow_run_artifacts — List workflow run artifacts
1136
- github_actions_get_workflow_run_attempt — Get a workflow run attempt
1137
- github_actions_list_jobs_for_workflow_run_attempt — List jobs for a workflow run attempt
1138
- github_actions_download_workflow_run_attempt_logs — Download workflow run attempt logs
1139
- github_actions_force_cancel_workflow_run — Force cancel a workflow run
1140
- github_actions_list_jobs_for_workflow_run — List jobs for a workflow run
1141
- github_actions_download_workflow_run_logs — Download workflow run logs
1142
- github_actions_delete_workflow_run_logs — Delete workflow run logs
1143
- github_actions_re_run_workflow — Re-run a workflow
1144
- github_actions_re_run_workflow_failed_jobs — Re-run failed jobs from a workflow run
1145
- github_actions_list_repo_workflows — List repository workflows
1146
- github_actions_get_workflow — Get a workflow
1147
- github_actions_list_workflow_runs — List workflow runs for a workflow
1148
- github_repos_list_activities — List repository activities
1149
- github_issues_list_assignees — List assignees
1150
- github_issues_check_user_can_be_assigned — Check if a user can be assigned
1151
- github_repos_list_branches — List branches
1152
- github_repos_get_branch — Get a branch
1153
- github_checks_create — Create a check run
1154
- github_checks_get — Get a check run
1155
- github_checks_update — Update a check run
1156
- github_checks_list_annotations — List check run annotations
1157
- github_checks_rerequest_run — Rerequest a check run
1158
- github_repos_list_commit_comments_for_repo — List commit comments for a repository
1159
- github_repos_get_commit_comment — Get a commit comment
1160
- github_repos_update_commit_comment — Update a commit comment
1161
- github_repos_delete_commit_comment — Delete a commit comment
1162
- github_repos_list_commits — List commits
1163
- github_repos_list_comments_for_commit — List commit comments
1164
- github_repos_create_commit_comment — Create a commit comment
1165
- github_repos_list_pull_requests_associated_with_commit — List pull requests associated with a commit
1166
- github_repos_get_commit — Get a commit
1167
- github_checks_list_for_ref — List check runs for a Git reference
1168
- github_repos_get_combined_status_for_ref — Get the combined status for a specific reference
1169
- github_repos_compare_commits — Compare two commits
1170
- github_repos_get_content — Get repository content
1171
- github_repos_create_or_update_file_contents — Create or update file contents
1172
- github_repos_delete_file — Delete a file
1173
- github_repos_list_contributors — List repository contributors
1174
- github_repos_list_deployments — List deployments
1175
- github_repos_create_deployment — Create a deployment
1176
- github_repos_get_deployment — Get a deployment
1177
- github_repos_delete_deployment — Delete a deployment
1178
- github_repos_list_deployment_statuses — List deployment statuses
1179
- github_repos_create_deployment_status — Create a deployment status
1180
- github_repos_get_deployment_status — Get a deployment status
1181
- github_git_get_commit — Get a commit object
1182
- github_git_list_matching_refs — List matching references
1183
- github_git_get_ref — Get a reference
1184
- github_git_create_ref — Create a reference
1185
- github_git_update_ref — Update a reference
1186
- github_git_delete_ref — Delete a reference
1187
- github_git_create_tag — Create a tag object
1188
- github_git_get_tag — Get a tag
1189
- github_git_get_tree — Get a tree
1190
- github_repos_list_webhooks — List repository webhooks
1191
- github_repos_create_webhook — Create a repository webhook
1192
- github_repos_get_webhook — Get a repository webhook
1193
- github_repos_update_webhook — Update a repository webhook
1194
- github_repos_delete_webhook — Delete a repository webhook
1195
- github_repos_get_webhook_config_for_repo — Get a webhook configuration for a repository
1196
- github_repos_update_webhook_config_for_repo — Update a webhook configuration for a repository
1197
- github_repos_list_webhook_deliveries — List deliveries for a repository webhook
1198
- github_repos_get_webhook_delivery — Get a delivery for a repository webhook
1199
- github_repos_redeliver_webhook_delivery — Redeliver a delivery for a repository webhook
1200
- github_repos_ping_webhook — Ping a repository webhook
1201
- github_repos_test_push_webhook — Test the push repository webhook
1202
- github_issues_list_for_repo — List repository issues
1203
- github_issues_create — Create an issue
1204
- github_issues_list_comments_for_repo — List issue comments for a repository
1205
- github_issues_get_comment — Get an issue comment
1206
- github_issues_update_comment — Update an issue comment
1207
- github_issues_delete_comment — Delete an issue comment
1208
- github_issues_list_events_for_repo — List issue events for a repository
1209
- github_issues_get_event — Get an issue event
1210
- github_issues_get — Get an issue
1211
- github_issues_update — Update an issue
1212
- github_issues_add_assignees — Add assignees to an issue
1213
- github_issues_remove_assignees — Remove assignees from an issue
1214
- github_issues_check_user_can_be_assigned_to_issue — Check if a user can be assigned to a issue
1215
- github_issues_list_comments — List issue comments
1216
- github_issues_create_comment — Create an issue comment
1217
- github_issues_list_dependencies_blocked_by — List dependencies an issue is blocked by
1218
- github_issues_add_blocked_by_dependency — Add a dependency an issue is blocked by
1219
- github_issues_remove_dependency_blocked_by — Remove dependency an issue is blocked by
1220
- github_issues_list_dependencies_blocking — List dependencies an issue is blocking
1221
- github_issues_list_events — List issue events
1222
- github_issues_list_labels_on_issue — List labels for an issue
1223
- github_issues_add_labels — Add labels to an issue
1224
- github_issues_set_labels — Set labels for an issue
1225
- github_issues_remove_all_labels — Remove all labels from an issue
1226
- github_issues_remove_label — Remove a label from an issue
1227
- github_issues_lock — Lock an issue
1228
- github_issues_unlock — Unlock an issue
1229
- github_issues_get_parent — Get parent issue
1230
- github_issues_remove_sub_issue — Remove sub-issue
1231
- github_issues_list_sub_issues — List sub-issues
1232
- github_issues_add_sub_issue — Add sub-issue
1233
- github_issues_reprioritize_sub_issue — Reprioritize sub-issue
1234
- github_issues_list_events_for_timeline — List timeline events for an issue
1235
- github_issues_list_labels_for_repo — List labels for a repository
1236
- github_issues_create_label — Create a label
1237
- github_issues_get_label — Get a label
1238
- github_issues_update_label — Update a label
1239
- github_issues_delete_label — Delete a label
1240
- github_repos_list_languages — List repository languages
1241
- github_pulls_list — List pull requests
1242
- github_pulls_create — Create a pull request
1243
- github_pulls_list_review_comments_for_repo — List review comments in a repository
1244
- github_pulls_get_review_comment — Get a review comment for a pull request
1245
- github_pulls_update_review_comment — Update a review comment for a pull request
1246
- github_pulls_delete_review_comment — Delete a review comment for a pull request
1247
- github_pulls_get — Get a pull request
1248
- github_pulls_update — Update a pull request
1249
- github_pulls_list_review_comments — List review comments on a pull request
1250
- github_pulls_create_review_comment — Create a review comment for a pull request
1251
- github_pulls_create_reply_for_review_comment — Create a reply for a review comment
1252
- github_pulls_list_commits — List commits on a pull request
1253
- github_pulls_list_files — List pull requests files
1254
- github_pulls_check_if_merged — Check if a pull request has been merged
1255
- github_pulls_merge — Merge a pull request
1256
- github_pulls_list_requested_reviewers — Get all requested reviewers for a pull request
1257
- github_pulls_request_reviewers — Request reviewers for a pull request
1258
- github_pulls_remove_requested_reviewers — Remove requested reviewers from a pull request
1259
- github_pulls_list_reviews — List reviews for a pull request
1260
- github_pulls_create_review — Create a review for a pull request
1261
- github_pulls_get_review — Get a review for a pull request
1262
- github_pulls_update_review — Update a review for a pull request
1263
- github_pulls_delete_pending_review — Delete a pending review for a pull request
1264
- github_pulls_list_comments_for_review — List comments for a pull request review
1265
- github_pulls_submit_review — Submit a review for a pull request
1266
- github_repos_get_readme — Get a repository README
1267
- github_repos_get_readme_in_directory — Get a repository README for a directory
1268
- github_repos_list_releases — List releases
1269
- github_repos_create_release — Create a release
1270
- github_repos_generate_release_notes — Generate release notes content for a release
1271
- github_repos_get_latest_release — Get the latest release
1272
- github_repos_get_release_by_tag — Get a release by tag name
1273
- github_repos_get_release — Get a release
1274
- github_repos_update_release — Update a release
1275
- github_repos_delete_release — Delete a release
1276
- github_security_advisories_list_repository_advisories — List repository security advisories
1277
- github_security_advisories_create_repository_advisory — Create a repository security advisory
1278
- github_security_advisories_create_private_vulnerability_report — Privately report a security vulnerability
1279
- github_security_advisories_get_repository_advisory — Get a repository security advisory
1280
- github_security_advisories_update_repository_advisory — Update a repository security advisory
1281
- github_security_advisories_create_repository_advisory_cve_request — Request a CVE for a repository security advisory
1282
- github_repos_get_code_frequency_stats — Get the weekly commit activity
1283
- github_repos_get_commit_activity_stats — Get the last year of commit activity
1284
- github_repos_get_contributors_stats — Get all contributor commit activity
1285
- github_repos_get_participation_stats — Get the weekly commit count
1286
- github_repos_get_punch_card_stats — Get the hourly commit count for each day
1287
- github_repos_list_tags — List repository tags
1288
- github_search_code — Search code
1289
- github_search_commits — Search commits
1290
- github_search_issues_and_pull_requests — Search issues and pull requests
1291
- github_search_labels — Search labels
1292
- github_search_repos — Search repositories
1293
- github_search_topics — Search topics
1294
- github_search_users — Search users
1295
- github_users_get_by_username — Get a user
1296
- github_activity_list_public_events_for_user — List public events for a user
1297
- github_gists_list_for_user — List gists for a user
1298
- github_repos_list_for_user — List repositories for a user
1299
- ```
1300
-
1301
- #### Google Compute (`google_compute_` prefix, 65 tools)
1302
-
1303
- ```
1304
- google_compute_global_operations_list — Retrieves a list of Operation resources contained within the specified
1305
- google_compute_global_operations_get — Retrieves the specified Operations resource.
1306
- google_compute_global_operations_delete — Deletes the specified Operations resource.
1307
- google_compute_global_operations_wait — Waits for the specified Operation resource to return as `DONE`
1308
- google_compute_zone_operations_list — Retrieves a list of Operation resources contained within
1309
- google_compute_zone_operations_get — Retrieves the specified zone-specific Operations resource.
1310
- google_compute_zone_operations_delete — Deletes the specified zone-specific Operations resource.
1311
- google_compute_zone_operations_wait — Waits for the specified Operation resource to return as `DONE`
1312
- google_compute_images_list — Retrieves the list of custom images
1313
- google_compute_images_insert — Creates an image in the specified project using the data included
1314
- google_compute_images_get — Returns the specified image.
1315
- google_compute_images_patch — Patches the specified image with the data included in the request.
1316
- google_compute_images_delete — Deletes the specified image.
1317
- google_compute_images_get_from_family — Returns the latest image that is part of an image family and is not
1318
- google_compute_snapshots_list — Retrieves the list of Snapshot resources contained within
1319
- google_compute_snapshots_insert — Creates a snapshot in the specified project using the data included
1320
- google_compute_snapshots_get — Returns the specified Snapshot resource.
1321
- google_compute_snapshots_delete — Deletes the specified Snapshot resource. Keep in mind that deleting
1322
- google_compute_disks_list — Retrieves a list of persistent disks contained within
1323
- google_compute_disks_insert — Creates a persistent disk in the specified project using the data
1324
- google_compute_disks_get — Returns the specified persistent disk.
1325
- google_compute_disks_update — Updates the specified disk with the data included in the request.
1326
- google_compute_disks_delete — Deletes the specified persistent disk. Deleting a disk removes its data
1327
- google_compute_disks_resize — Resizes the specified persistent disk.
1328
- google_compute_instances_list — Retrieves the list of instances contained within
1329
- google_compute_instances_insert — Creates an instance resource in the specified project using the data
1330
- google_compute_instances_get — Returns the specified Instance resource.
1331
- google_compute_instances_update — Updates an instance only if the necessary resources are available. This
1332
- google_compute_instances_delete — Deletes the specified Instance resource. For more information, seeDeleting
1333
- google_compute_instances_reset — Performs a reset on the instance. This is a hard reset. The VM
1334
- google_compute_instances_get_serial_port_output — Returns the last 1 MB of serial port output from the specified instance.
1335
- google_compute_instances_get_screenshot — Returns the screenshot from the specified instance.
1336
- google_compute_instances_get_guest_attributes — Returns the specified guest attributes entry.
1337
- google_compute_instances_attach_disk — Attaches an existing Disk resource to an instance. You must first
1338
- google_compute_instances_detach_disk — Detaches a disk from an instance.
1339
- google_compute_instances_set_machine_type — Changes the machine type for a stopped instance to the machine
1340
- google_compute_instances_set_metadata — Sets metadata for the specified instance to the data included
1341
- google_compute_instances_set_labels — Sets labels on an instance. To learn more about labels, read theLabeling
1342
- google_compute_instances_start — Starts an instance that was stopped using theinstances().stop
1343
- google_compute_instances_stop — Stops a running instance, shutting it down cleanly, and allows
1344
- google_compute_instances_suspend — This method suspends a running instance, saving its state to persistent
1345
- google_compute_instances_resume — Resumes an instance that was suspended using theinstances().suspend
1346
- google_compute_disk_types_list — Retrieves a list of disk types available to the specified
1347
- google_compute_disk_types_get — Returns the specified disk type.
1348
- google_compute_instance_templates_list — Retrieves a list of instance templates that are contained within
1349
- google_compute_instance_templates_insert — Creates an instance template in the specified project using the
1350
- google_compute_instance_templates_get — Returns the specified instance template.
1351
- google_compute_instance_templates_delete — Deletes the specified instance template. Deleting an instance template is
1352
- google_compute_machine_types_list — Retrieves a list of machine types available to the specified
1353
- google_compute_machine_types_get — Returns the specified machine type.
1354
- google_compute_networks_list — Retrieves the list of networks available to the specified project.
1355
- google_compute_networks_insert — Creates a network in the specified project using the data included
1356
- google_compute_networks_get — Returns the specified network.
1357
- google_compute_networks_patch — Patches the specified network with the data included in the request.
1358
- google_compute_networks_delete — Deletes the specified network.
1359
- google_compute_projects_get — Returns the specified Project resource.
1360
- google_compute_regions_list — Retrieves the list of region resources available to the specified project.
1361
- google_compute_regions_get — Returns the specified Region resource.
1362
- google_compute_subnetworks_list — Retrieves a list of subnetworks available to the specified
1363
- google_compute_subnetworks_insert — Creates a subnetwork in the specified project using the data
1364
- google_compute_subnetworks_get — Returns the specified subnetwork.
1365
- google_compute_subnetworks_patch — Patches the specified subnetwork with the data included in the request.
1366
- google_compute_subnetworks_delete — Deletes the specified subnetwork.
1367
- google_compute_zones_list — Retrieves the list of Zone resources available to the specified project.
1368
- google_compute_zones_get — Returns the specified Zone resource.
1369
- ```
1370
-
1371
- #### Google Logging (`google_logging_` prefix, 36 tools)
1372
-
1373
- ```
1374
- google_logging_monitored_resource_descriptors_list — Lists the descriptors for monitored resource types used by Logging.
1375
- google_logging_entries_write — Writes log entries to Logging. This API method is the only way to send log entries to Logging. This method is used, directly or indirectly, by the Logging agent (fluentd) and all logging libraries configured to use Logging. A single request may contain log entries for a maximum of 1000 different resource names (projects, organizations, billing accounts or folders), where the resource name for a log entry is determined from its logName field.
1376
- google_logging_entries_copy — Copies a set of log entries from a log bucket to a Cloud Storage bucket.
1377
- google_logging_entries_tail — Streaming read of log entries as they are received. Until the stream is terminated, it will continue reading logs.
1378
- google_logging_entries_list — Lists log entries. Use this method to retrieve log entries that originated from a project/folder/organization/billing account. For ways to export log entries, see Exporting Logs (https://cloud.google.com/logging/docs/export).
1379
- google_logging_billing_accounts_locations_operations_list — Lists operations that match the specified filter in the request. If the server doesn't support this method, it returns UNIMPLEMENTED.
1380
- google_logging_billing_accounts_locations_operations_cancel — Starts asynchronous cancellation on a long-running operation. The server makes a best effort to cancel the operation, but success is not guaranteed. If the server doesn't support this method, it returns google.rpc.Code.UNIMPLEMENTED. Clients can use Operations.GetOperation or other methods to check whether the cancellation succeeded or whether the operation completed despite cancellation. On successful cancellation, the operation is not deleted; instead, it becomes an operation with an Operation.error value with a google.rpc.Status.code of 1, corresponding to Code.CANCELLED.
1381
- google_logging_billing_accounts_locations_buckets_update_async — Updates a log bucket asynchronously.If the bucket has a lifecycle_state of DELETE_REQUESTED, then FAILED_PRECONDITION will be returned.After a bucket has been created, the bucket's location cannot be changed.
1382
- google_logging_billing_accounts_locations_buckets_undelete — Undeletes a log bucket. A bucket that has been deleted can be undeleted within the grace period of 7 days.
1383
- google_logging_billing_accounts_locations_buckets_list — Lists log buckets.
1384
- google_logging_billing_accounts_locations_buckets_create — Creates a log bucket that can be used to store log entries. After a bucket has been created, the bucket's location cannot be changed.
1385
- google_logging_billing_accounts_locations_buckets_create_async — Creates a log bucket asynchronously that can be used to store log entries.After a bucket has been created, the bucket's location cannot be changed.
1386
- google_logging_billing_accounts_locations_buckets_views_list — Lists views on a log bucket.
1387
- google_logging_billing_accounts_locations_buckets_views_create — Creates a view over log entries in a log bucket. A bucket may contain a maximum of 30 views.
1388
- google_logging_billing_accounts_sinks_get — Gets a sink.
1389
- google_logging_billing_accounts_sinks_update — Updates a sink. This method replaces the values of the destination and filter fields of the existing sink with the corresponding values from the new sink.The updated sink might also have a new writer_identity; see the unique_writer_identity field.
1390
- google_logging_billing_accounts_sinks_patch — Updates a sink. This method replaces the values of the destination and filter fields of the existing sink with the corresponding values from the new sink.The updated sink might also have a new writer_identity; see the unique_writer_identity field.
1391
- google_logging_billing_accounts_sinks_delete — Deletes a sink. If the sink has a unique writer_identity, then that service account is also deleted.
1392
- google_logging_billing_accounts_sinks_list — Lists sinks.
1393
- google_logging_billing_accounts_sinks_create — Creates a sink that exports specified log entries to a destination. The export begins upon ingress, unless the sink's writer_identity is not permitted to write to the destination. A sink can export log entries only from the resource owning the sink.
1394
- google_logging_billing_accounts_get_settings — Gets the settings for the given resource.Note: Settings can be retrieved for Google Cloud projects, folders, organizations, and billing accounts.See View default resource settings for Logging (https://docs.cloud.google.com/logging/docs/default-settings#view-org-settings) for more information.
1395
- google_logging_folders_update_settings — Updates the settings for the given resource. This method applies to all feature configurations for organization and folders.UpdateSettings fails when any of the following are true: The value of storage_location either isn't supported by Logging or violates the location OrgPolicy. The default_sink_config field is set, but it has an unspecified filter write mode. The value of kms_key_name is invalid. The associated service account doesn't have the required roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key. Access to the key is disabled.See Configure default settings for organizations and folders (https://docs.cloud.google.com/logging/docs/default-settings) for more information.
1396
- google_logging_billing_accounts_get_cmek_settings — Gets the Logging CMEK settings for the given resource.Note: CMEK for the Log Router can be configured for Google Cloud projects, folders, organizations, and billing accounts. Once configured for an organization, it applies to all projects and folders in the Google Cloud organization.See Configure CMEK for Cloud Logging (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more information.
1397
- google_logging_organizations_update_cmek_settings — Updates the Log Router CMEK settings for the given resource.Note: CMEK for the Log Router can currently only be configured for Google Cloud organizations. Once configured, it applies to all projects and folders in the Google Cloud organization.UpdateCmekSettings fails when any of the following are true: The value of kms_key_name is invalid. The associated service account doesn't have the required roles/cloudkms.cryptoKeyEncrypterDecrypter role assigned for the key. Access to the key is disabled.See Configure CMEK for Cloud Logging (https://docs.cloud.google.com/logging/docs/routing/managed-encryption) for more information.
1398
- google_logging_billing_accounts_locations_recent_queries_list — Lists the RecentQueries that were created by the user making the request.
1399
- google_logging_logs_list — Lists the logs in projects, organizations, folders, or billing accounts. Only logs that have entries are listed.
1400
- google_logging_billing_accounts_locations_saved_queries_list — Lists the SavedQueries that were created by the user making the request.
1401
- google_logging_billing_accounts_locations_saved_queries_create — Creates a new SavedQuery for the user making the request.
1402
- google_logging_logs_delete — Deletes all the log entries in a log for the global _Default Log Bucket. The log reappears if it receives new entries. Log entries written shortly before the delete operation might not be deleted. Entries received after the delete operation with a timestamp before the operation will be deleted.
1403
- google_logging_exclusions_list — Lists all the exclusions on the _Default sink in a parent resource.
1404
- google_logging_exclusions_create — Creates a new exclusion in the _Default sink in a specified parent resource. Only log entries belonging to that resource can be excluded. You can have up to 10 exclusions in a resource.
1405
- google_logging_projects_metrics_list — Lists logs-based metrics.
1406
- google_logging_projects_metrics_create — Creates a logs-based metric.
1407
- google_logging_projects_metrics_get — Gets a logs-based metric.
1408
- google_logging_projects_metrics_update — Creates or updates a logs-based metric.
1409
- google_logging_projects_metrics_delete — Deletes a logs-based metric.
1410
- ```
1411
-
1412
- #### Jira (`jira_` prefix, 74 tools)
1413
-
1414
- ```
1415
- jira_get_all_dashboards — Get all dashboards
1416
- jira_create_dashboard — Create dashboard
1417
- jira_get_dashboard — Get dashboard
1418
- jira_update_dashboard — Update dashboard
1419
- jira_delete_dashboard — Delete dashboard
1420
- jira_get_fields — Get fields
1421
- jira_create_custom_field — Create custom field
1422
- jira_update_custom_field — Update custom field
1423
- jira_create_filter — Create filter
1424
- jira_get_filters_paginated — Search for filters
1425
- jira_get_filter — Get filter
1426
- jira_update_filter — Update filter
1427
- jira_delete_filter — Delete filter
1428
- jira_create_issue — Create issue
1429
- jira_get_issue — Get issue
1430
- jira_edit_issue — Edit issue
1431
- jira_delete_issue — Delete issue
1432
- jira_add_attachment — Add attachment
1433
- jira_get_change_logs — Get changelogs
1434
- jira_get_comments — Get comments
1435
- jira_add_comment — Add comment
1436
- jira_get_comment — Get comment
1437
- jira_update_comment — Update comment
1438
- jira_delete_comment — Delete comment
1439
- jira_get_transitions — Get transitions
1440
- jira_do_transition — Transition issue
1441
- jira_get_issue_watchers — Get issue watchers
1442
- jira_add_watcher — Add watcher
1443
- jira_remove_watcher — Delete watcher
1444
- jira_get_issue_worklog — Get issue worklogs
1445
- jira_add_worklog — Add worklog
1446
- jira_bulk_delete_worklogs — Bulk delete worklogs
1447
- jira_get_worklog — Get worklog
1448
- jira_update_worklog — Update worklog
1449
- jira_delete_worklog — Delete worklog
1450
- jira_link_issues — Create issue link
1451
- jira_get_issue_link — Get issue link
1452
- jira_delete_issue_link — Delete issue link
1453
- jira_get_issue_link_types — Get issue link types
1454
- jira_create_issue_link_type — Create issue link type
1455
- jira_get_issue_all_types — Get all issue types for user
1456
- jira_create_issue_type — Create issue type
1457
- jira_get_issue_types_for_project — Get issue types for project
1458
- jira_get_issue_type — Get issue type
1459
- jira_update_issue_type — Update issue type
1460
- jira_delete_issue_type — Delete issue type
1461
- jira_get_my_permissions — Get my permissions
1462
- jira_get_current_user — Get current user
1463
- jira_get_notification_schemes — Get notification schemes paginated
1464
- jira_create_notification_scheme — Create notification scheme
1465
- jira_get_all_permissions — Get all permissions
1466
- jira_get_priorities — Get priorities
1467
- jira_create_priority — Create priority
1468
- jira_get_priority — Get priority
1469
- jira_update_priority — Update priority
1470
- jira_delete_priority — Delete priority
1471
- jira_get_all_projects — Get all projects
1472
- jira_create_project — Create project
1473
- jira_get_project — Get project
1474
- jira_update_project — Update project
1475
- jira_delete_project — Delete project
1476
- jira_get_project_components — Get project components
1477
- jira_get_all_statuses — Get all statuses for project
1478
- jira_get_project_versions — Get project versions
1479
- jira_search_and_reconsile_issues_using_jql — Search for issues using JQL enhanced search (GET)
1480
- jira_search_and_reconsile_issues_using_jql_post — Search for issues using JQL enhanced search (POST)
1481
- jira_get_server_info — Get Jira instance info
1482
- jira_get_statuses — Get all statuses
1483
- jira_get_status — Get status
1484
- jira_get_user — Get user
1485
- jira_create_user — Create user
1486
- jira_remove_user — Delete user
1487
- jira_find_assignable_users — Find users assignable to issues
1488
- jira_find_users — Find users
1489
- ```
1490
-
1491
- #### Linear (`linear_` prefix, 1 tools)
1492
-
1493
- ```
1494
- linear_graphql_query — Execute a GraphQL query or mutation against the Linear API
1495
- ```
1496
-
1497
- #### Slack (`slack_` prefix, 49 tools)
1498
-
1499
- ```
1500
- slack_api_test — Checks API calling code.
1501
- slack_auth_test — Checks authentication & identity.
1502
- slack_bots_info — Gets information about a bot user.
1503
- slack_chat_delete — Deletes a message.
1504
- slack_chat_delete_scheduled_message — Deletes a pending scheduled message from the queue.
1505
- slack_chat_get_permalink — Retrieve a permalink URL for a specific extant message
1506
- slack_chat_post_ephemeral — Sends an ephemeral message to a user in a channel.
1507
- slack_chat_post_message — Sends a message to a channel.
1508
- slack_chat_schedule_message — Schedules a message to be sent to a channel.
1509
- slack_chat_scheduled_messages_list — Returns a list of scheduled messages.
1510
- slack_chat_update — Updates a message.
1511
- slack_conversations_archive — Archives a conversation.
1512
- slack_conversations_history — Fetches a conversation's history of messages and events.
1513
- slack_conversations_info — Retrieve information about a conversation.
1514
- slack_conversations_invite — Invites users to a channel.
1515
- slack_conversations_join — Joins an existing conversation.
1516
- slack_conversations_leave — Leaves a conversation.
1517
- slack_conversations_list — Lists all channels in a Slack team.
1518
- slack_conversations_members — Retrieve members of a conversation.
1519
- slack_conversations_replies — Retrieve a thread of messages posted to a conversation
1520
- slack_conversations_set_purpose — Sets the purpose for a conversation.
1521
- slack_conversations_set_topic — Sets the topic for a conversation.
1522
- slack_conversations_unarchive — Reverses conversation archival.
1523
- slack_emoji_list — Lists custom emoji for a team.
1524
- slack_files_delete — Deletes a file.
1525
- slack_files_info — Gets information about a file.
1526
- slack_files_remote_share — Share a remote file into a channel.
1527
- slack_pins_add — Pins an item to a channel.
1528
- slack_pins_list — Lists items pinned to a channel.
1529
- slack_pins_remove — Un-pins an item from a channel.
1530
- slack_reactions_add — Adds a reaction to an item.
1531
- slack_reactions_get — Gets reactions for an item.
1532
- slack_reactions_list — Lists reactions made by a user.
1533
- slack_reactions_remove — Removes a reaction from an item.
1534
- slack_reminders_add — Creates a reminder.
1535
- slack_reminders_complete — Marks a reminder as complete.
1536
- slack_reminders_delete — Deletes a reminder.
1537
- slack_reminders_list — Lists all reminders created by or for a given user.
1538
- slack_team_info — Gets information about the current team.
1539
- slack_usergroups_create — Create a User Group
1540
- slack_usergroups_list — List all User Groups for a team
1541
- slack_usergroups_update — Update an existing User Group
1542
- slack_usergroups_users_list — List all users in a User Group
1543
- slack_usergroups_users_update — Update the list of users for a User Group
1544
- slack_users_get_presence — Gets user presence information.
1545
- slack_users_info — Gets information about a user.
1546
- slack_users_list — Lists all users in a Slack team.
1547
- slack_users_lookup_by_email — Find a user with an email address.
1548
- slack_users_profile_get — Retrieves a user's profile information.
1549
- ```
1550
-
1551
- #### TestRail (`testrail_` prefix, 18 tools)
1552
-
1553
- ```
1554
- testrail_get_projects — Returns the list of available projects. Use this to discover project IDs for other API calls.
1555
- testrail_get_project — Returns an existing project by ID.
1556
- testrail_get_suites — Returns the list of test suites for a project. Only relevant for projects using multiple test suites.
1557
- testrail_get_suite — Returns an existing test suite by ID.
1558
- testrail_get_sections — Returns the list of sections for a project and test suite. Sections organize test cases hierarchically.
1559
- testrail_get_section — Returns an existing section by ID.
1560
- testrail_get_cases — Returns the list of test cases for a project. Can filter by suite, section, priority, and more.
1561
- testrail_get_case — Returns an existing test case by ID. Includes all case fields like title, steps, expected results, and custom fields.
1562
- testrail_get_attachments_for_case — Returns the list of attachments for a test case.
1563
- testrail_get_attachment — Downloads an attachment by ID. Returns binary file content. Requires TestRail 5.7 or later.
1564
- testrail_get_runs — Returns the list of test runs for a project.
1565
- testrail_get_run — Returns an existing test run by ID.
1566
- testrail_get_tests — Returns the list of tests in a test run. Tests are instances of test cases within a run.
1567
- testrail_get_test — Returns an existing test by ID.
1568
- testrail_get_results — Returns the list of test results for a test.
1569
- testrail_get_results_for_case — Returns the list of test results for a test case within a specific run.
1570
- testrail_get_current_user — Returns the current user. Useful for validating credentials.
1571
- testrail_get_users — Returns the list of users.
1572
- ```
1573
-
1574
- #### Zendesk (`zendesk_` prefix, 15 tools)
1575
-
1576
- ```
1577
- zendesk_list_tickets — List all tickets.
1578
- zendesk_create_ticket — Create a new ticket. Body must include a 'ticket' object with at least a 'subject' and 'comment' with 'body'.
1579
- zendesk_show_ticket — Get a specific ticket by ID.
1580
- zendesk_update_ticket — Update a ticket (status, priority, assignee, add comment, etc.).
1581
- zendesk_list_ticket_comments — List all comments on a ticket.
1582
- zendesk_search — Search across tickets, users, and organizations using Zendesk search syntax. Example queries: 'type:ticket status:open', 'type:user email:foo@bar.com'.
1583
- zendesk_list_users — List all users.
1584
- zendesk_show_user — Get a specific user by ID.
1585
- zendesk_list_organizations — List all organizations.
1586
- zendesk_show_organization — Get a specific organization by ID.
1587
- zendesk_list_groups — List all agent groups.
1588
- zendesk_list_ticket_fields — List all ticket fields (custom and system).
1589
- zendesk_list_views — List all shared and personal views.
1590
- zendesk_execute_view — Execute a view and return matching tickets.
1591
- zendesk_list_satisfaction_ratings — List all satisfaction ratings.
1592
- ```
1593
-
1594
- <!-- END GENERATED TOOL CATALOG -->
1595
-
1596
827
  ### NEVER `pick()` from `guildTools`
1597
828
 
1598
829
  **CRITICAL: Always spread `guildTools` fully. NEVER use `pick(guildTools, [...])`.**
@@ -1685,16 +916,78 @@ export default agent({ run: async (input, task) => { ... } })
1685
916
 
1686
917
  ---
1687
918
 
919
+ ## External Prompts
920
+
921
+ Don't embed long prompts as strings in your code — import them as `.md` files instead.
922
+
923
+ ```typescript
924
+ import { llmAgent } from '@guildai/agents-sdk';
925
+ import systemPrompt from './system-prompt.md';
926
+
927
+ export default llmAgent({
928
+ description: 'My agent',
929
+ systemPrompt,
930
+ tools: {
931
+ /* ... */
932
+ },
933
+ });
934
+ ```
935
+
936
+ Then write your prompt in a standalone `system-prompt.md`:
937
+
938
+ ```markdown
939
+ <!-- system-prompt.md -->
940
+
941
+ You are a helpful assistant that...
942
+
943
+ [...detailed instructions...]
944
+
945
+ Good luck!
946
+ ```
947
+
948
+ Your editor treats `.md` files as first-class citizens: syntax highlighting, preview, spell-check. Long prompt strings buried in TypeScript get none of that, and they make the surrounding logic harder to read.
949
+
950
+ The `--loader:.md=text` flag in the bundle script handles importing `.md` files at build time.
951
+
952
+ ---
953
+
1688
954
  ## package.json
1689
955
 
956
+ Agents that use `"use agent"` (automatic state agents) need the Babel compiler to transform `await task.tools.*` calls into continuations. New agent templates include this by default. The `bundle` script must be separate from and run _after_ the `build` step — don't merge them.
957
+
1690
958
  ```json
1691
959
  {
1692
960
  "name": "guild-agent-{name}",
1693
961
  "version": "1.0.0",
1694
962
  "author": "Guild.ai",
1695
963
  "type": "module",
964
+ "scripts": {
965
+ "build": "npm run build:compile && npm run build:transform && npm run build:copy",
966
+ "build:compile": "tsc --build",
967
+ "build:transform": "babel ./dist/agent.js --out-dir ./dist --out-file-extension .compiled.js --plugins @guildai/babel-plugin-agent-compiler",
968
+ "build:copy": "cp *.md dist/",
969
+ "bundle": "npm run build && esbuild dist/agent.compiled.js --bundle --loader:.md=text --platform=node --format=esm --external:zod --external:@guildai/agents-sdk | gzip | base64 > agent.js.gz"
970
+ },
1696
971
  "dependencies": {},
1697
972
  "devDependencies": {
973
+ "@babel/cli": "^7.28.3",
974
+ "@guildai/babel-plugin-agent-compiler": "*",
975
+ "esbuild": "^0.25.0",
976
+ "typescript": "^5.0.0"
977
+ }
978
+ }
979
+ ```
980
+
981
+ For simple `llmAgent()` agents that don't use `"use agent"`, you can skip the Babel step:
982
+
983
+ ```json
984
+ {
985
+ "scripts": {
986
+ "build": "tsc",
987
+ "bundle": "npm run build && esbuild dist/agent.js --bundle --loader:.md=text --platform=node --format=esm --external:zod --external:@guildai/agents-sdk | gzip | base64 > agent.js.gz"
988
+ },
989
+ "devDependencies": {
990
+ "esbuild": "^0.25.0",
1698
991
  "typescript": "^5.0.0"
1699
992
  }
1700
993
  }
@@ -1704,7 +997,7 @@ export default agent({ run: async (input, task) => { ... } })
1704
997
 
1705
998
  - Do NOT add `@guildai/agents-sdk`, `@guildai-services/*`, or `zod` to dependencies. The runtime provides them.
1706
999
  - DO add third-party ESM-compatible packages your agent uses to `dependencies`. Note: CJS-only packages (e.g., `slackify-markdown`) will break in the ESM agent runtime — use inline alternatives instead.
1707
- - `devDependencies` is for build tools only.
1000
+ - `devDependencies` is for build tools only (`esbuild` for bundling, `typescript` for compilation).
1708
1001
 
1709
1002
  ## Versioning
1710
1003
 
@@ -1748,6 +1041,8 @@ guild agent save --message "v1.0" --wait --publish # Save + validate + publish
1748
1041
  guild agent save --bump minor --message "v1.1" # Auto-bump version before saving
1749
1042
  guild agent test # Interactive test
1750
1043
  guild agent test --ephemeral # Ephemeral test
1044
+ guild agent test --bundle agent.js.gz # Test with pre-built bundle
1045
+ guild agent test --no-cache # Force fresh build (skip cache)
1751
1046
  guild agent chat "Hello" # Test with input
1752
1047
  guild agent get [agent-id] # View agent info
1753
1048
  guild agent list # List agents