UNPKG

@gitpod/sdk

Version:
1,368 lines 93.4 kB
import type { GenEnum, GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv2"; import type { AgentCodeContext, AgentExecution_Status_OutputValue, CodexSettings, PullRequest } from "./agent_pb"; import type { CountRequest, CountResponse } from "./count_pb"; import type { Subject } from "./identity_pb"; import type { PaginationRequest, PaginationResponse, Sort, SortOrder } from "./pagination_pb"; import type { DateRange } from "./usage_pb"; import type { WorkflowError } from "./workflow_error_pb"; import type { Duration, Timestamp } from "@bufbuild/protobuf/wkt"; import type { Message } from "@bufbuild/protobuf"; /** * Describes the file gitpod/v1/workflow.proto. */ export declare const file_gitpod_v1_workflow: GenFile; /** * CreateWorkflowRequest creates a new workflow. * * @generated from message gitpod.v1.CreateWorkflowRequest */ export type CreateWorkflowRequest = Message<"gitpod.v1.CreateWorkflowRequest"> & { /** * @generated from field: string name = 1; */ name: string; /** * @generated from field: string description = 2; */ description: string; /** * @generated from field: repeated gitpod.v1.WorkflowTrigger triggers = 3; */ triggers: WorkflowTrigger[]; /** * @generated from field: gitpod.v1.WorkflowAction action = 4; */ action?: WorkflowAction; /** * @generated from field: gitpod.v1.WorkflowAction report = 5; */ report?: WorkflowAction; /** * Optional executor for the workflow. If not provided, defaults to the creator. * Must be either the caller themselves or a service account. * * @generated from field: optional gitpod.v1.Subject executor = 6; */ executor?: Subject; /** * Agent that runs this workflow. When empty, the agent is resolved at run * time (defaults to the Ona agent). * * @generated from field: string agent_id = 7; */ agentId: string; /** * Codex app agent settings. Only meaningful when agent_id refers to the * Codex app agent. * * @generated from field: gitpod.v1.CodexSettings codex_settings = 8; */ codexSettings?: CodexSettings; }; /** * Describes the message gitpod.v1.CreateWorkflowRequest. * Use `create(CreateWorkflowRequestSchema)` to create a new message. */ export declare const CreateWorkflowRequestSchema: GenMessage<CreateWorkflowRequest>; /** * @generated from message gitpod.v1.CreateWorkflowResponse */ export type CreateWorkflowResponse = Message<"gitpod.v1.CreateWorkflowResponse"> & { /** * @generated from field: gitpod.v1.Workflow workflow = 1; */ workflow?: Workflow; }; /** * Describes the message gitpod.v1.CreateWorkflowResponse. * Use `create(CreateWorkflowResponseSchema)` to create a new message. */ export declare const CreateWorkflowResponseSchema: GenMessage<CreateWorkflowResponse>; /** * GetWorkflowRequest gets details about a specific workflow. * * @generated from message gitpod.v1.GetWorkflowRequest */ export type GetWorkflowRequest = Message<"gitpod.v1.GetWorkflowRequest"> & { /** * @generated from field: string workflow_id = 1; */ workflowId: string; }; /** * Describes the message gitpod.v1.GetWorkflowRequest. * Use `create(GetWorkflowRequestSchema)` to create a new message. */ export declare const GetWorkflowRequestSchema: GenMessage<GetWorkflowRequest>; /** * @generated from message gitpod.v1.GetWorkflowResponse */ export type GetWorkflowResponse = Message<"gitpod.v1.GetWorkflowResponse"> & { /** * @generated from field: gitpod.v1.Workflow workflow = 1; */ workflow?: Workflow; }; /** * Describes the message gitpod.v1.GetWorkflowResponse. * Use `create(GetWorkflowResponseSchema)` to create a new message. */ export declare const GetWorkflowResponseSchema: GenMessage<GetWorkflowResponse>; /** * UpdateWorkflowRequest updates a workflow's configuration. * * @generated from message gitpod.v1.UpdateWorkflowRequest */ export type UpdateWorkflowRequest = Message<"gitpod.v1.UpdateWorkflowRequest"> & { /** * @generated from field: string workflow_id = 1; */ workflowId: string; /** * @generated from field: optional string name = 2; */ name?: string; /** * @generated from field: optional string description = 3; */ description?: string; /** * @generated from field: repeated gitpod.v1.WorkflowTrigger triggers = 4; */ triggers: WorkflowTrigger[]; /** * @generated from field: optional gitpod.v1.WorkflowAction action = 5; */ action?: WorkflowAction; /** * @generated from field: optional gitpod.v1.WorkflowAction report = 6; */ report?: WorkflowAction; /** * @generated from field: optional gitpod.v1.Subject executor = 7; */ executor?: Subject; /** * When set, enables or disables the workflow. A disabled workflow will not * be triggered by any automatic trigger and manual starts are rejected. * * @generated from field: optional bool disabled = 8; */ disabled?: boolean; /** * Agent that runs this workflow. When empty, the agent is resolved at run * time (defaults to the Ona agent). * * @generated from field: optional string agent_id = 9; */ agentId?: string; /** * Codex app agent settings. Only meaningful when agent_id refers to the * Codex app agent. * * @generated from field: optional gitpod.v1.CodexSettings codex_settings = 10; */ codexSettings?: CodexSettings; }; /** * Describes the message gitpod.v1.UpdateWorkflowRequest. * Use `create(UpdateWorkflowRequestSchema)` to create a new message. */ export declare const UpdateWorkflowRequestSchema: GenMessage<UpdateWorkflowRequest>; /** * @generated from message gitpod.v1.UpdateWorkflowResponse */ export type UpdateWorkflowResponse = Message<"gitpod.v1.UpdateWorkflowResponse"> & { /** * @generated from field: gitpod.v1.Workflow workflow = 1; */ workflow?: Workflow; }; /** * Describes the message gitpod.v1.UpdateWorkflowResponse. * Use `create(UpdateWorkflowResponseSchema)` to create a new message. */ export declare const UpdateWorkflowResponseSchema: GenMessage<UpdateWorkflowResponse>; /** * ListWorkflowsRequest lists workflows with optional filtering. * * @generated from message gitpod.v1.ListWorkflowsRequest */ export type ListWorkflowsRequest = Message<"gitpod.v1.ListWorkflowsRequest"> & { /** * @generated from field: gitpod.v1.PaginationRequest pagination = 1; */ pagination?: PaginationRequest; /** * @generated from field: gitpod.v1.ListWorkflowsRequest.Filter filter = 2; */ filter?: ListWorkflowsRequest_Filter; /** * sort specifies the order of results. When unspecified, results are sorted * alphabetically by name ascending. * * @generated from field: gitpod.v1.ListWorkflowsRequest.Sort sort = 3; */ sort?: ListWorkflowsRequest_Sort; /** * count controls whether the response includes a bounded total count. * * @generated from field: gitpod.v1.CountRequest count = 4; */ count?: CountRequest; }; /** * Describes the message gitpod.v1.ListWorkflowsRequest. * Use `create(ListWorkflowsRequestSchema)` to create a new message. */ export declare const ListWorkflowsRequestSchema: GenMessage<ListWorkflowsRequest>; /** * @generated from message gitpod.v1.ListWorkflowsRequest.Filter */ export type ListWorkflowsRequest_Filter = Message<"gitpod.v1.ListWorkflowsRequest.Filter"> & { /** * @generated from field: repeated string workflow_ids = 1; */ workflowIds: string[]; /** * search performs case-insensitive search across workflow name, description, and ID * * @generated from field: string search = 2; */ search: string; /** * creator_ids filters workflows by creator user IDs * * @generated from field: repeated string creator_ids = 3; */ creatorIds: string[]; /** * status_phases filters workflows by the phase of their latest execution. * Only workflows whose most recent execution matches one of the specified phases are returned. * * @generated from field: repeated gitpod.v1.WorkflowExecutionPhase status_phases = 4; */ statusPhases: WorkflowExecutionPhase[]; /** * has_failed_execution_since filters workflows that have at least one failed execution * with create_time >= the specified timestamp. A failed execution is one that is COMPLETED * with failed_action_count > 0, or STOPPED with failed_action_count > 0 or a non-empty * failure_message. This filter is mutually exclusive with status_phases. * * @generated from field: google.protobuf.Timestamp has_failed_execution_since = 5; */ hasFailedExecutionSince?: Timestamp; /** * disabled filters workflows by their disabled state. * When set to true, only disabled workflows are returned. * When set to false, only enabled workflows are returned. * When unset, all workflows are returned regardless of disabled state. * * @generated from field: optional bool disabled = 6; */ disabled?: boolean; }; /** * Describes the message gitpod.v1.ListWorkflowsRequest.Filter. * Use `create(ListWorkflowsRequest_FilterSchema)` to create a new message. */ export declare const ListWorkflowsRequest_FilterSchema: GenMessage<ListWorkflowsRequest_Filter>; /** * @generated from message gitpod.v1.ListWorkflowsRequest.Sort */ export type ListWorkflowsRequest_Sort = Message<"gitpod.v1.ListWorkflowsRequest.Sort"> & { /** * @generated from field: gitpod.v1.ListWorkflowsRequest.SortField field = 1; */ field: ListWorkflowsRequest_SortField; /** * @generated from field: gitpod.v1.SortOrder order = 2; */ order: SortOrder; }; /** * Describes the message gitpod.v1.ListWorkflowsRequest.Sort. * Use `create(ListWorkflowsRequest_SortSchema)` to create a new message. */ export declare const ListWorkflowsRequest_SortSchema: GenMessage<ListWorkflowsRequest_Sort>; /** * @generated from enum gitpod.v1.ListWorkflowsRequest.SortField */ export declare enum ListWorkflowsRequest_SortField { /** * @generated from enum value: SORT_FIELD_UNSPECIFIED = 0; */ UNSPECIFIED = 0, /** * Sort alphabetically by workflow name. * * @generated from enum value: SORT_FIELD_NAME = 1; */ NAME = 1, /** * Sort by the most recent terminal execution's finished_at. * Workflows with no executions appear last. * * @generated from enum value: SORT_FIELD_RECENTLY_COMPLETED = 2; */ RECENTLY_COMPLETED = 2 } /** * Describes the enum gitpod.v1.ListWorkflowsRequest.SortField. */ export declare const ListWorkflowsRequest_SortFieldSchema: GenEnum<ListWorkflowsRequest_SortField>; /** * @generated from message gitpod.v1.ListWorkflowsResponse */ export type ListWorkflowsResponse = Message<"gitpod.v1.ListWorkflowsResponse"> & { /** * @generated from field: gitpod.v1.PaginationResponse pagination = 1; */ pagination?: PaginationResponse; /** * @generated from field: repeated gitpod.v1.Workflow workflows = 2; */ workflows: Workflow[]; /** * count is the bounded total count of matching workflows, present only when * requested via CountRequest.include on the first page. * * @generated from field: gitpod.v1.CountResponse count = 3; */ count?: CountResponse; }; /** * Describes the message gitpod.v1.ListWorkflowsResponse. * Use `create(ListWorkflowsResponseSchema)` to create a new message. */ export declare const ListWorkflowsResponseSchema: GenMessage<ListWorkflowsResponse>; /** * DeleteWorkflowRequest deletes a workflow permanently. * * @generated from message gitpod.v1.DeleteWorkflowRequest */ export type DeleteWorkflowRequest = Message<"gitpod.v1.DeleteWorkflowRequest"> & { /** * @generated from field: string workflow_id = 1; */ workflowId: string; /** * force indicates whether to immediately delete the workflow and all related resources. * When true, performs cascading deletion of: * - All workflow executions * - All workflow execution actions * - All environments created by workflow actions * - All agent executions created by workflow actions * - The workflow itself * When false (default), marks workflow executions for deletion and relies on * background reconciliation to clean up resources. * * @generated from field: bool force = 2; */ force: boolean; }; /** * Describes the message gitpod.v1.DeleteWorkflowRequest. * Use `create(DeleteWorkflowRequestSchema)` to create a new message. */ export declare const DeleteWorkflowRequestSchema: GenMessage<DeleteWorkflowRequest>; /** * @generated from message gitpod.v1.DeleteWorkflowResponse */ export type DeleteWorkflowResponse = Message<"gitpod.v1.DeleteWorkflowResponse"> & {}; /** * Describes the message gitpod.v1.DeleteWorkflowResponse. * Use `create(DeleteWorkflowResponseSchema)` to create a new message. */ export declare const DeleteWorkflowResponseSchema: GenMessage<DeleteWorkflowResponse>; /** * GetWorkflowWebhookSecretRequest retrieves the webhook secret for a workflow. * * @generated from message gitpod.v1.GetWorkflowWebhookSecretRequest */ export type GetWorkflowWebhookSecretRequest = Message<"gitpod.v1.GetWorkflowWebhookSecretRequest"> & { /** * @generated from field: string workflow_id = 1; */ workflowId: string; }; /** * Describes the message gitpod.v1.GetWorkflowWebhookSecretRequest. * Use `create(GetWorkflowWebhookSecretRequestSchema)` to create a new message. */ export declare const GetWorkflowWebhookSecretRequestSchema: GenMessage<GetWorkflowWebhookSecretRequest>; /** * @generated from message gitpod.v1.GetWorkflowWebhookSecretResponse */ export type GetWorkflowWebhookSecretResponse = Message<"gitpod.v1.GetWorkflowWebhookSecretResponse"> & { /** * The decrypted webhook secret * * @generated from field: string secret = 1; */ secret: string; }; /** * Describes the message gitpod.v1.GetWorkflowWebhookSecretResponse. * Use `create(GetWorkflowWebhookSecretResponseSchema)` to create a new message. */ export declare const GetWorkflowWebhookSecretResponseSchema: GenMessage<GetWorkflowWebhookSecretResponse>; /** * @generated from message gitpod.v1.RotateWorkflowWebhookSecretRequest */ export type RotateWorkflowWebhookSecretRequest = Message<"gitpod.v1.RotateWorkflowWebhookSecretRequest"> & { /** * @generated from field: string workflow_id = 1; */ workflowId: string; }; /** * Describes the message gitpod.v1.RotateWorkflowWebhookSecretRequest. * Use `create(RotateWorkflowWebhookSecretRequestSchema)` to create a new message. */ export declare const RotateWorkflowWebhookSecretRequestSchema: GenMessage<RotateWorkflowWebhookSecretRequest>; /** * @generated from message gitpod.v1.RotateWorkflowWebhookSecretResponse */ export type RotateWorkflowWebhookSecretResponse = Message<"gitpod.v1.RotateWorkflowWebhookSecretResponse"> & { /** * The new webhook secret (decrypted) * * @generated from field: string secret = 1; */ secret: string; }; /** * Describes the message gitpod.v1.RotateWorkflowWebhookSecretResponse. * Use `create(RotateWorkflowWebhookSecretResponseSchema)` to create a new message. */ export declare const RotateWorkflowWebhookSecretResponseSchema: GenMessage<RotateWorkflowWebhookSecretResponse>; /** * StartWorkflowRequest starts a workflow execution. * * @generated from message gitpod.v1.StartWorkflowRequest */ export type StartWorkflowRequest = Message<"gitpod.v1.StartWorkflowRequest"> & { /** * @generated from field: string workflow_id = 1; */ workflowId: string; /** * Optional context override for the execution. * When provided, replaces the workflow's default trigger context. * User must have appropriate permissions on the overridden resources. * Supports Projects, Repositories, and Agent context types. * FromTrigger context type is not supported for manual overrides. * * @generated from field: optional gitpod.v1.WorkflowTriggerContext context_override = 2; */ contextOverride?: WorkflowTriggerContext; /** * Parameters to substitute into workflow steps using Go template syntax. * Use {{ .Parameters.key_name }} in templatable fields (task.command, agent.prompt, * pull_request.title/description/branch, trigger context agent.prompt). * Keys must match pattern ^[a-zA-Z_][a-zA-Z0-9_]*$ * Maximum 10 parameters allowed. * Empty map is treated as no parameters provided. * * @generated from field: map<string, string> parameters = 3; */ parameters: { [key: string]: string; }; }; /** * Describes the message gitpod.v1.StartWorkflowRequest. * Use `create(StartWorkflowRequestSchema)` to create a new message. */ export declare const StartWorkflowRequestSchema: GenMessage<StartWorkflowRequest>; /** * @generated from message gitpod.v1.StartWorkflowResponse */ export type StartWorkflowResponse = Message<"gitpod.v1.StartWorkflowResponse"> & { /** * @generated from field: gitpod.v1.WorkflowExecution workflow_execution = 1; */ workflowExecution?: WorkflowExecution; }; /** * Describes the message gitpod.v1.StartWorkflowResponse. * Use `create(StartWorkflowResponseSchema)` to create a new message. */ export declare const StartWorkflowResponseSchema: GenMessage<StartWorkflowResponse>; /** * ListWorkflowExecutionsRequest lists workflow executions with optional filtering. * * @generated from message gitpod.v1.ListWorkflowExecutionsRequest */ export type ListWorkflowExecutionsRequest = Message<"gitpod.v1.ListWorkflowExecutionsRequest"> & { /** * @generated from field: gitpod.v1.PaginationRequest pagination = 1; */ pagination?: PaginationRequest; /** * @generated from field: gitpod.v1.ListWorkflowExecutionsRequest.Filter filter = 2; */ filter?: ListWorkflowExecutionsRequest_Filter; /** * sort specifies the order of results. When unspecified, results are sorted by * operational priority (running first, then failed, then completed, then others). * Supported sort fields: startedAt, finishedAt, createdAt. * * @generated from field: gitpod.v1.Sort sort = 3; */ sort?: Sort; }; /** * Describes the message gitpod.v1.ListWorkflowExecutionsRequest. * Use `create(ListWorkflowExecutionsRequestSchema)` to create a new message. */ export declare const ListWorkflowExecutionsRequestSchema: GenMessage<ListWorkflowExecutionsRequest>; /** * @generated from message gitpod.v1.ListWorkflowExecutionsRequest.Filter */ export type ListWorkflowExecutionsRequest_Filter = Message<"gitpod.v1.ListWorkflowExecutionsRequest.Filter"> & { /** * @generated from field: repeated string workflow_execution_ids = 1; */ workflowExecutionIds: string[]; /** * @generated from field: repeated string workflow_ids = 2; */ workflowIds: string[]; /** * @generated from field: repeated gitpod.v1.WorkflowExecutionPhase status_phases = 3; */ statusPhases: WorkflowExecutionPhase[]; /** * @generated from field: optional bool has_failed_actions = 4; */ hasFailedActions?: boolean; /** * search performs case-insensitive search across workflow execution ID and trigger type * * @generated from field: string search = 5; */ search: string; }; /** * Describes the message gitpod.v1.ListWorkflowExecutionsRequest.Filter. * Use `create(ListWorkflowExecutionsRequest_FilterSchema)` to create a new message. */ export declare const ListWorkflowExecutionsRequest_FilterSchema: GenMessage<ListWorkflowExecutionsRequest_Filter>; /** * @generated from message gitpod.v1.ListWorkflowExecutionsResponse */ export type ListWorkflowExecutionsResponse = Message<"gitpod.v1.ListWorkflowExecutionsResponse"> & { /** * @generated from field: gitpod.v1.PaginationResponse pagination = 1; */ pagination?: PaginationResponse; /** * @generated from field: repeated gitpod.v1.WorkflowExecution workflow_executions = 2; */ workflowExecutions: WorkflowExecution[]; }; /** * Describes the message gitpod.v1.ListWorkflowExecutionsResponse. * Use `create(ListWorkflowExecutionsResponseSchema)` to create a new message. */ export declare const ListWorkflowExecutionsResponseSchema: GenMessage<ListWorkflowExecutionsResponse>; /** * GetWorkflowExecutionRequest gets details about a specific workflow execution. * * @generated from message gitpod.v1.GetWorkflowExecutionRequest */ export type GetWorkflowExecutionRequest = Message<"gitpod.v1.GetWorkflowExecutionRequest"> & { /** * @generated from field: string workflow_execution_id = 1; */ workflowExecutionId: string; }; /** * Describes the message gitpod.v1.GetWorkflowExecutionRequest. * Use `create(GetWorkflowExecutionRequestSchema)` to create a new message. */ export declare const GetWorkflowExecutionRequestSchema: GenMessage<GetWorkflowExecutionRequest>; /** * @generated from message gitpod.v1.GetWorkflowExecutionResponse */ export type GetWorkflowExecutionResponse = Message<"gitpod.v1.GetWorkflowExecutionResponse"> & { /** * @generated from field: gitpod.v1.WorkflowExecution workflow_execution = 1; */ workflowExecution?: WorkflowExecution; }; /** * Describes the message gitpod.v1.GetWorkflowExecutionResponse. * Use `create(GetWorkflowExecutionResponseSchema)` to create a new message. */ export declare const GetWorkflowExecutionResponseSchema: GenMessage<GetWorkflowExecutionResponse>; /** * CancelWorkflowExecutionRequest cancels a running workflow execution. * * @generated from message gitpod.v1.CancelWorkflowExecutionRequest */ export type CancelWorkflowExecutionRequest = Message<"gitpod.v1.CancelWorkflowExecutionRequest"> & { /** * @generated from field: string workflow_execution_id = 1; */ workflowExecutionId: string; }; /** * Describes the message gitpod.v1.CancelWorkflowExecutionRequest. * Use `create(CancelWorkflowExecutionRequestSchema)` to create a new message. */ export declare const CancelWorkflowExecutionRequestSchema: GenMessage<CancelWorkflowExecutionRequest>; /** * @generated from message gitpod.v1.CancelWorkflowExecutionResponse */ export type CancelWorkflowExecutionResponse = Message<"gitpod.v1.CancelWorkflowExecutionResponse"> & {}; /** * Describes the message gitpod.v1.CancelWorkflowExecutionResponse. * Use `create(CancelWorkflowExecutionResponseSchema)` to create a new message. */ export declare const CancelWorkflowExecutionResponseSchema: GenMessage<CancelWorkflowExecutionResponse>; /** * ListWorkflowExecutionActionsRequest lists workflow execution actions with optional filtering. * * @generated from message gitpod.v1.ListWorkflowExecutionActionsRequest */ export type ListWorkflowExecutionActionsRequest = Message<"gitpod.v1.ListWorkflowExecutionActionsRequest"> & { /** * @generated from field: gitpod.v1.PaginationRequest pagination = 1; */ pagination?: PaginationRequest; /** * @generated from field: gitpod.v1.ListWorkflowExecutionActionsRequest.Filter filter = 2; */ filter?: ListWorkflowExecutionActionsRequest_Filter; }; /** * Describes the message gitpod.v1.ListWorkflowExecutionActionsRequest. * Use `create(ListWorkflowExecutionActionsRequestSchema)` to create a new message. */ export declare const ListWorkflowExecutionActionsRequestSchema: GenMessage<ListWorkflowExecutionActionsRequest>; /** * @generated from message gitpod.v1.ListWorkflowExecutionActionsRequest.Filter */ export type ListWorkflowExecutionActionsRequest_Filter = Message<"gitpod.v1.ListWorkflowExecutionActionsRequest.Filter"> & { /** * @generated from field: repeated string workflow_execution_action_ids = 1; */ workflowExecutionActionIds: string[]; /** * @generated from field: repeated string workflow_execution_ids = 2; */ workflowExecutionIds: string[]; /** * @generated from field: repeated string workflow_ids = 3; */ workflowIds: string[]; /** * @generated from field: repeated gitpod.v1.WorkflowExecutionActionPhase phases = 4; */ phases: WorkflowExecutionActionPhase[]; }; /** * Describes the message gitpod.v1.ListWorkflowExecutionActionsRequest.Filter. * Use `create(ListWorkflowExecutionActionsRequest_FilterSchema)` to create a new message. */ export declare const ListWorkflowExecutionActionsRequest_FilterSchema: GenMessage<ListWorkflowExecutionActionsRequest_Filter>; /** * @generated from message gitpod.v1.ListWorkflowExecutionActionsResponse */ export type ListWorkflowExecutionActionsResponse = Message<"gitpod.v1.ListWorkflowExecutionActionsResponse"> & { /** * @generated from field: gitpod.v1.PaginationResponse pagination = 1; */ pagination?: PaginationResponse; /** * @generated from field: repeated gitpod.v1.WorkflowExecutionAction workflow_execution_actions = 2; */ workflowExecutionActions: WorkflowExecutionAction[]; }; /** * Describes the message gitpod.v1.ListWorkflowExecutionActionsResponse. * Use `create(ListWorkflowExecutionActionsResponseSchema)` to create a new message. */ export declare const ListWorkflowExecutionActionsResponseSchema: GenMessage<ListWorkflowExecutionActionsResponse>; /** * GetWorkflowExecutionActionRequest gets details about a specific workflow execution action. * * @generated from message gitpod.v1.GetWorkflowExecutionActionRequest */ export type GetWorkflowExecutionActionRequest = Message<"gitpod.v1.GetWorkflowExecutionActionRequest"> & { /** * @generated from field: string workflow_execution_action_id = 1; */ workflowExecutionActionId: string; }; /** * Describes the message gitpod.v1.GetWorkflowExecutionActionRequest. * Use `create(GetWorkflowExecutionActionRequestSchema)` to create a new message. */ export declare const GetWorkflowExecutionActionRequestSchema: GenMessage<GetWorkflowExecutionActionRequest>; /** * @generated from message gitpod.v1.GetWorkflowExecutionActionResponse */ export type GetWorkflowExecutionActionResponse = Message<"gitpod.v1.GetWorkflowExecutionActionResponse"> & { /** * @generated from field: gitpod.v1.WorkflowExecutionAction workflow_execution_action = 1; */ workflowExecutionAction?: WorkflowExecutionAction; }; /** * Describes the message gitpod.v1.GetWorkflowExecutionActionResponse. * Use `create(GetWorkflowExecutionActionResponseSchema)` to create a new message. */ export declare const GetWorkflowExecutionActionResponseSchema: GenMessage<GetWorkflowExecutionActionResponse>; /** * CancelWorkflowExecutionActionRequest cancels a running workflow execution action. * * @generated from message gitpod.v1.CancelWorkflowExecutionActionRequest */ export type CancelWorkflowExecutionActionRequest = Message<"gitpod.v1.CancelWorkflowExecutionActionRequest"> & { /** * @generated from field: string workflow_execution_action_id = 1; */ workflowExecutionActionId: string; }; /** * Describes the message gitpod.v1.CancelWorkflowExecutionActionRequest. * Use `create(CancelWorkflowExecutionActionRequestSchema)` to create a new message. */ export declare const CancelWorkflowExecutionActionRequestSchema: GenMessage<CancelWorkflowExecutionActionRequest>; /** * @generated from message gitpod.v1.CancelWorkflowExecutionActionResponse */ export type CancelWorkflowExecutionActionResponse = Message<"gitpod.v1.CancelWorkflowExecutionActionResponse"> & {}; /** * Describes the message gitpod.v1.CancelWorkflowExecutionActionResponse. * Use `create(CancelWorkflowExecutionActionResponseSchema)` to create a new message. */ export declare const CancelWorkflowExecutionActionResponseSchema: GenMessage<CancelWorkflowExecutionActionResponse>; /** * Workflow represents a workflow configuration. * * @generated from message gitpod.v1.Workflow */ export type Workflow = Message<"gitpod.v1.Workflow"> & { /** * @generated from field: string id = 1; */ id: string; /** * @generated from field: gitpod.v1.Workflow.Metadata metadata = 2; */ metadata?: Workflow_Metadata; /** * @generated from field: gitpod.v1.Workflow.Spec spec = 3; */ spec?: Workflow_Spec; /** * Webhook URL for triggering this workflow via HTTP POST * Format: {base_url}/workflows/{workflow_id}/webhooks * * @generated from field: string webhook_url = 4; */ webhookUrl: string; }; /** * Describes the message gitpod.v1.Workflow. * Use `create(WorkflowSchema)` to create a new message. */ export declare const WorkflowSchema: GenMessage<Workflow>; /** * WorkflowMetadata contains workflow metadata. * * @generated from message gitpod.v1.Workflow.Metadata */ export type Workflow_Metadata = Message<"gitpod.v1.Workflow.Metadata"> & { /** * @generated from field: string name = 1; */ name: string; /** * @generated from field: string description = 2; */ description: string; /** * @generated from field: gitpod.v1.Subject creator = 3; */ creator?: Subject; /** * @generated from field: gitpod.v1.Subject executor = 6; */ executor?: Subject; /** * @generated from field: google.protobuf.Timestamp created_at = 4; */ createdAt?: Timestamp; /** * @generated from field: google.protobuf.Timestamp updated_at = 5; */ updatedAt?: Timestamp; }; /** * Describes the message gitpod.v1.Workflow.Metadata. * Use `create(Workflow_MetadataSchema)` to create a new message. */ export declare const Workflow_MetadataSchema: GenMessage<Workflow_Metadata>; /** * @generated from message gitpod.v1.Workflow.Spec */ export type Workflow_Spec = Message<"gitpod.v1.Workflow.Spec"> & { /** * @generated from field: repeated gitpod.v1.WorkflowTrigger triggers = 3; */ triggers: WorkflowTrigger[]; /** * @generated from field: gitpod.v1.WorkflowAction action = 4; */ action?: WorkflowAction; /** * @generated from field: gitpod.v1.WorkflowAction report = 5; */ report?: WorkflowAction; /** * Marks workflow as pending deletion * * @generated from field: bool deleting = 6; */ deleting: boolean; /** * When true, the workflow will not be triggered by any automatic trigger * (cron, webhook, pull request). Manual starts via StartWorkflow are also * rejected while disabled. * * @generated from field: bool disabled = 7; */ disabled: boolean; /** * Agent that runs this workflow. When empty, the agent is resolved at run * time (defaults to the Ona agent), preserving behavior for workflows * created before agent selection existed. * * @generated from field: string agent_id = 8; */ agentId: string; /** * Codex app agent settings (model, reasoning effort, service tier). Only * meaningful when agent_id refers to the Codex app agent. * * @generated from field: gitpod.v1.CodexSettings codex_settings = 9; */ codexSettings?: CodexSettings; }; /** * Describes the message gitpod.v1.Workflow.Spec. * Use `create(Workflow_SpecSchema)` to create a new message. */ export declare const Workflow_SpecSchema: GenMessage<Workflow_Spec>; /** * WorkflowTrigger defines when a workflow should be executed. * * Each trigger type defines a specific condition that will cause the workflow to execute: * - Manual: Triggered explicitly by user action via StartWorkflow RPC * - Time: Triggered automatically based on cron schedule * - PullRequest: Triggered automatically when specified PR events occur * * Trigger Semantics: * - Each trigger instance can create multiple workflow executions * - Multiple triggers of the same workflow can fire simultaneously * - Each trigger execution is independent and tracked separately * - Triggers are evaluated in the context specified by WorkflowTriggerContext * * @generated from message gitpod.v1.WorkflowTrigger */ export type WorkflowTrigger = Message<"gitpod.v1.WorkflowTrigger"> & { /** * @generated from oneof gitpod.v1.WorkflowTrigger.trigger */ trigger: { /** * @generated from field: gitpod.v1.WorkflowTrigger.Manual manual = 1; */ value: WorkflowTrigger_Manual; case: "manual"; } | { /** * @generated from field: gitpod.v1.WorkflowTrigger.Time time = 2; */ value: WorkflowTrigger_Time; case: "time"; } | { /** * @generated from field: gitpod.v1.WorkflowTrigger.PullRequest pull_request = 3; */ value: WorkflowTrigger_PullRequest; case: "pullRequest"; } | { case: undefined; value?: undefined; }; /** * @generated from field: gitpod.v1.WorkflowTriggerContext context = 4; */ context?: WorkflowTriggerContext; }; /** * Describes the message gitpod.v1.WorkflowTrigger. * Use `create(WorkflowTriggerSchema)` to create a new message. */ export declare const WorkflowTriggerSchema: GenMessage<WorkflowTrigger>; /** * Manual trigger - executed when StartWorkflow RPC is called. * No additional configuration needed. * * @generated from message gitpod.v1.WorkflowTrigger.Manual */ export type WorkflowTrigger_Manual = Message<"gitpod.v1.WorkflowTrigger.Manual"> & {}; /** * Describes the message gitpod.v1.WorkflowTrigger.Manual. * Use `create(WorkflowTrigger_ManualSchema)` to create a new message. */ export declare const WorkflowTrigger_ManualSchema: GenMessage<WorkflowTrigger_Manual>; /** * Time-based trigger - executed automatically based on cron schedule. * Uses standard cron expression format (minute hour day month weekday). * * @generated from message gitpod.v1.WorkflowTrigger.Time */ export type WorkflowTrigger_Time = Message<"gitpod.v1.WorkflowTrigger.Time"> & { /** * @generated from field: string cron_expression = 1; */ cronExpression: string; }; /** * Describes the message gitpod.v1.WorkflowTrigger.Time. * Use `create(WorkflowTrigger_TimeSchema)` to create a new message. */ export declare const WorkflowTrigger_TimeSchema: GenMessage<WorkflowTrigger_Time>; /** * Pull request trigger - executed when specified PR events occur. * Only triggers for PRs in repositories matching the trigger context. * * @generated from message gitpod.v1.WorkflowTrigger.PullRequest */ export type WorkflowTrigger_PullRequest = Message<"gitpod.v1.WorkflowTrigger.PullRequest"> & { /** * @generated from field: repeated gitpod.v1.WorkflowTrigger.PullRequestEvent events = 1; */ events: WorkflowTrigger_PullRequestEvent[]; /** * webhook_id is the optional ID of a webhook that this trigger is bound to. * When set, the trigger will be activated when the webhook receives events. * This allows multiple workflows to share a single webhook endpoint. * * @generated from field: optional string webhook_id = 2; */ webhookId?: string; /** * integration_id is the optional ID of an integration that acts as the source of webhook events. * When set, the trigger will be activated when the webhook receives events. * * @generated from field: optional string integration_id = 3; */ integrationId?: string; }; /** * Describes the message gitpod.v1.WorkflowTrigger.PullRequest. * Use `create(WorkflowTrigger_PullRequestSchema)` to create a new message. */ export declare const WorkflowTrigger_PullRequestSchema: GenMessage<WorkflowTrigger_PullRequest>; /** * WorkflowPREvent defines pull request events that can trigger workflows. * * @generated from enum gitpod.v1.WorkflowTrigger.PullRequestEvent */ export declare enum WorkflowTrigger_PullRequestEvent { /** * @generated from enum value: PULL_REQUEST_EVENT_UNSPECIFIED = 0; */ UNSPECIFIED = 0, /** * @generated from enum value: PULL_REQUEST_EVENT_OPENED = 1; */ OPENED = 1, /** * @generated from enum value: PULL_REQUEST_EVENT_UPDATED = 2; */ UPDATED = 2, /** * @generated from enum value: PULL_REQUEST_EVENT_APPROVED = 3; */ APPROVED = 3, /** * @generated from enum value: PULL_REQUEST_EVENT_MERGED = 4; */ MERGED = 4, /** * @generated from enum value: PULL_REQUEST_EVENT_CLOSED = 5; */ CLOSED = 5, /** * @generated from enum value: PULL_REQUEST_EVENT_READY_FOR_REVIEW = 6; */ READY_FOR_REVIEW = 6, /** * @generated from enum value: PULL_REQUEST_EVENT_REVIEW_REQUESTED = 7; */ REVIEW_REQUESTED = 7 } /** * Describes the enum gitpod.v1.WorkflowTrigger.PullRequestEvent. */ export declare const WorkflowTrigger_PullRequestEventSchema: GenEnum<WorkflowTrigger_PullRequestEvent>; /** * WorkflowTriggerContext defines the context in which a workflow should run. * * Context determines where and how the workflow executes: * - Projects: Execute in specific project environments * - Repositories: Execute in environments created from repository URLs * - Agent: Execute in agent-managed environments with custom prompts * - FromTrigger: Use context derived from the trigger event (PR-specific) * * Context Usage by Trigger Type: * - Manual: Can use any context type * - Time: Typically uses Projects or Repositories context * - PullRequest: Can use any context, FromTrigger uses PR repository context * - Incident: Typically uses Projects or Repositories context (no inherent repo context) * * @generated from message gitpod.v1.WorkflowTriggerContext */ export type WorkflowTriggerContext = Message<"gitpod.v1.WorkflowTriggerContext"> & { /** * @generated from oneof gitpod.v1.WorkflowTriggerContext.context */ context: { /** * @generated from field: gitpod.v1.WorkflowTriggerContext.Projects projects = 1; */ value: WorkflowTriggerContext_Projects; case: "projects"; } | { /** * @generated from field: gitpod.v1.WorkflowTriggerContext.Repositories repositories = 2; */ value: WorkflowTriggerContext_Repositories; case: "repositories"; } | { /** * @generated from field: gitpod.v1.WorkflowTriggerContext.Agent agent = 3; */ value: WorkflowTriggerContext_Agent; case: "agent"; } | { /** * @generated from field: gitpod.v1.WorkflowTriggerContext.FromTrigger from_trigger = 4; */ value: WorkflowTriggerContext_FromTrigger; case: "fromTrigger"; } | { case: undefined; value?: undefined; }; }; /** * Describes the message gitpod.v1.WorkflowTriggerContext. * Use `create(WorkflowTriggerContextSchema)` to create a new message. */ export declare const WorkflowTriggerContextSchema: GenMessage<WorkflowTriggerContext>; /** * Execute workflow in specific project environments. * Creates environments for each specified project. * * @generated from message gitpod.v1.WorkflowTriggerContext.Projects */ export type WorkflowTriggerContext_Projects = Message<"gitpod.v1.WorkflowTriggerContext.Projects"> & { /** * @generated from field: repeated string project_ids = 1; */ projectIds: string[]; }; /** * Describes the message gitpod.v1.WorkflowTriggerContext.Projects. * Use `create(WorkflowTriggerContext_ProjectsSchema)` to create a new message. */ export declare const WorkflowTriggerContext_ProjectsSchema: GenMessage<WorkflowTriggerContext_Projects>; /** * Execute workflow in environments created from repository URLs. * Supports both explicit repository URLs and search patterns. * * @generated from message gitpod.v1.WorkflowTriggerContext.Repositories */ export type WorkflowTriggerContext_Repositories = Message<"gitpod.v1.WorkflowTriggerContext.Repositories"> & { /** * @generated from oneof gitpod.v1.WorkflowTriggerContext.Repositories.repository_selector */ repositorySelector: { /** * @generated from field: gitpod.v1.WorkflowTriggerContext.Repositories.RepositoryURLs repository_urls = 1; */ value: WorkflowTriggerContext_Repositories_RepositoryURLs; case: "repositoryUrls"; } | { /** * @generated from field: gitpod.v1.WorkflowTriggerContext.Repositories.RepositorySelector repo_selector = 2; */ value: WorkflowTriggerContext_Repositories_RepositorySelector; case: "repoSelector"; } | { case: undefined; value?: undefined; }; /** * @generated from field: string environment_class_id = 3; */ environmentClassId: string; }; /** * Describes the message gitpod.v1.WorkflowTriggerContext.Repositories. * Use `create(WorkflowTriggerContext_RepositoriesSchema)` to create a new message. */ export declare const WorkflowTriggerContext_RepositoriesSchema: GenMessage<WorkflowTriggerContext_Repositories>; /** * RepositoryURLs contains a list of explicit repository URLs. * Creates one action per repository URL. * * @generated from message gitpod.v1.WorkflowTriggerContext.Repositories.RepositoryURLs */ export type WorkflowTriggerContext_Repositories_RepositoryURLs = Message<"gitpod.v1.WorkflowTriggerContext.Repositories.RepositoryURLs"> & { /** * @generated from field: repeated string repo_urls = 1; */ repoUrls: string[]; }; /** * Describes the message gitpod.v1.WorkflowTriggerContext.Repositories.RepositoryURLs. * Use `create(WorkflowTriggerContext_Repositories_RepositoryURLsSchema)` to create a new message. */ export declare const WorkflowTriggerContext_Repositories_RepositoryURLsSchema: GenMessage<WorkflowTriggerContext_Repositories_RepositoryURLs>; /** * RepositorySelector defines how to select repositories for workflow execution. * Combines a search string with an SCM host to identify repositories. * * @generated from message gitpod.v1.WorkflowTriggerContext.Repositories.RepositorySelector */ export type WorkflowTriggerContext_Repositories_RepositorySelector = Message<"gitpod.v1.WorkflowTriggerContext.Repositories.RepositorySelector"> & { /** * Search string to match repositories using SCM-specific search patterns. * For GitHub: supports GitHub search syntax (e.g., "org:gitpod-io language:go", "user:octocat stars:>100") * For GitLab: supports GitLab search syntax * See SCM provider documentation for supported search patterns. * * @generated from field: string repo_search_string = 1; */ repoSearchString: string; /** * SCM host where the search should be performed (e.g., "github.com", "gitlab.com") * * @generated from field: string scm_host = 2; */ scmHost: string; }; /** * Describes the message gitpod.v1.WorkflowTriggerContext.Repositories.RepositorySelector. * Use `create(WorkflowTriggerContext_Repositories_RepositorySelectorSchema)` to create a new message. */ export declare const WorkflowTriggerContext_Repositories_RepositorySelectorSchema: GenMessage<WorkflowTriggerContext_Repositories_RepositorySelector>; /** * Execute workflow in agent-managed environments. * Agent receives the specified prompt and manages execution context. * * @generated from message gitpod.v1.WorkflowTriggerContext.Agent */ export type WorkflowTriggerContext_Agent = Message<"gitpod.v1.WorkflowTriggerContext.Agent"> & { /** * @generated from field: string prompt = 1; */ prompt: string; }; /** * Describes the message gitpod.v1.WorkflowTriggerContext.Agent. * Use `create(WorkflowTriggerContext_AgentSchema)` to create a new message. */ export declare const WorkflowTriggerContext_AgentSchema: GenMessage<WorkflowTriggerContext_Agent>; /** * Use context derived from the trigger event. * Currently only supported for PullRequest triggers - uses PR repository context. * * @generated from message gitpod.v1.WorkflowTriggerContext.FromTrigger */ export type WorkflowTriggerContext_FromTrigger = Message<"gitpod.v1.WorkflowTriggerContext.FromTrigger"> & {}; /** * Describes the message gitpod.v1.WorkflowTriggerContext.FromTrigger. * Use `create(WorkflowTriggerContext_FromTriggerSchema)` to create a new message. */ export declare const WorkflowTriggerContext_FromTriggerSchema: GenMessage<WorkflowTriggerContext_FromTrigger>; /** * WorkflowAction defines the actions to be executed in a workflow. * * @generated from message gitpod.v1.WorkflowAction */ export type WorkflowAction = Message<"gitpod.v1.WorkflowAction"> & { /** * @generated from field: gitpod.v1.WorkflowAction.Limits limits = 1; */ limits?: WorkflowAction_Limits; /** * @generated from field: repeated gitpod.v1.WorkflowStep steps = 2; */ steps: WorkflowStep[]; }; /** * Describes the message gitpod.v1.WorkflowAction. * Use `create(WorkflowActionSchema)` to create a new message. */ export declare const WorkflowActionSchema: GenMessage<WorkflowAction>; /** * Limits defines execution limits for workflow actions. * * @generated from message gitpod.v1.WorkflowAction.Limits */ export type WorkflowAction_Limits = Message<"gitpod.v1.WorkflowAction.Limits"> & { /** * @generated from field: int32 max_parallel = 1; */ maxParallel: number; /** * @generated from field: int32 max_total = 2; */ maxTotal: number; /** * @generated from field: gitpod.v1.WorkflowAction.Limits.PerExecution per_execution = 3; */ perExecution?: WorkflowAction_Limits_PerExecution; }; /** * Describes the message gitpod.v1.WorkflowAction.Limits. * Use `create(WorkflowAction_LimitsSchema)` to create a new message. */ export declare const WorkflowAction_LimitsSchema: GenMessage<WorkflowAction_Limits>; /** * PerExecution defines limits per execution action. * * @generated from message gitpod.v1.WorkflowAction.Limits.PerExecution */ export type WorkflowAction_Limits_PerExecution = Message<"gitpod.v1.WorkflowAction.Limits.PerExecution"> & { /** * Maximum time allowed for a single execution action. * Use standard duration format (e.g., "30m" for 30 minutes, "2h" for 2 hours). * * @generated from field: google.protobuf.Duration max_time = 1; */ maxTime?: Duration; }; /** * Describes the message gitpod.v1.WorkflowAction.Limits.PerExecution. * Use `create(WorkflowAction_Limits_PerExecutionSchema)` to create a new message. */ export declare const WorkflowAction_Limits_PerExecutionSchema: GenMessage<WorkflowAction_Limits_PerExecution>; /** * WorkflowStep defines a single step in a workflow action. * * @generated from message gitpod.v1.WorkflowStep */ export type WorkflowStep = Message<"gitpod.v1.WorkflowStep"> & { /** * @generated from oneof gitpod.v1.WorkflowStep.step */ step: { /** * @generated from field: gitpod.v1.WorkflowStep.Task task = 1; */ value: WorkflowStep_Task; case: "task"; } | { /** * @generated from field: gitpod.v1.WorkflowStep.Agent agent = 2; */ value: WorkflowStep_Agent; case: "agent"; } | { /** * @generated from field: gitpod.v1.WorkflowStep.PullRequest pull_request = 3; */ value: WorkflowStep_PullRequest; case: "pullRequest"; } | { /** * @generated from field: gitpod.v1.WorkflowStep.Report report = 4; */ value: WorkflowStep_Report; case: "report"; } | { case: undefined; value?: undefined; }; }; /** * Describes the message gitpod.v1.WorkflowStep. * Use `create(WorkflowStepSchema)` to create a new message. */ export declare const WorkflowStepSchema: GenMessage<WorkflowStep>; /** * WorkflowTaskStep represents a task step that executes a command. * * @generated from message gitpod.v1.WorkflowStep.Task */ export type WorkflowStep_Task = Message<"gitpod.v1.WorkflowStep.Task"> & { /** * @generated from field: string command = 1; */ command: string; }; /** * Describes the message gitpod.v1.WorkflowStep.Task. * Use `create(WorkflowStep_TaskSchema)` to create a new message. */ export declare const WorkflowStep_TaskSchema: GenMessage<WorkflowStep_Task>; /** * WorkflowAgentStep represents an agent step that executes with a prompt. * * @generated from message gitpod.v1.WorkflowStep.Agent */ export type WorkflowStep_Agent = Message<"gitpod.v1.WorkflowStep.Agent"> & { /** * @generated from field: string prompt = 1; */ prompt: string; }; /** * Describes the message gitpod.v1.WorkflowStep.Agent. * Use `create(WorkflowStep_AgentSchema)` to create a new message. */ export declare const WorkflowStep_AgentSchema: GenMessage<WorkflowStep_Agent>; /** * WorkflowPullRequestStep represents a pull request creation step. * * @generated from message gitpod.v1.WorkflowStep.PullRequest */ export type WorkflowStep_PullRequest = Message<"gitpod.v1.WorkflowStep.PullRequest"> & { /** * @generated from field: string title = 1; */ title: string; /** * @generated from field: string description = 2; */ description: string; /** * @generated from field: string branch = 3; */ branch: string; /** * @generated from field: bool draft = 4; */ draft: boolean; }; /** * Describes the message gitpod.v1.WorkflowStep.PullRequest. * Use `create(WorkflowStep_PullRequestSchema)` to create a new message. */ export declare const WorkflowStep_PullRequestSchema: GenMessage<WorkflowStep_PullRequest>; /** * @generated