scpluginv1

package
v0.0.0-...-6f76ffe Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 16, 2026 License: MIT Imports: 9 Imported by: 0

Documentation

Index

Constants

View Source
const (
	SCCloudPlugin_Schema_FullMethodName                     = "/sc.plugin.v1.SCCloudPlugin/Schema"
	SCCloudPlugin_InitStateStore_FullMethodName             = "/sc.plugin.v1.SCCloudPlugin/InitStateStore"
	SCCloudPlugin_InitSecretsProvider_FullMethodName        = "/sc.plugin.v1.SCCloudPlugin/InitSecretsProvider"
	SCCloudPlugin_Provider_FullMethodName                   = "/sc.plugin.v1.SCCloudPlugin/Provider"
	SCCloudPlugin_Provision_FullMethodName                  = "/sc.plugin.v1.SCCloudPlugin/Provision"
	SCCloudPlugin_ComputeProcess_FullMethodName             = "/sc.plugin.v1.SCCloudPlugin/ComputeProcess"
	SCCloudPlugin_PreProvision_FullMethodName               = "/sc.plugin.v1.SCCloudPlugin/PreProvision"
	SCCloudPlugin_ConvertStackConfig_FullMethodName         = "/sc.plugin.v1.SCCloudPlugin/ConvertStackConfig"
	SCCloudPlugin_ProvisionRegistrar_FullMethodName         = "/sc.plugin.v1.SCCloudPlugin/ProvisionRegistrar"
	SCCloudPlugin_NewDnsRecord_FullMethodName               = "/sc.plugin.v1.SCCloudPlugin/NewDnsRecord"
	SCCloudPlugin_NewOverrideHeaderRule_FullMethodName      = "/sc.plugin.v1.SCCloudPlugin/NewOverrideHeaderRule"
	SCCloudPlugin_ProvisionDomainForEndpoint_FullMethodName = "/sc.plugin.v1.SCCloudPlugin/ProvisionDomainForEndpoint"
	SCCloudPlugin_PreDestroy_FullMethodName                 = "/sc.plugin.v1.SCCloudPlugin/PreDestroy"
	SCCloudPlugin_VmHosts_FullMethodName                    = "/sc.plugin.v1.SCCloudPlugin/VmHosts"
	SCCloudPlugin_LogStream_FullMethodName                  = "/sc.plugin.v1.SCCloudPlugin/LogStream"
	SCCloudPlugin_PluginInvoke_FullMethodName               = "/sc.plugin.v1.SCCloudPlugin/PluginInvoke"
)
View Source
const (
	SCCore_ResolveSecret_FullMethodName     = "/sc.plugin.v1.SCCore/ResolveSecret"
	SCCore_ResolveCredential_FullMethodName = "/sc.plugin.v1.SCCore/ResolveCredential"
	SCCore_PeerInvoke_FullMethodName        = "/sc.plugin.v1.SCCore/PeerInvoke"
)

Variables

View Source
var (
	TemplateExtensionKind_name = map[int32]string{
		0: "TEMPLATE_EXTENSION_KIND_UNSPECIFIED",
		1: "TEMPLATE_EXTENSION_KIND_RESOURCE",
		2: "TEMPLATE_EXTENSION_KIND_DEPENDENCY",
	}
	TemplateExtensionKind_value = map[string]int32{
		"TEMPLATE_EXTENSION_KIND_UNSPECIFIED": 0,
		"TEMPLATE_EXTENSION_KIND_RESOURCE":    1,
		"TEMPLATE_EXTENSION_KIND_DEPENDENCY":  2,
	}
)

Enum value maps for TemplateExtensionKind.

View Source
var (
	LogSeverity_name = map[int32]string{
		0: "LOG_SEVERITY_UNSPECIFIED",
		1: "LOG_SEVERITY_DEBUG",
		2: "LOG_SEVERITY_INFO",
		3: "LOG_SEVERITY_WARN",
		4: "LOG_SEVERITY_ERROR",
	}
	LogSeverity_value = map[string]int32{
		"LOG_SEVERITY_UNSPECIFIED": 0,
		"LOG_SEVERITY_DEBUG":       1,
		"LOG_SEVERITY_INFO":        2,
		"LOG_SEVERITY_WARN":        3,
		"LOG_SEVERITY_ERROR":       4,
	}
)

Enum value maps for LogSeverity.

View Source
var File_v1_plugin_proto protoreflect.FileDescriptor
View Source
var SCCloudPlugin_ServiceDesc = grpc.ServiceDesc{
	ServiceName: "sc.plugin.v1.SCCloudPlugin",
	HandlerType: (*SCCloudPluginServer)(nil),
	Methods: []grpc.MethodDesc{
		{
			MethodName: "Schema",
			Handler:    _SCCloudPlugin_Schema_Handler,
		},
		{
			MethodName: "InitStateStore",
			Handler:    _SCCloudPlugin_InitStateStore_Handler,
		},
		{
			MethodName: "InitSecretsProvider",
			Handler:    _SCCloudPlugin_InitSecretsProvider_Handler,
		},
		{
			MethodName: "Provider",
			Handler:    _SCCloudPlugin_Provider_Handler,
		},
		{
			MethodName: "Provision",
			Handler:    _SCCloudPlugin_Provision_Handler,
		},
		{
			MethodName: "ComputeProcess",
			Handler:    _SCCloudPlugin_ComputeProcess_Handler,
		},
		{
			MethodName: "PreProvision",
			Handler:    _SCCloudPlugin_PreProvision_Handler,
		},
		{
			MethodName: "ConvertStackConfig",
			Handler:    _SCCloudPlugin_ConvertStackConfig_Handler,
		},
		{
			MethodName: "ProvisionRegistrar",
			Handler:    _SCCloudPlugin_ProvisionRegistrar_Handler,
		},
		{
			MethodName: "NewDnsRecord",
			Handler:    _SCCloudPlugin_NewDnsRecord_Handler,
		},
		{
			MethodName: "NewOverrideHeaderRule",
			Handler:    _SCCloudPlugin_NewOverrideHeaderRule_Handler,
		},
		{
			MethodName: "ProvisionDomainForEndpoint",
			Handler:    _SCCloudPlugin_ProvisionDomainForEndpoint_Handler,
		},
		{
			MethodName: "PreDestroy",
			Handler:    _SCCloudPlugin_PreDestroy_Handler,
		},
		{
			MethodName: "VmHosts",
			Handler:    _SCCloudPlugin_VmHosts_Handler,
		},
		{
			MethodName: "PluginInvoke",
			Handler:    _SCCloudPlugin_PluginInvoke_Handler,
		},
	},
	Streams: []grpc.StreamDesc{
		{
			StreamName:    "LogStream",
			Handler:       _SCCloudPlugin_LogStream_Handler,
			ServerStreams: true,
		},
	},
	Metadata: "v1/plugin.proto",
}

SCCloudPlugin_ServiceDesc is the grpc.ServiceDesc for SCCloudPlugin service. It's only intended for direct use with grpc.RegisterService, and not to be introspected or modified (even as a copy)

View Source
var SCCore_ServiceDesc = grpc.ServiceDesc{
	ServiceName: "sc.plugin.v1.SCCore",
	HandlerType: (*SCCoreServer)(nil),
	Methods: []grpc.MethodDesc{
		{
			MethodName: "ResolveSecret",
			Handler:    _SCCore_ResolveSecret_Handler,
		},
		{
			MethodName: "ResolveCredential",
			Handler:    _SCCore_ResolveCredential_Handler,
		},
		{
			MethodName: "PeerInvoke",
			Handler:    _SCCore_PeerInvoke_Handler,
		},
	},
	Streams:  []grpc.StreamDesc{},
	Metadata: "v1/plugin.proto",
}

SCCore_ServiceDesc is the grpc.ServiceDesc for SCCore service. It's only intended for direct use with grpc.RegisterService, and not to be introspected or modified (even as a copy)

Functions

func RegisterSCCloudPluginServer

func RegisterSCCloudPluginServer(s grpc.ServiceRegistrar, srv SCCloudPluginServer)

func RegisterSCCoreServer

func RegisterSCCoreServer(s grpc.ServiceRegistrar, srv SCCoreServer)

Types

type BasicAuthMsg

type BasicAuthMsg struct {
	Username string `protobuf:"bytes,1,opt,name=username,proto3" json:"username,omitempty"`
	Password string `protobuf:"bytes,2,opt,name=password,proto3" json:"password,omitempty"`
	Realm    string `protobuf:"bytes,3,opt,name=realm,proto3" json:"realm,omitempty"`
	// contains filtered or unexported fields
}

func (*BasicAuthMsg) Descriptor deprecated

func (*BasicAuthMsg) Descriptor() ([]byte, []int)

Deprecated: Use BasicAuthMsg.ProtoReflect.Descriptor instead.

func (*BasicAuthMsg) GetPassword

func (x *BasicAuthMsg) GetPassword() string

func (*BasicAuthMsg) GetRealm

func (x *BasicAuthMsg) GetRealm() string

func (*BasicAuthMsg) GetUsername

func (x *BasicAuthMsg) GetUsername() string

func (*BasicAuthMsg) ProtoMessage

func (*BasicAuthMsg) ProtoMessage()

func (*BasicAuthMsg) ProtoReflect

func (x *BasicAuthMsg) ProtoReflect() protoreflect.Message

func (*BasicAuthMsg) Reset

func (x *BasicAuthMsg) Reset()

func (*BasicAuthMsg) String

func (x *BasicAuthMsg) String() string

type ComputeEnvVariable

type ComputeEnvVariable struct {
	Name         string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	Value        string `protobuf:"bytes,2,opt,name=value,proto3" json:"value,omitempty"`
	Secret       bool   `protobuf:"varint,3,opt,name=secret,proto3" json:"secret,omitempty"`
	ResourceName string `protobuf:"bytes,4,opt,name=resource_name,json=resourceName,proto3" json:"resource_name,omitempty"`
	ResourceType string `protobuf:"bytes,5,opt,name=resource_type,json=resourceType,proto3" json:"resource_type,omitempty"`
	StackName    string `protobuf:"bytes,6,opt,name=stack_name,json=stackName,proto3" json:"stack_name,omitempty"`
	// contains filtered or unexported fields
}

ComputeEnvVariable mirrors pApi.ComputeEnvVariable (pkg/clouds/pulumi/api/cloud_provider.go). secret=true selects collector.AddSecretEnvVariableIfNotExist; false selects the plain one.

func (*ComputeEnvVariable) Descriptor deprecated

func (*ComputeEnvVariable) Descriptor() ([]byte, []int)

Deprecated: Use ComputeEnvVariable.ProtoReflect.Descriptor instead.

func (*ComputeEnvVariable) GetName

func (x *ComputeEnvVariable) GetName() string

func (*ComputeEnvVariable) GetResourceName

func (x *ComputeEnvVariable) GetResourceName() string

func (*ComputeEnvVariable) GetResourceType

func (x *ComputeEnvVariable) GetResourceType() string

func (*ComputeEnvVariable) GetSecret

func (x *ComputeEnvVariable) GetSecret() bool

func (*ComputeEnvVariable) GetStackName

func (x *ComputeEnvVariable) GetStackName() string

func (*ComputeEnvVariable) GetValue

func (x *ComputeEnvVariable) GetValue() string

func (*ComputeEnvVariable) ProtoMessage

func (*ComputeEnvVariable) ProtoMessage()

func (*ComputeEnvVariable) ProtoReflect

func (x *ComputeEnvVariable) ProtoReflect() protoreflect.Message

func (*ComputeEnvVariable) Reset

func (x *ComputeEnvVariable) Reset()

func (*ComputeEnvVariable) String

func (x *ComputeEnvVariable) String() string

type ComputeProcessRequest

type ComputeProcessRequest struct {
	Header       *RequestHeader         `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	ResourceType string                 `protobuf:"bytes,2,opt,name=resource_type,json=resourceType,proto3" json:"resource_type,omitempty"` // from SchemaResponse.compute_processor_types
	ResourceName string                 `protobuf:"bytes,3,opt,name=resource_name,json=resourceName,proto3" json:"resource_name,omitempty"`
	Inputs       map[string]*InputValue `` /* 139-byte string literal not displayed */
	// Previously-registered dependency outputs this resource may need.
	DependencyOutputs map[string]string `` /* 186-byte string literal not displayed */
	ParentUrn         string            `protobuf:"bytes,6,opt,name=parent_urn,json=parentUrn,proto3" json:"parent_urn,omitempty"`
	// Parent-stack facts the handler needs to open a sdk.NewStackReference
	// and to resolve env vars against the deploying stack. Carried as JSON
	// of pkg/clouds/pulumi/api.ParentInfo rather than individual proto
	// fields: ParentInfo evolves alongside the Go struct (StackConfigDependencyResource
	// nested within), and a JSON blob keeps the proto stable through those
	// changes. Empty when the resource has no parent stack. Added in Phase
	// 1e (ComputeProcess v2) for mongodb and the remaining extractions —
	// older plugins ignore the field and get the same v1 behaviour.
	ParentInfoJson []byte `protobuf:"bytes,7,opt,name=parent_info_json,json=parentInfoJson,proto3" json:"parent_info_json,omitempty"`
	// Dependency-outputs JSON — same shape as ProvisionRequest.dependency_outputs_json
	// (:823): a `map[string]*api.PluginResourceOutput` keyed by the sibling
	// resource's SC-level Name. SC core packs this from `params.ResourceOutputs`
	// the same way it packs the Provision side, so a `ComputeProcessor` on a
	// `uses: [sibling]` can read the sibling's plugin-owned outputs via
	// `runtime.DependencyOutputsFromComputeProcessRequest`.
	//
	// Mirrors the Provision-side JSON blob for symmetry. The flat
	// `dependency_outputs = 5` field is left in place for wire-compat but is
	// not populated by any current sidecar (same shape gap documented on the
	// Provision field).
	//
	// Lights up sc-component-backup's slice 1d scoped-user plumbing
	// (sc-component-backup commit 06721b1, design doc §5.2) end-to-end:
	// `MatchConsumerToDatabase` reads this JSON to find the consumer's
	// sibling-DB resource name + its target database, then the plugin's
	// ComputeProcess mints a scoped Atlas user and embeds its creds in
	// the push-registered tenant record.
	//
	// Older plugins ignore the field: the fallback is nil, which is the same
	// silent-drop shape the Provision side was before #571. Backwards-compat
	// additive.
	DependencyOutputsJson []byte `` /* 126-byte string literal not displayed */
	// JSON of the component's `.Raw` map when the ComputeProcess call fires
	// on an SC Component resource (`type: sc-<name>` whose plugin advertises
	// `SchemaResponse.supports_component`). Mirrors
	// `ProvisionRequest.component_raw = 13`: SC core packs
	// `cfg.RawCopy()` the same way on both sides so a component plugin's
	// compute path can read its own operator-declared `databases:` +
	// `atlasAdmin:` + ... config — the same data the Provision side already
	// sees — without a second config carrier.
	//
	// Live-caught 2026-11-13 on sc-component-backup's slice 1d live-smoke
	// prep: the compute path's `maybeProvisionScopedUser` reads config via
	// `extractConfigRaw(input.Descriptor)`, but the ComputeProcess RPC
	// handler fed `input.Descriptor.Config` with `map[string]any{}` because
	// no proto carrier existed yet. Without this field,
	// `maybeProvisionScopedUser` has always been a no-op in production —
	// only reachable through the plugin's unit-test fixtures.
	//
	// Older plugin binaries that pre-date this field see no change: the
	// field is unset, decoders skip it, and ComputeProcess behaves as it
	// did before. Additive by construction; opt-in is the same
	// `SchemaResponse.supports_component` advertise as on the Provision
	// side. Decoded plugin-side with
	// `runtime.ComponentRawFromComputeProcessRequest`.
	ComponentRaw []byte `protobuf:"bytes,9,opt,name=component_raw,json=componentRaw,proto3" json:"component_raw,omitempty"`
	// Accumulated env vars from PRIOR sibling compute processors in the
	// same consumer deploy's `uses:` iteration. Same shape and semantics
	// as `ProvisionRequest.compute_env_vars = 7`, but populated on the
	// ComputeProcess side so a Component plugin can auto-discover what
	// sibling databases / buckets / brokers the consumer is wiring up
	// without the operator duplicating that list in config.
	//
	// Populated by SC core's `makeComputeProcessorSidecar` from the
	// shared `pApi.ComputeContextCollector` built in `deploy.go:218`
	// before the plugin's ComputeProcess RPC fires. Empty on the first
	// sibling's compute (nothing emitted yet); accumulates as subsequent
	// sibling processors add entries via `AddEnvVariableIfNotExist` /
	// `AddSecretEnvVariableIfNotExist`. Declaration order in the
	// consumer's `uses:` list determines what a given ComputeProcess
	// sees — a plugin that reads this field must be listed AFTER the
	// siblings it depends on.
	//
	// Lights up sc-component-backup's slice 1d.7 auto-discover path
	// (roadmap items/sc-components-backup-auto-discover-databases.md):
	// the mongodb plugin emits `MONGO_URI`/`MONGO_DATABASE` into the
	// shared collector; the backup plugin's ComputeProcess reads them
	// from this field to mint a scoped Atlas user — no `databases:`
	// config on the backup component.
	//
	// Live-caught 2026-11-14 on backup-smoke-1d: the design shipped
	// without this field assumed the shared collector crossed the
	// plugin bus (it doesn't — each plugin's ComputeProcess RPC gets
	// a FRESH, empty `runtime.Collector` per
	// api/pkg/plugin/runtime/collector.go:72-74). Deploy went green,
	// tenant push-registered, but the Atlas scoped user was never
	// minted because `collector.EnvVariables()` returned empty. See
	// `plugin_bus_compute_process_collector_is_per_rpc_not_shared`
	// in agent memory.
	//
	// Older plugin binaries that pre-date this field see no change:
	// the field is unset; `runtime.RunComputeProcess` seeds an empty
	// incoming pool as it always has. Opt-in plugin-side by passing
	// `runtime.WithIncomingEnvVars(req)` to `RunComputeProcess`.
	ComputeEnvVars []*ComputeEnvVariable `protobuf:"bytes,10,rep,name=compute_env_vars,json=computeEnvVars,proto3" json:"compute_env_vars,omitempty"`
	// contains filtered or unexported fields
}

func (*ComputeProcessRequest) Descriptor deprecated

func (*ComputeProcessRequest) Descriptor() ([]byte, []int)

Deprecated: Use ComputeProcessRequest.ProtoReflect.Descriptor instead.

func (*ComputeProcessRequest) GetComponentRaw

func (x *ComputeProcessRequest) GetComponentRaw() []byte

func (*ComputeProcessRequest) GetComputeEnvVars

func (x *ComputeProcessRequest) GetComputeEnvVars() []*ComputeEnvVariable

func (*ComputeProcessRequest) GetDependencyOutputs

func (x *ComputeProcessRequest) GetDependencyOutputs() map[string]string

func (*ComputeProcessRequest) GetDependencyOutputsJson

func (x *ComputeProcessRequest) GetDependencyOutputsJson() []byte

func (*ComputeProcessRequest) GetHeader

func (x *ComputeProcessRequest) GetHeader() *RequestHeader

func (*ComputeProcessRequest) GetInputs

func (x *ComputeProcessRequest) GetInputs() map[string]*InputValue

func (*ComputeProcessRequest) GetParentInfoJson

func (x *ComputeProcessRequest) GetParentInfoJson() []byte

func (*ComputeProcessRequest) GetParentUrn

func (x *ComputeProcessRequest) GetParentUrn() string

func (*ComputeProcessRequest) GetResourceName

func (x *ComputeProcessRequest) GetResourceName() string

func (*ComputeProcessRequest) GetResourceType

func (x *ComputeProcessRequest) GetResourceType() string

func (*ComputeProcessRequest) ProtoMessage

func (*ComputeProcessRequest) ProtoMessage()

func (*ComputeProcessRequest) ProtoReflect

func (x *ComputeProcessRequest) ProtoReflect() protoreflect.Message

func (*ComputeProcessRequest) Reset

func (x *ComputeProcessRequest) Reset()

func (*ComputeProcessRequest) String

func (x *ComputeProcessRequest) String() string

type ComputeProcessResponse

type ComputeProcessResponse struct {

	// Env variables to inject into downstream compute (map form). Secret-flagged
	// are propagated as Pulumi secrets. DEPRECATED in favour of env_vars below:
	// this map form cannot carry the ResourceName / ResourceType / StackName
	// metadata that pApi.ComputeEnvVariable records, which the sidecar needs
	// to key the env var against the right stack. Older plugins still populate
	// this; the sidecar merges both. New plugins SHOULD populate env_vars.
	//
	// Deprecated: Marked as deprecated in v1/plugin.proto.
	Env map[string]*InputValue `` /* 133-byte string literal not displayed */
	// Output placeholders — references by the dependency resource's URN that
	// downstream compute can resolve at deploy time (SC's compute processor
	// vocabulary; see pkg/clouds/pulumi/api/compute_context.go).
	Placeholders map[string]string `` /* 151-byte string literal not displayed */
	// The URN the compute processor registered (if any). Optional.
	Urn string `protobuf:"bytes,3,opt,name=urn,proto3" json:"urn,omitempty"`
	// Env variables the plugin wants injected. Added in Phase 1e. Mirrors
	// pApi.ComputeEnvVariable exactly so the sidecar can call
	// collector.AddEnvVariableIfNotExist / AddSecretEnvVariableIfNotExist
	// round-trip, with the per-env metadata (resource_name/type/stack_name)
	// preserved so downstream config interpolation picks the right scope.
	EnvVars []*ComputeEnvVariable `protobuf:"bytes,4,rep,name=env_vars,json=envVars,proto3" json:"env_vars,omitempty"`
	// Template extensions — the pApi.ComputeContextCollector surface for
	// AddResourceTplExtension / AddDependencyTplExtension. kind selects
	// which, and dep_name is only populated for the dependency variant.
	TplExtensions []*TemplateExtension `protobuf:"bytes,5,rep,name=tpl_extensions,json=tplExtensions,proto3" json:"tpl_extensions,omitempty"`
	// contains filtered or unexported fields
}

func (*ComputeProcessResponse) Descriptor deprecated

func (*ComputeProcessResponse) Descriptor() ([]byte, []int)

Deprecated: Use ComputeProcessResponse.ProtoReflect.Descriptor instead.

func (*ComputeProcessResponse) GetEnv deprecated

func (x *ComputeProcessResponse) GetEnv() map[string]*InputValue

Deprecated: Marked as deprecated in v1/plugin.proto.

func (*ComputeProcessResponse) GetEnvVars

func (x *ComputeProcessResponse) GetEnvVars() []*ComputeEnvVariable

func (*ComputeProcessResponse) GetPlaceholders

func (x *ComputeProcessResponse) GetPlaceholders() map[string]string

func (*ComputeProcessResponse) GetTplExtensions

func (x *ComputeProcessResponse) GetTplExtensions() []*TemplateExtension

func (*ComputeProcessResponse) GetUrn

func (x *ComputeProcessResponse) GetUrn() string

func (*ComputeProcessResponse) ProtoMessage

func (*ComputeProcessResponse) ProtoMessage()

func (*ComputeProcessResponse) ProtoReflect

func (x *ComputeProcessResponse) ProtoReflect() protoreflect.Message

func (*ComputeProcessResponse) Reset

func (x *ComputeProcessResponse) Reset()

func (*ComputeProcessResponse) String

func (x *ComputeProcessResponse) String() string

type ConvertStackConfigRequest

type ConvertStackConfigRequest struct {
	Header *RequestHeader `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	// template_type is the `type:` the server.yaml declared for this
	// stack's template (one of ResourceTypes advertised by the plugin's
	// Schema; a plugin that advertises templates folds them in there).
	TemplateType string `protobuf:"bytes,2,opt,name=template_type,json=templateType,proto3" json:"template_type,omitempty"`
	// The CLI-side stack name (from ClientDescriptor.Stacks key), passed
	// through to the plugin's existing ToXxxConfig closures that accept
	// stackName. Equivalent to StackParams.StackName.
	StackName string `protobuf:"bytes,3,opt,name=stack_name,json=stackName,proto3" json:"stack_name,omitempty"`
	// Operator-side ${git:root}, pre-resolved. Plugins that read
	// bundleDir or similar paths relative to the repo root need this.
	StackDir string `protobuf:"bytes,4,opt,name=stack_dir,json=stackDir,proto3" json:"stack_dir,omitempty"`
	// The merged StackConfig* (StackConfigCompose / StackConfigSingleImage /
	// StackConfigStatic — whichever the client.yaml declared) as a scalar
	// InputValue tree. Same marshalling the Provision RPC already uses
	// (yaml round-trip in pkg/plugin/compute.go). The plugin unmarshals
	// into its typed StackConfig and feeds its existing ToXxxConfig
	// closure.
	StackConfig map[string]*InputValue `` /* 168-byte string literal not displayed */
	// template_config is the server.yaml-side TEMPLATE config body
	// (StackDescriptor.Config.Config at the parent provisioning time —
	// e.g. aws:TemplateConfig for aws templates, cloudflare:PagesTemplateConfig
	// for cloudflare, …). SC core's pre-A2 path decoded this via
	// providerConfigMapping into the plugin's typed struct; A2's opaque
	// decoder keeps it as a raw map so the full template config crosses
	// the bus here and the plugin decodes into its own typed TemplateConfig.
	TemplateConfig map[string]*InputValue `` /* 177-byte string literal not displayed */
	// contains filtered or unexported fields
}

ConvertStackConfigRequest — SC core asks the plugin to turn a consumer stack's merged StackConfig* (compose/single-image/static) into the plugin's own typed Input (LambdaInput / StaticSiteInput / EcsFargateInput / …). Previously this conversion lived in SC-core-side closures that each plugin's /api/init.go installed into cloud{SingleImage,Compose,StaticSite}ConverterMapping, which forced SC core to Go-link-time-import every plugin's /api. The RPC moves the conversion across the bus so plugins can introduce new template types via a plugin release alone, with no SC CLI rebuild. See forge/docs/design/2026-11-02/plugin-types-parse-time-registration/.

func (*ConvertStackConfigRequest) Descriptor deprecated

func (*ConvertStackConfigRequest) Descriptor() ([]byte, []int)

Deprecated: Use ConvertStackConfigRequest.ProtoReflect.Descriptor instead.

func (*ConvertStackConfigRequest) GetHeader

func (x *ConvertStackConfigRequest) GetHeader() *RequestHeader

func (*ConvertStackConfigRequest) GetStackConfig

func (x *ConvertStackConfigRequest) GetStackConfig() map[string]*InputValue

func (*ConvertStackConfigRequest) GetStackDir

func (x *ConvertStackConfigRequest) GetStackDir() string

func (*ConvertStackConfigRequest) GetStackName

func (x *ConvertStackConfigRequest) GetStackName() string

func (*ConvertStackConfigRequest) GetTemplateConfig

func (x *ConvertStackConfigRequest) GetTemplateConfig() map[string]*InputValue

func (*ConvertStackConfigRequest) GetTemplateType

func (x *ConvertStackConfigRequest) GetTemplateType() string

func (*ConvertStackConfigRequest) ProtoMessage

func (*ConvertStackConfigRequest) ProtoMessage()

func (*ConvertStackConfigRequest) ProtoReflect

func (*ConvertStackConfigRequest) Reset

func (x *ConvertStackConfigRequest) Reset()

func (*ConvertStackConfigRequest) String

func (x *ConvertStackConfigRequest) String() string

type ConvertStackConfigResponse

type ConvertStackConfigResponse struct {

	// The plugin's typed Input (StaticSiteInput / LambdaInput /
	// EcsFargateInput / etc.) marshalled as a scalar InputValue tree.
	// SC core wraps it in a pluginPreparedInput adapter whose Config.Config
	// the Provision RPC forwards verbatim.
	Input map[string]*InputValue `` /* 137-byte string literal not displayed */
	// Structured fields SC core type-asserts off clientStackDesc.Config.Config
	// via Go interfaces downstream (DnsConfigAware / ResourceAware /
	// WithDependsOnResources). An opaque gRPC return type cannot satisfy
	// a Go interface, so we lift the three facts the asserts actually
	// read and pin them on the adapter.
	//
	// base_dns_zone — DnsConfigAware.DnsConfig().OverriddenBaseZone,
	// asserted at pkg/clouds/pulumi/deploy.go:133.
	BaseDnsZone string `protobuf:"bytes,2,opt,name=base_dns_zone,json=baseDnsZone,proto3" json:"base_dns_zone,omitempty"`
	// uses — ResourceAware.Uses(), asserted at
	// pkg/clouds/pulumi/deploy.go:146 and pkg/provisioner/unresolved.go:109.
	// Lists `uses: [<resource>]` declarations the deployed stack reads
	// compute env from.
	Uses []string `protobuf:"bytes,3,rep,name=uses,proto3" json:"uses,omitempty"`
	// depends_on_resources — WithDependsOnResources.DependsOnResources(),
	// asserted at pkg/clouds/pulumi/deploy.go:153 and
	// pkg/provisioner/unresolved.go:112. Each entry carries the full
	// (name, owner, resource, env) shape of api.StackConfigDependencyResource,
	// encoded as JSON so a future field addition on the Go struct does
	// not require a proto bump (same forward-compat shape
	// ComputeProcessRequest.parent_info_json uses).
	DependsOnResourcesJson [][]byte `` /* 131-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*ConvertStackConfigResponse) Descriptor deprecated

func (*ConvertStackConfigResponse) Descriptor() ([]byte, []int)

Deprecated: Use ConvertStackConfigResponse.ProtoReflect.Descriptor instead.

func (*ConvertStackConfigResponse) GetBaseDnsZone

func (x *ConvertStackConfigResponse) GetBaseDnsZone() string

func (*ConvertStackConfigResponse) GetDependsOnResourcesJson

func (x *ConvertStackConfigResponse) GetDependsOnResourcesJson() [][]byte

func (*ConvertStackConfigResponse) GetInput

func (x *ConvertStackConfigResponse) GetInput() map[string]*InputValue

func (*ConvertStackConfigResponse) GetUses

func (x *ConvertStackConfigResponse) GetUses() []string

func (*ConvertStackConfigResponse) ProtoMessage

func (*ConvertStackConfigResponse) ProtoMessage()

func (*ConvertStackConfigResponse) ProtoReflect

func (*ConvertStackConfigResponse) Reset

func (x *ConvertStackConfigResponse) Reset()

func (*ConvertStackConfigResponse) String

func (x *ConvertStackConfigResponse) String() string

type InitSecretsProviderRequest

type InitSecretsProviderRequest struct {
	Header              *RequestHeader         `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	SecretsProviderType string                 `protobuf:"bytes,2,opt,name=secrets_provider_type,json=secretsProviderType,proto3" json:"secrets_provider_type,omitempty"` // from SchemaResponse.secrets_provider_types
	Config              map[string]*InputValue ``                                                                                                                         /* 139-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*InitSecretsProviderRequest) Descriptor deprecated

func (*InitSecretsProviderRequest) Descriptor() ([]byte, []int)

Deprecated: Use InitSecretsProviderRequest.ProtoReflect.Descriptor instead.

func (*InitSecretsProviderRequest) GetConfig

func (x *InitSecretsProviderRequest) GetConfig() map[string]*InputValue

func (*InitSecretsProviderRequest) GetHeader

func (x *InitSecretsProviderRequest) GetHeader() *RequestHeader

func (*InitSecretsProviderRequest) GetSecretsProviderType

func (x *InitSecretsProviderRequest) GetSecretsProviderType() string

func (*InitSecretsProviderRequest) ProtoMessage

func (*InitSecretsProviderRequest) ProtoMessage()

func (*InitSecretsProviderRequest) ProtoReflect

func (*InitSecretsProviderRequest) Reset

func (x *InitSecretsProviderRequest) Reset()

func (*InitSecretsProviderRequest) String

func (x *InitSecretsProviderRequest) String() string

type InitSecretsProviderResponse

type InitSecretsProviderResponse struct {

	// Pulumi secrets-provider URL — one of the pulumi/secrets handler schemes.
	// Example: "awskms://alias/mykey?region=eu-west-1"
	ProviderUrl string `protobuf:"bytes,1,opt,name=provider_url,json=providerUrl,proto3" json:"provider_url,omitempty"`
	// Env vars SC core should set before the engine starts (credentials, etc).
	// Secret-flagged values are preserved as secrets.
	Env map[string]*InputValue `` /* 133-byte string literal not displayed */
	// If set, this is the passphrase to seed when provider_url is a passphrase
	// scheme — mirrors the pulumi{}.secretsProviderPassphrase field. Secret.
	Passphrase string `protobuf:"bytes,3,opt,name=passphrase,proto3" json:"passphrase,omitempty"`
	// contains filtered or unexported fields
}

func (*InitSecretsProviderResponse) Descriptor deprecated

func (*InitSecretsProviderResponse) Descriptor() ([]byte, []int)

Deprecated: Use InitSecretsProviderResponse.ProtoReflect.Descriptor instead.

func (*InitSecretsProviderResponse) GetEnv

func (*InitSecretsProviderResponse) GetPassphrase

func (x *InitSecretsProviderResponse) GetPassphrase() string

func (*InitSecretsProviderResponse) GetProviderUrl

func (x *InitSecretsProviderResponse) GetProviderUrl() string

func (*InitSecretsProviderResponse) ProtoMessage

func (*InitSecretsProviderResponse) ProtoMessage()

func (*InitSecretsProviderResponse) ProtoReflect

func (*InitSecretsProviderResponse) Reset

func (x *InitSecretsProviderResponse) Reset()

func (*InitSecretsProviderResponse) String

func (x *InitSecretsProviderResponse) String() string

type InitStateStoreRequest

type InitStateStoreRequest struct {
	Header         *RequestHeader         `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	StateStoreType string                 `protobuf:"bytes,2,opt,name=state_store_type,json=stateStoreType,proto3" json:"state_store_type,omitempty"` // from SchemaResponse.state_store_types
	Config         map[string]*InputValue ``                                                                                                          /* 139-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*InitStateStoreRequest) Descriptor deprecated

func (*InitStateStoreRequest) Descriptor() ([]byte, []int)

Deprecated: Use InitStateStoreRequest.ProtoReflect.Descriptor instead.

func (*InitStateStoreRequest) GetConfig

func (x *InitStateStoreRequest) GetConfig() map[string]*InputValue

func (*InitStateStoreRequest) GetHeader

func (x *InitStateStoreRequest) GetHeader() *RequestHeader

func (*InitStateStoreRequest) GetStateStoreType

func (x *InitStateStoreRequest) GetStateStoreType() string

func (*InitStateStoreRequest) ProtoMessage

func (*InitStateStoreRequest) ProtoMessage()

func (*InitStateStoreRequest) ProtoReflect

func (x *InitStateStoreRequest) ProtoReflect() protoreflect.Message

func (*InitStateStoreRequest) Reset

func (x *InitStateStoreRequest) Reset()

func (*InitStateStoreRequest) String

func (x *InitStateStoreRequest) String() string

type InitStateStoreResponse

type InitStateStoreResponse struct {

	// Pulumi backend URL to pass to auto.NewLocalWorkspace / UpsertStackInlineSource.
	// Example: "s3://sc-state/<project>?region=eu-west-1"
	BackendUrl string `protobuf:"bytes,1,opt,name=backend_url,json=backendUrl,proto3" json:"backend_url,omitempty"`
	// Environment variables SC core should set before starting the engine (e.g.
	// AWS_ACCESS_KEY_ID, GOOGLE_CREDENTIALS). Must be flagged secret if secret.
	Env map[string]*InputValue `` /* 133-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*InitStateStoreResponse) Descriptor deprecated

func (*InitStateStoreResponse) Descriptor() ([]byte, []int)

Deprecated: Use InitStateStoreResponse.ProtoReflect.Descriptor instead.

func (*InitStateStoreResponse) GetBackendUrl

func (x *InitStateStoreResponse) GetBackendUrl() string

func (*InitStateStoreResponse) GetEnv

func (x *InitStateStoreResponse) GetEnv() map[string]*InputValue

func (*InitStateStoreResponse) ProtoMessage

func (*InitStateStoreResponse) ProtoMessage()

func (*InitStateStoreResponse) ProtoReflect

func (x *InitStateStoreResponse) ProtoReflect() protoreflect.Message

func (*InitStateStoreResponse) Reset

func (x *InitStateStoreResponse) Reset()

func (*InitStateStoreResponse) String

func (x *InitStateStoreResponse) String() string

type InputList

type InputList struct {
	Items []*InputValue `protobuf:"bytes,1,rep,name=items,proto3" json:"items,omitempty"`
	// contains filtered or unexported fields
}

func (*InputList) Descriptor deprecated

func (*InputList) Descriptor() ([]byte, []int)

Deprecated: Use InputList.ProtoReflect.Descriptor instead.

func (*InputList) GetItems

func (x *InputList) GetItems() []*InputValue

func (*InputList) ProtoMessage

func (*InputList) ProtoMessage()

func (*InputList) ProtoReflect

func (x *InputList) ProtoReflect() protoreflect.Message

func (*InputList) Reset

func (x *InputList) Reset()

func (*InputList) String

func (x *InputList) String() string

type InputMap

type InputMap struct {
	Fields map[string]*InputValue `` /* 139-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*InputMap) Descriptor deprecated

func (*InputMap) Descriptor() ([]byte, []int)

Deprecated: Use InputMap.ProtoReflect.Descriptor instead.

func (*InputMap) GetFields

func (x *InputMap) GetFields() map[string]*InputValue

func (*InputMap) ProtoMessage

func (*InputMap) ProtoMessage()

func (*InputMap) ProtoReflect

func (x *InputMap) ProtoReflect() protoreflect.Message

func (*InputMap) Reset

func (x *InputMap) Reset()

func (*InputMap) String

func (x *InputMap) String() string

type InputValue

type InputValue struct {

	// Types that are valid to be assigned to Value:
	//
	//	*InputValue_StringValue
	//	*InputValue_IntValue
	//	*InputValue_DoubleValue
	//	*InputValue_BoolValue
	//	*InputValue_BytesValue
	//	*InputValue_ListValue
	//	*InputValue_MapValue
	//	*InputValue_OutputRef
	//	*InputValue_SecretRef
	Value isInputValue_Value `protobuf_oneof:"value"`
	// Marks this field as secret in the YAML config. Plugins calling pulumi.ToSecret
	// on the value (or using secret_ref) must preserve the flag.
	Secret bool `protobuf:"varint,10,opt,name=secret,proto3" json:"secret,omitempty"`
	// contains filtered or unexported fields
}

InputValue is the typed carrier for a resource input or a config field on the plugin bus. Secrets are flagged (not transmitted plain): a real cleartext fetch goes through the callback service.

func (*InputValue) Descriptor deprecated

func (*InputValue) Descriptor() ([]byte, []int)

Deprecated: Use InputValue.ProtoReflect.Descriptor instead.

func (*InputValue) GetBoolValue

func (x *InputValue) GetBoolValue() bool

func (*InputValue) GetBytesValue

func (x *InputValue) GetBytesValue() []byte

func (*InputValue) GetDoubleValue

func (x *InputValue) GetDoubleValue() float64

func (*InputValue) GetIntValue

func (x *InputValue) GetIntValue() int64

func (*InputValue) GetListValue

func (x *InputValue) GetListValue() *InputList

func (*InputValue) GetMapValue

func (x *InputValue) GetMapValue() *InputMap

func (*InputValue) GetOutputRef

func (x *InputValue) GetOutputRef() string

func (*InputValue) GetSecret

func (x *InputValue) GetSecret() bool

func (*InputValue) GetSecretRef

func (x *InputValue) GetSecretRef() string

func (*InputValue) GetStringValue

func (x *InputValue) GetStringValue() string

func (*InputValue) GetValue

func (x *InputValue) GetValue() isInputValue_Value

func (*InputValue) ProtoMessage

func (*InputValue) ProtoMessage()

func (*InputValue) ProtoReflect

func (x *InputValue) ProtoReflect() protoreflect.Message

func (*InputValue) Reset

func (x *InputValue) Reset()

func (*InputValue) String

func (x *InputValue) String() string

type InputValue_BoolValue

type InputValue_BoolValue struct {
	BoolValue bool `protobuf:"varint,4,opt,name=bool_value,json=boolValue,proto3,oneof"`
}

type InputValue_BytesValue

type InputValue_BytesValue struct {
	BytesValue []byte `protobuf:"bytes,5,opt,name=bytes_value,json=bytesValue,proto3,oneof"`
}

type InputValue_DoubleValue

type InputValue_DoubleValue struct {
	DoubleValue float64 `protobuf:"fixed64,3,opt,name=double_value,json=doubleValue,proto3,oneof"`
}

type InputValue_IntValue

type InputValue_IntValue struct {
	IntValue int64 `protobuf:"zigzag64,2,opt,name=int_value,json=intValue,proto3,oneof"`
}

type InputValue_ListValue

type InputValue_ListValue struct {
	ListValue *InputList `protobuf:"bytes,6,opt,name=list_value,json=listValue,proto3,oneof"`
}

type InputValue_MapValue

type InputValue_MapValue struct {
	MapValue *InputMap `protobuf:"bytes,7,opt,name=map_value,json=mapValue,proto3,oneof"`
}

type InputValue_OutputRef

type InputValue_OutputRef struct {
	// Opaque reference to another resource's output. The plugin passes it through
	// to Pulumi's RegisterResource as a dependency, not a value.
	OutputRef string `protobuf:"bytes,8,opt,name=output_ref,json=outputRef,proto3,oneof"`
}

type InputValue_SecretRef

type InputValue_SecretRef struct {
	// Reference to a secret the plugin should fetch via ResolveSecret.
	SecretRef string `protobuf:"bytes,9,opt,name=secret_ref,json=secretRef,proto3,oneof"`
}

type InputValue_StringValue

type InputValue_StringValue struct {
	StringValue string `protobuf:"bytes,1,opt,name=string_value,json=stringValue,proto3,oneof"`
}

type LogSeverity

type LogSeverity int32

Severity mirrors the usual trio in logger.Logger. UNKNOWN is treated as INFO by SC core.

const (
	LogSeverity_LOG_SEVERITY_UNSPECIFIED LogSeverity = 0
	LogSeverity_LOG_SEVERITY_DEBUG       LogSeverity = 1
	LogSeverity_LOG_SEVERITY_INFO        LogSeverity = 2
	LogSeverity_LOG_SEVERITY_WARN        LogSeverity = 3
	LogSeverity_LOG_SEVERITY_ERROR       LogSeverity = 4
)

func (LogSeverity) Descriptor

func (LogSeverity) Enum

func (x LogSeverity) Enum() *LogSeverity

func (LogSeverity) EnumDescriptor deprecated

func (LogSeverity) EnumDescriptor() ([]byte, []int)

Deprecated: Use LogSeverity.Descriptor instead.

func (LogSeverity) Number

func (x LogSeverity) Number() protoreflect.EnumNumber

func (LogSeverity) String

func (x LogSeverity) String() string

func (LogSeverity) Type

type LogStreamRequest

type LogStreamRequest struct {

	// Correlation id — echoed back in every event so a log consumer can
	// associate events with the plugin that produced them. SC core sets
	// this to the plugin name declared in server.yaml.
	PluginName string `protobuf:"bytes,1,opt,name=plugin_name,json=pluginName,proto3" json:"plugin_name,omitempty"`
	// contains filtered or unexported fields
}

func (*LogStreamRequest) Descriptor deprecated

func (*LogStreamRequest) Descriptor() ([]byte, []int)

Deprecated: Use LogStreamRequest.ProtoReflect.Descriptor instead.

func (*LogStreamRequest) GetPluginName

func (x *LogStreamRequest) GetPluginName() string

func (*LogStreamRequest) ProtoMessage

func (*LogStreamRequest) ProtoMessage()

func (*LogStreamRequest) ProtoReflect

func (x *LogStreamRequest) ProtoReflect() protoreflect.Message

func (*LogStreamRequest) Reset

func (x *LogStreamRequest) Reset()

func (*LogStreamRequest) String

func (x *LogStreamRequest) String() string

type NewDnsRecordRequest

type NewDnsRecordRequest struct {
	Header        *RequestHeader `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	RegistrarType string         `protobuf:"bytes,2,opt,name=registrar_type,json=registrarType,proto3" json:"registrar_type,omitempty"`
	// The DnsRecord fields that cross the gRPC boundary as values. Pulumi
	// sdk.StringOutput's can't; `value_resolved` carries the resolved string
	// the SC-core-side pluginRegistrar.NewRecord obtains via ApplyT before
	// the RPC call.
	RecordName    string `protobuf:"bytes,3,opt,name=record_name,json=recordName,proto3" json:"record_name,omitempty"`
	RecordType    string `protobuf:"bytes,4,opt,name=record_type,json=recordType,proto3" json:"record_type,omitempty"`
	ValueResolved string `protobuf:"bytes,5,opt,name=value_resolved,json=valueResolved,proto3" json:"value_resolved,omitempty"`
	Proxied       bool   `protobuf:"varint,6,opt,name=proxied,proto3" json:"proxied,omitempty"`
	// Priority — used by MX / SRV / URI records, ignored by everything
	// else. optional so SC core can omit it on non-MX records and the
	// plugin side can distinguish "unset" from "priority 0". Live-caught
	// on navizon-infra 2026-11-03: Proton Mail MX setup needs
	// priority 10 → mail.protonmail.ch, priority 20 → mailsec.protonmail.ch,
	// and before this field the records were being sent without priority
	// at all (and some clouds would silently default to 0).
	Priority *int32 `protobuf:"varint,7,opt,name=priority,proto3,oneof" json:"priority,omitempty"`
	// contains filtered or unexported fields
}

func (*NewDnsRecordRequest) Descriptor deprecated

func (*NewDnsRecordRequest) Descriptor() ([]byte, []int)

Deprecated: Use NewDnsRecordRequest.ProtoReflect.Descriptor instead.

func (*NewDnsRecordRequest) GetHeader

func (x *NewDnsRecordRequest) GetHeader() *RequestHeader

func (*NewDnsRecordRequest) GetPriority

func (x *NewDnsRecordRequest) GetPriority() int32

func (*NewDnsRecordRequest) GetProxied

func (x *NewDnsRecordRequest) GetProxied() bool

func (*NewDnsRecordRequest) GetRecordName

func (x *NewDnsRecordRequest) GetRecordName() string

func (*NewDnsRecordRequest) GetRecordType

func (x *NewDnsRecordRequest) GetRecordType() string

func (*NewDnsRecordRequest) GetRegistrarType

func (x *NewDnsRecordRequest) GetRegistrarType() string

func (*NewDnsRecordRequest) GetValueResolved

func (x *NewDnsRecordRequest) GetValueResolved() string

func (*NewDnsRecordRequest) ProtoMessage

func (*NewDnsRecordRequest) ProtoMessage()

func (*NewDnsRecordRequest) ProtoReflect

func (x *NewDnsRecordRequest) ProtoReflect() protoreflect.Message

func (*NewDnsRecordRequest) Reset

func (x *NewDnsRecordRequest) Reset()

func (*NewDnsRecordRequest) String

func (x *NewDnsRecordRequest) String() string

type NewDnsRecordResponse

type NewDnsRecordResponse struct {
	Urn string `protobuf:"bytes,1,opt,name=urn,proto3" json:"urn,omitempty"`
	// contains filtered or unexported fields
}

func (*NewDnsRecordResponse) Descriptor deprecated

func (*NewDnsRecordResponse) Descriptor() ([]byte, []int)

Deprecated: Use NewDnsRecordResponse.ProtoReflect.Descriptor instead.

func (*NewDnsRecordResponse) GetUrn

func (x *NewDnsRecordResponse) GetUrn() string

func (*NewDnsRecordResponse) ProtoMessage

func (*NewDnsRecordResponse) ProtoMessage()

func (*NewDnsRecordResponse) ProtoReflect

func (x *NewDnsRecordResponse) ProtoReflect() protoreflect.Message

func (*NewDnsRecordResponse) Reset

func (x *NewDnsRecordResponse) Reset()

func (*NewDnsRecordResponse) String

func (x *NewDnsRecordResponse) String() string

type NewOverrideHeaderRuleRequest

type NewOverrideHeaderRuleRequest struct {
	Header        *RequestHeader `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	RegistrarType string         `protobuf:"bytes,2,opt,name=registrar_type,json=registrarType,proto3" json:"registrar_type,omitempty"`
	StackName     string         `protobuf:"bytes,3,opt,name=stack_name,json=stackName,proto3" json:"stack_name,omitempty"`
	// OverrideHeaderRule fields:
	RuleName       string            `protobuf:"bytes,4,opt,name=rule_name,json=ruleName,proto3" json:"rule_name,omitempty"`
	FromHost       string            `protobuf:"bytes,5,opt,name=from_host,json=fromHost,proto3" json:"from_host,omitempty"`
	ToHostResolved string            `protobuf:"bytes,6,opt,name=to_host_resolved,json=toHostResolved,proto3" json:"to_host_resolved,omitempty"` // sdk.StringInput resolved by SC core before RPC
	PathPrefix     string            `protobuf:"bytes,7,opt,name=path_prefix,json=pathPrefix,proto3" json:"path_prefix,omitempty"`
	BasicAuth      *BasicAuthMsg     `protobuf:"bytes,8,opt,name=basic_auth,json=basicAuth,proto3" json:"basic_auth,omitempty"`
	OverridePages  *OverridePagesMsg `protobuf:"bytes,9,opt,name=override_pages,json=overridePages,proto3" json:"override_pages,omitempty"`
	// contains filtered or unexported fields
}

func (*NewOverrideHeaderRuleRequest) Descriptor deprecated

func (*NewOverrideHeaderRuleRequest) Descriptor() ([]byte, []int)

Deprecated: Use NewOverrideHeaderRuleRequest.ProtoReflect.Descriptor instead.

func (*NewOverrideHeaderRuleRequest) GetBasicAuth

func (x *NewOverrideHeaderRuleRequest) GetBasicAuth() *BasicAuthMsg

func (*NewOverrideHeaderRuleRequest) GetFromHost

func (x *NewOverrideHeaderRuleRequest) GetFromHost() string

func (*NewOverrideHeaderRuleRequest) GetHeader

func (*NewOverrideHeaderRuleRequest) GetOverridePages

func (x *NewOverrideHeaderRuleRequest) GetOverridePages() *OverridePagesMsg

func (*NewOverrideHeaderRuleRequest) GetPathPrefix

func (x *NewOverrideHeaderRuleRequest) GetPathPrefix() string

func (*NewOverrideHeaderRuleRequest) GetRegistrarType

func (x *NewOverrideHeaderRuleRequest) GetRegistrarType() string

func (*NewOverrideHeaderRuleRequest) GetRuleName

func (x *NewOverrideHeaderRuleRequest) GetRuleName() string

func (*NewOverrideHeaderRuleRequest) GetStackName

func (x *NewOverrideHeaderRuleRequest) GetStackName() string

func (*NewOverrideHeaderRuleRequest) GetToHostResolved

func (x *NewOverrideHeaderRuleRequest) GetToHostResolved() string

func (*NewOverrideHeaderRuleRequest) ProtoMessage

func (*NewOverrideHeaderRuleRequest) ProtoMessage()

func (*NewOverrideHeaderRuleRequest) ProtoReflect

func (*NewOverrideHeaderRuleRequest) Reset

func (x *NewOverrideHeaderRuleRequest) Reset()

func (*NewOverrideHeaderRuleRequest) String

type NewOverrideHeaderRuleResponse

type NewOverrideHeaderRuleResponse struct {
	Urn string `protobuf:"bytes,1,opt,name=urn,proto3" json:"urn,omitempty"`
	// contains filtered or unexported fields
}

func (*NewOverrideHeaderRuleResponse) Descriptor deprecated

func (*NewOverrideHeaderRuleResponse) Descriptor() ([]byte, []int)

Deprecated: Use NewOverrideHeaderRuleResponse.ProtoReflect.Descriptor instead.

func (*NewOverrideHeaderRuleResponse) GetUrn

func (*NewOverrideHeaderRuleResponse) ProtoMessage

func (*NewOverrideHeaderRuleResponse) ProtoMessage()

func (*NewOverrideHeaderRuleResponse) ProtoReflect

func (*NewOverrideHeaderRuleResponse) Reset

func (x *NewOverrideHeaderRuleResponse) Reset()

func (*NewOverrideHeaderRuleResponse) String

type OutputValue

type OutputValue struct {

	// Types that are valid to be assigned to From:
	//
	//	*OutputValue_Literal
	//	*OutputValue_Ref
	From isOutputValue_From `protobuf_oneof:"from"`
	// Core applies pulumi.ToSecret when set. Idempotent, and applied unconditionally
	// to private_key / private_key_password regardless of this flag — see §3.5.
	Secret bool `protobuf:"varint,3,opt,name=secret,proto3" json:"secret,omitempty"`
	// contains filtered or unexported fields
}

OutputValue is a value a plugin produces that SC core must hold as a pulumi Output.

Distinct from InputValue.output_ref, which travels the other way: that is an opaque handle a plugin passes THROUGH to RegisterResource as a dependency. This is a value core resolves and reads.

func (*OutputValue) Descriptor deprecated

func (*OutputValue) Descriptor() ([]byte, []int)

Deprecated: Use OutputValue.ProtoReflect.Descriptor instead.

func (*OutputValue) GetFrom

func (x *OutputValue) GetFrom() isOutputValue_From

func (*OutputValue) GetLiteral

func (x *OutputValue) GetLiteral() string

func (*OutputValue) GetRef

func (x *OutputValue) GetRef() *ResourcePropertyRef

func (*OutputValue) GetSecret

func (x *OutputValue) GetSecret() bool

func (*OutputValue) ProtoMessage

func (*OutputValue) ProtoMessage()

func (*OutputValue) ProtoReflect

func (x *OutputValue) ProtoReflect() protoreflect.Message

func (*OutputValue) Reset

func (x *OutputValue) Reset()

func (*OutputValue) String

func (x *OutputValue) String() string

type OutputValue_Literal

type OutputValue_Literal struct {
	// Known without any resource — a byo host's address, an empty key password, a
	// pinned host key. Core wraps it with pulumi.String.
	Literal string `protobuf:"bytes,1,opt,name=literal,proto3,oneof"`
}

type OutputValue_Ref

type OutputValue_Ref struct {
	Ref *ResourcePropertyRef `protobuf:"bytes,2,opt,name=ref,proto3,oneof"`
}

type OverridePagesMsg

type OverridePagesMsg struct {
	IndexPage    string `protobuf:"bytes,1,opt,name=index_page,json=indexPage,proto3" json:"index_page,omitempty"`
	NotFoundPage string `protobuf:"bytes,2,opt,name=not_found_page,json=notFoundPage,proto3" json:"not_found_page,omitempty"`
	// contains filtered or unexported fields
}

func (*OverridePagesMsg) Descriptor deprecated

func (*OverridePagesMsg) Descriptor() ([]byte, []int)

Deprecated: Use OverridePagesMsg.ProtoReflect.Descriptor instead.

func (*OverridePagesMsg) GetIndexPage

func (x *OverridePagesMsg) GetIndexPage() string

func (*OverridePagesMsg) GetNotFoundPage

func (x *OverridePagesMsg) GetNotFoundPage() string

func (*OverridePagesMsg) ProtoMessage

func (*OverridePagesMsg) ProtoMessage()

func (*OverridePagesMsg) ProtoReflect

func (x *OverridePagesMsg) ProtoReflect() protoreflect.Message

func (*OverridePagesMsg) Reset

func (x *OverridePagesMsg) Reset()

func (*OverridePagesMsg) String

func (x *OverridePagesMsg) String() string

type PeerInvokeRequest

type PeerInvokeRequest struct {

	// The short-lived scoped token from the plugin's own RequestHeader.
	// SC core validates this before accepting the invocation to prevent
	// a plugin spoofing another plugin's identity.
	RunToken string `protobuf:"bytes,1,opt,name=run_token,json=runToken,proto3" json:"run_token,omitempty"`
	// The target plugin's advertised name — the one SC core assigned on
	// load (`sc-plugin-aws`, `sc-plugin-cloudflare`, ...).
	PluginName string `protobuf:"bytes,2,opt,name=plugin_name,json=pluginName,proto3" json:"plugin_name,omitempty"`
	// The SCCloudPlugin service method to invoke. Case-sensitive, matches
	// the proto method name exactly.
	RpcName string `protobuf:"bytes,3,opt,name=rpc_name,json=rpcName,proto3" json:"rpc_name,omitempty"`
	// Serialised SCCloudPlugin sub-request (proto wire format). The server
	// routes based on rpc_name and unmarshals into the matching request
	// message type.
	Payload []byte `protobuf:"bytes,4,opt,name=payload,proto3" json:"payload,omitempty"`
	// contains filtered or unexported fields
}

PeerInvoke lets a composite plugin ask SC core to run one RPC on another plugin. The target is named by its SC plugin name (`sc-plugin-aws` etc.) and the RPC by the SCCloudPlugin method name (`Provision`, `Provider`, `NewDnsRecord`, ...); SC core looks the plugin up in its loaded registry and dispatches.

Why plugin → core → plugin and not plugin → plugin: a direct plugin-to-plugin connection would reintroduce the M×N discovery / security / version matrix D8 explicitly rejects. SC core as broker means every plugin only knows one callback endpoint.

Payloads are proto bytes. The plugin-side helper (pkg/plugin/peer.go) marshals/unmarshals typed requests and responses; the server side does the same against the target plugin's client stub.

func (*PeerInvokeRequest) Descriptor deprecated

func (*PeerInvokeRequest) Descriptor() ([]byte, []int)

Deprecated: Use PeerInvokeRequest.ProtoReflect.Descriptor instead.

func (*PeerInvokeRequest) GetPayload

func (x *PeerInvokeRequest) GetPayload() []byte

func (*PeerInvokeRequest) GetPluginName

func (x *PeerInvokeRequest) GetPluginName() string

func (*PeerInvokeRequest) GetRpcName

func (x *PeerInvokeRequest) GetRpcName() string

func (*PeerInvokeRequest) GetRunToken

func (x *PeerInvokeRequest) GetRunToken() string

func (*PeerInvokeRequest) ProtoMessage

func (*PeerInvokeRequest) ProtoMessage()

func (*PeerInvokeRequest) ProtoReflect

func (x *PeerInvokeRequest) ProtoReflect() protoreflect.Message

func (*PeerInvokeRequest) Reset

func (x *PeerInvokeRequest) Reset()

func (*PeerInvokeRequest) String

func (x *PeerInvokeRequest) String() string

type PeerInvokeResponse

type PeerInvokeResponse struct {

	// Serialised SCCloudPlugin sub-response (proto wire format), when the
	// target plugin's RPC succeeded.
	Payload []byte `protobuf:"bytes,1,opt,name=payload,proto3" json:"payload,omitempty"`
	// Non-empty on target-plugin error. Carries the Go error text; the
	// caller wraps it as a Go error.
	Error string `protobuf:"bytes,2,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

func (*PeerInvokeResponse) Descriptor deprecated

func (*PeerInvokeResponse) Descriptor() ([]byte, []int)

Deprecated: Use PeerInvokeResponse.ProtoReflect.Descriptor instead.

func (*PeerInvokeResponse) GetError

func (x *PeerInvokeResponse) GetError() string

func (*PeerInvokeResponse) GetPayload

func (x *PeerInvokeResponse) GetPayload() []byte

func (*PeerInvokeResponse) ProtoMessage

func (*PeerInvokeResponse) ProtoMessage()

func (*PeerInvokeResponse) ProtoReflect

func (x *PeerInvokeResponse) ProtoReflect() protoreflect.Message

func (*PeerInvokeResponse) Reset

func (x *PeerInvokeResponse) Reset()

func (*PeerInvokeResponse) String

func (x *PeerInvokeResponse) String() string

type PluginInvokeRequest

type PluginInvokeRequest struct {
	Header *RequestHeader `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	// Named capability on the target plugin. Must appear in that
	// plugin's `SchemaResponse.peer_capabilities`. Enforced by the
	// broker — a call to an unadvertised capability is refused before
	// the forward.
	Capability string `protobuf:"bytes,2,opt,name=capability,proto3" json:"capability,omitempty"`
	// Opaque JSON payload — schema is capability-specific. First
	// consumer pair (sc-component-backup → sc-plugin-mongodb for
	// `mint-scoped-user`): payload `{"database": string, "roleName":
	// string, "consumerStack": string}`. Target plugin unmarshals
	// into its own typed struct.
	PayloadJson []byte `protobuf:"bytes,3,opt,name=payload_json,json=payloadJson,proto3" json:"payload_json,omitempty"`
	// Name of the calling plugin (filled in by SC core's broker
	// before forwarding). Target plugin uses this for logging +
	// optional per-caller policy. Callers MUST NOT set this; the
	// broker overwrites.
	CallingPlugin string `protobuf:"bytes,4,opt,name=calling_plugin,json=callingPlugin,proto3" json:"calling_plugin,omitempty"`
	// contains filtered or unexported fields
}

PluginInvokeRequest is the capability-dispatch envelope on SCCloudPlugin. A CALLING plugin dispatches a cross-plugin capability via the existing SCCore.PeerInvoke(rpc_name="PluginInvoke", payload=marshal(PluginInvokeRequest)) — SC core routes to the target plugin's SCCloudPlugin.PluginInvoke, which switches on `capability` to its registered handler.

Why a separate RPC + capability name rather than one new SCCloudPlugin RPC per capability: capability names are plugin-local and the set grows with every new cross-plugin use case (sc-component-backup wants `mint-scoped-user`/`delete-scoped-user` on mongodb; a future monitor would want `mint-readonly-user`; a notifier would want `send-ses-message`, `send-sns-message`). Adding a new SCCloudPlugin RPC per capability churns the service surface; a single PluginInvoke with a `capability` string + opaque JSON keeps the proto stable and lets capabilities evolve plugin-side.

Shape kept opaque — the (target_plugin, capability) pair defines the payload/reply schema; those schemas are plugin-authored and documented in each plugin's README. SC core does not interpret the payload beyond routing.

func (*PluginInvokeRequest) Descriptor deprecated

func (*PluginInvokeRequest) Descriptor() ([]byte, []int)

Deprecated: Use PluginInvokeRequest.ProtoReflect.Descriptor instead.

func (*PluginInvokeRequest) GetCallingPlugin

func (x *PluginInvokeRequest) GetCallingPlugin() string

func (*PluginInvokeRequest) GetCapability

func (x *PluginInvokeRequest) GetCapability() string

func (*PluginInvokeRequest) GetHeader

func (x *PluginInvokeRequest) GetHeader() *RequestHeader

func (*PluginInvokeRequest) GetPayloadJson

func (x *PluginInvokeRequest) GetPayloadJson() []byte

func (*PluginInvokeRequest) ProtoMessage

func (*PluginInvokeRequest) ProtoMessage()

func (*PluginInvokeRequest) ProtoReflect

func (x *PluginInvokeRequest) ProtoReflect() protoreflect.Message

func (*PluginInvokeRequest) Reset

func (x *PluginInvokeRequest) Reset()

func (*PluginInvokeRequest) String

func (x *PluginInvokeRequest) String() string

type PluginInvokeResponse

type PluginInvokeResponse struct {

	// Opaque JSON reply — schema is capability-specific. Target
	// plugin marshals its typed reply struct here.
	ReplyJson []byte `protobuf:"bytes,1,opt,name=reply_json,json=replyJson,proto3" json:"reply_json,omitempty"`
	// contains filtered or unexported fields
}

func (*PluginInvokeResponse) Descriptor deprecated

func (*PluginInvokeResponse) Descriptor() ([]byte, []int)

Deprecated: Use PluginInvokeResponse.ProtoReflect.Descriptor instead.

func (*PluginInvokeResponse) GetReplyJson

func (x *PluginInvokeResponse) GetReplyJson() []byte

func (*PluginInvokeResponse) ProtoMessage

func (*PluginInvokeResponse) ProtoMessage()

func (*PluginInvokeResponse) ProtoReflect

func (x *PluginInvokeResponse) ProtoReflect() protoreflect.Message

func (*PluginInvokeResponse) Reset

func (x *PluginInvokeResponse) Reset()

func (*PluginInvokeResponse) String

func (x *PluginInvokeResponse) String() string

type PluginLogEvent

type PluginLogEvent struct {
	Severity LogSeverity `protobuf:"varint,1,opt,name=severity,proto3,enum=sc.plugin.v1.LogSeverity" json:"severity,omitempty"`
	// Free-form message. Pre-formatted — SC core does not re-interpret
	// format verbs. Operator-facing text, keep terse.
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// Unix epoch milliseconds the plugin produced the event at.
	TimestampMs int64 `protobuf:"varint,3,opt,name=timestamp_ms,json=timestampMs,proto3" json:"timestamp_ms,omitempty"`
	// Optional phase tag — a short label the plugin uses to group
	// sibling events (e.g. "provision", "destroy"). Not required.
	Phase string `protobuf:"bytes,4,opt,name=phase,proto3" json:"phase,omitempty"`
	// Optional trace id — set when SC core's RequestHeader carried one
	// so the two sides can be stitched.
	TraceId string `protobuf:"bytes,5,opt,name=trace_id,json=traceId,proto3" json:"trace_id,omitempty"`
	// contains filtered or unexported fields
}

func (*PluginLogEvent) Descriptor deprecated

func (*PluginLogEvent) Descriptor() ([]byte, []int)

Deprecated: Use PluginLogEvent.ProtoReflect.Descriptor instead.

func (*PluginLogEvent) GetMessage

func (x *PluginLogEvent) GetMessage() string

func (*PluginLogEvent) GetPhase

func (x *PluginLogEvent) GetPhase() string

func (*PluginLogEvent) GetSeverity

func (x *PluginLogEvent) GetSeverity() LogSeverity

func (*PluginLogEvent) GetTimestampMs

func (x *PluginLogEvent) GetTimestampMs() int64

func (*PluginLogEvent) GetTraceId

func (x *PluginLogEvent) GetTraceId() string

func (*PluginLogEvent) ProtoMessage

func (*PluginLogEvent) ProtoMessage()

func (*PluginLogEvent) ProtoReflect

func (x *PluginLogEvent) ProtoReflect() protoreflect.Message

func (*PluginLogEvent) Reset

func (x *PluginLogEvent) Reset()

func (*PluginLogEvent) String

func (x *PluginLogEvent) String() string

type PreDestroyRequest

type PreDestroyRequest struct {
	Header *RequestHeader `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	// The resource type the hook is advertised against (optional — a plugin
	// may install a generic hook across its surface).
	ResourceType string `protobuf:"bytes,2,opt,name=resource_type,json=resourceType,proto3" json:"resource_type,omitempty"`
	// The deploying stack's live outputs — map keyed by export name, value
	// is the JSON of auto.OutputValue (`{"value": …, "secret": bool}`).
	// mongodb's DropDatabaseHook consumes these to find per-service DB users
	// ("<service>-service-user" output keys) before destroying the cluster.
	// Added in Phase 1e; absent on older cores (older plugins see an empty
	// map and skip, same as today's fire-and-forget).
	StackOutputs map[string][]byte `` /* 171-byte string literal not displayed */
	// The deploying stack's per-env client descriptor — JSON of
	// api.StackClientDescriptor for `stack.Client.Stacks[params.Environment]`.
	// Carries the resource's config, cloudExtras, and anything else the hook
	// might want to switch on. Smaller than packing the whole api.Stack
	// (which carries every environment's config), targeted enough to extend
	// without breaking the wire. Added in Phase 1e.
	ClientDescriptorJson []byte `protobuf:"bytes,4,opt,name=client_descriptor_json,json=clientDescriptorJson,proto3" json:"client_descriptor_json,omitempty"`
	// The destroy call's parameters as JSON of api.DestroyParams. The hook
	// reads env name + dry-run flags off this. JSON because DestroyParams
	// embeds StackParams which carries map fields that evolve.
	DestroyParamsJson []byte `protobuf:"bytes,5,opt,name=destroy_params_json,json=destroyParamsJson,proto3" json:"destroy_params_json,omitempty"`
	// contains filtered or unexported fields
}

func (*PreDestroyRequest) Descriptor deprecated

func (*PreDestroyRequest) Descriptor() ([]byte, []int)

Deprecated: Use PreDestroyRequest.ProtoReflect.Descriptor instead.

func (*PreDestroyRequest) GetClientDescriptorJson

func (x *PreDestroyRequest) GetClientDescriptorJson() []byte

func (*PreDestroyRequest) GetDestroyParamsJson

func (x *PreDestroyRequest) GetDestroyParamsJson() []byte

func (*PreDestroyRequest) GetHeader

func (x *PreDestroyRequest) GetHeader() *RequestHeader

func (*PreDestroyRequest) GetResourceType

func (x *PreDestroyRequest) GetResourceType() string

func (*PreDestroyRequest) GetStackOutputs

func (x *PreDestroyRequest) GetStackOutputs() map[string][]byte

func (*PreDestroyRequest) ProtoMessage

func (*PreDestroyRequest) ProtoMessage()

func (*PreDestroyRequest) ProtoReflect

func (x *PreDestroyRequest) ProtoReflect() protoreflect.Message

func (*PreDestroyRequest) Reset

func (x *PreDestroyRequest) Reset()

func (*PreDestroyRequest) String

func (x *PreDestroyRequest) String() string

type PreDestroyResponse

type PreDestroyResponse struct {
	// contains filtered or unexported fields
}

func (*PreDestroyResponse) Descriptor deprecated

func (*PreDestroyResponse) Descriptor() ([]byte, []int)

Deprecated: Use PreDestroyResponse.ProtoReflect.Descriptor instead.

func (*PreDestroyResponse) ProtoMessage

func (*PreDestroyResponse) ProtoMessage()

func (*PreDestroyResponse) ProtoReflect

func (x *PreDestroyResponse) ProtoReflect() protoreflect.Message

func (*PreDestroyResponse) Reset

func (x *PreDestroyResponse) Reset()

func (*PreDestroyResponse) String

func (x *PreDestroyResponse) String() string

type PreProvisionRequest

type PreProvisionRequest struct {
	Header *RequestHeader `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	// Resource type + name being provisioned (mirrors ProvisionRequest).
	// The plugin uses these to key its template extensions so
	// `${resource:<resource_name>.<key>}` refers to this instance.
	ResourceType string `protobuf:"bytes,2,opt,name=resource_type,json=resourceType,proto3" json:"resource_type,omitempty"`
	ResourceName string `protobuf:"bytes,3,opt,name=resource_name,json=resourceName,proto3" json:"resource_name,omitempty"`
	// JSON of the component's merged `.Raw` map — the same payload
	// ProvisionRequest.component_raw carries, taken AFTER
	// ComponentDefaults merge + self-token + parent-token
	// interpolation. The plugin reads it to decide what lookups to
	// run (e.g. `deployTo: lambda` triggers AWS VPC lookup; other
	// deployTo values may be no-ops).
	ComponentRaw []byte `protobuf:"bytes,4,opt,name=component_raw,json=componentRaw,proto3" json:"component_raw,omitempty"`
	// ParentStack facts — same JSON shape as
	// ComputeProcessRequest.parent_info_json. The plugin uses this
	// to open sdk.NewStackReference for the parent stack when a
	// lookup needs parent-stack context (e.g. the ECS cluster ARN
	// the task should run on lives on the parent).
	ParentInfoJson []byte `protobuf:"bytes,5,opt,name=parent_info_json,json=parentInfoJson,proto3" json:"parent_info_json,omitempty"`
	// contains filtered or unexported fields
}

PreProvisionRequest fires on a Component resource (one whose type is in `component_resource_types`) BEFORE `dispatchComponentTemplate` runs the operator-chosen template's ProvisionFunc. Lets the plugin run cloud-SDK lookups in its own Pulumi context and return values SC core registers on the shared `pApi.ComputeContextCollector` — so a `${resource:<name>.<key>}` reference in the merged env map resolves to the plugin's looked-up value when `collector.ResolvePlaceholders` next walks the config (either the deploy-time pass at deploy.go:202 or an idempotent re-pass SC core runs after PreProvision inside the dispatch).

Why needed: the existing component dispatch runs `dispatchComponentTemplate` FIRST (plugin_sidecars.go:106) then the plugin's own `Provision` RPC with the dispatched template's URL on `DependencyOutputs`. That sequence leaves plugin-side lookups too late to inject into the Lambda's env map, which is set at Lambda-create time. PreProvision closes the ordering gap without requiring SC core to speak any cloud SDK.

Opt-in: plugins advertise via `SchemaResponse.supports_pre_provision = true`. Non-advertisers (and non-Component resources) skip the RPC entirely — zero wire cost.

func (*PreProvisionRequest) Descriptor deprecated

func (*PreProvisionRequest) Descriptor() ([]byte, []int)

Deprecated: Use PreProvisionRequest.ProtoReflect.Descriptor instead.

func (*PreProvisionRequest) GetComponentRaw

func (x *PreProvisionRequest) GetComponentRaw() []byte

func (*PreProvisionRequest) GetHeader

func (x *PreProvisionRequest) GetHeader() *RequestHeader

func (*PreProvisionRequest) GetParentInfoJson

func (x *PreProvisionRequest) GetParentInfoJson() []byte

func (*PreProvisionRequest) GetResourceName

func (x *PreProvisionRequest) GetResourceName() string

func (*PreProvisionRequest) GetResourceType

func (x *PreProvisionRequest) GetResourceType() string

func (*PreProvisionRequest) ProtoMessage

func (*PreProvisionRequest) ProtoMessage()

func (*PreProvisionRequest) ProtoReflect

func (x *PreProvisionRequest) ProtoReflect() protoreflect.Message

func (*PreProvisionRequest) Reset

func (x *PreProvisionRequest) Reset()

func (*PreProvisionRequest) String

func (x *PreProvisionRequest) String() string

type PreProvisionResponse

type PreProvisionResponse struct {

	// Template extension values SC core registers on the shared
	// collector via `AddResourceTplExtension` / `AddDependencyTplExtension`.
	// Same proto message ComputeProcessResponse uses; same semantics —
	// but the values are resolved in the plugin's Pulumi context
	// rather than during compute-processor dispatch, so cloud SDK
	// calls (e.g. ec2.LookupSubnets) are legal.
	TplExtensions []*TemplateExtension `protobuf:"bytes,1,rep,name=tpl_extensions,json=tplExtensions,proto3" json:"tpl_extensions,omitempty"`
	// Env variables the plugin wants injected on the dispatched
	// template, bypassing the `${resource:…}` placeholder step. Same
	// shape + sidecar handling as ComputeProcessResponse.env_vars.
	// Use case: a plugin that just wants to emit a fixed env var
	// whose value came from a cloud lookup — no placeholder machinery
	// involved. Merged via `AddEnvVariableIfNotExist` /
	// `AddSecretEnvVariableIfNotExist` (same precedence rules).
	EnvVars []*ComputeEnvVariable `protobuf:"bytes,2,rep,name=env_vars,json=envVars,proto3" json:"env_vars,omitempty"`
	// contains filtered or unexported fields
}

func (*PreProvisionResponse) Descriptor deprecated

func (*PreProvisionResponse) Descriptor() ([]byte, []int)

Deprecated: Use PreProvisionResponse.ProtoReflect.Descriptor instead.

func (*PreProvisionResponse) GetEnvVars

func (x *PreProvisionResponse) GetEnvVars() []*ComputeEnvVariable

func (*PreProvisionResponse) GetTplExtensions

func (x *PreProvisionResponse) GetTplExtensions() []*TemplateExtension

func (*PreProvisionResponse) ProtoMessage

func (*PreProvisionResponse) ProtoMessage()

func (*PreProvisionResponse) ProtoReflect

func (x *PreProvisionResponse) ProtoReflect() protoreflect.Message

func (*PreProvisionResponse) Reset

func (x *PreProvisionResponse) Reset()

func (*PreProvisionResponse) String

func (x *PreProvisionResponse) String() string

type ProviderRequest

type ProviderRequest struct {
	Header               *RequestHeader         `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	ProviderType         string                 `protobuf:"bytes,2,opt,name=provider_type,json=providerType,proto3" json:"provider_type,omitempty"`                           // from SchemaResponse.provider_types
	ProviderResourceName string                 `protobuf:"bytes,3,opt,name=provider_resource_name,json=providerResourceName,proto3" json:"provider_resource_name,omitempty"` // deterministic — provision.go:320's template
	Inputs               map[string]*InputValue ``                                                                                                                            // provider auth + config
	/* 139-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*ProviderRequest) Descriptor deprecated

func (*ProviderRequest) Descriptor() ([]byte, []int)

Deprecated: Use ProviderRequest.ProtoReflect.Descriptor instead.

func (*ProviderRequest) GetHeader

func (x *ProviderRequest) GetHeader() *RequestHeader

func (*ProviderRequest) GetInputs

func (x *ProviderRequest) GetInputs() map[string]*InputValue

func (*ProviderRequest) GetProviderResourceName

func (x *ProviderRequest) GetProviderResourceName() string

func (*ProviderRequest) GetProviderType

func (x *ProviderRequest) GetProviderType() string

func (*ProviderRequest) ProtoMessage

func (*ProviderRequest) ProtoMessage()

func (*ProviderRequest) ProtoReflect

func (x *ProviderRequest) ProtoReflect() protoreflect.Message

func (*ProviderRequest) Reset

func (x *ProviderRequest) Reset()

func (*ProviderRequest) String

func (x *ProviderRequest) String() string

type ProviderResponse

type ProviderResponse struct {

	// The URN of the pulumi:providers:<pkg> resource the plugin registered.
	// Byte-identical to pre-split state's URN for stacks that already have one.
	ProviderUrn string `protobuf:"bytes,1,opt,name=provider_urn,json=providerUrn,proto3" json:"provider_urn,omitempty"`
	// contains filtered or unexported fields
}

func (*ProviderResponse) Descriptor deprecated

func (*ProviderResponse) Descriptor() ([]byte, []int)

Deprecated: Use ProviderResponse.ProtoReflect.Descriptor instead.

func (*ProviderResponse) GetProviderUrn

func (x *ProviderResponse) GetProviderUrn() string

func (*ProviderResponse) ProtoMessage

func (*ProviderResponse) ProtoMessage()

func (*ProviderResponse) ProtoReflect

func (x *ProviderResponse) ProtoReflect() protoreflect.Message

func (*ProviderResponse) Reset

func (x *ProviderResponse) Reset()

func (*ProviderResponse) String

func (x *ProviderResponse) String() string

type ProvisionDomainForEndpointRequest

type ProvisionDomainForEndpointRequest struct {
	Header        *RequestHeader `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	RegistrarType string         `protobuf:"bytes,2,opt,name=registrar_type,json=registrarType,proto3" json:"registrar_type,omitempty"`
	StackName     string         `protobuf:"bytes,3,opt,name=stack_name,json=stackName,proto3" json:"stack_name,omitempty"`
	// DomainEndpoint fields:
	EndpointName       string `protobuf:"bytes,4,opt,name=endpoint_name,json=endpointName,proto3" json:"endpoint_name,omitempty"`
	Domain             string `protobuf:"bytes,5,opt,name=domain,proto3" json:"domain,omitempty"`
	TargetHostResolved string `protobuf:"bytes,6,opt,name=target_host_resolved,json=targetHostResolved,proto3" json:"target_host_resolved,omitempty"` // sdk.StringInput resolved by SC core
	Websocket          bool   `protobuf:"varint,7,opt,name=websocket,proto3" json:"websocket,omitempty"`
	// contains filtered or unexported fields
}

func (*ProvisionDomainForEndpointRequest) Descriptor deprecated

func (*ProvisionDomainForEndpointRequest) Descriptor() ([]byte, []int)

Deprecated: Use ProvisionDomainForEndpointRequest.ProtoReflect.Descriptor instead.

func (*ProvisionDomainForEndpointRequest) GetDomain

func (*ProvisionDomainForEndpointRequest) GetEndpointName

func (x *ProvisionDomainForEndpointRequest) GetEndpointName() string

func (*ProvisionDomainForEndpointRequest) GetHeader

func (*ProvisionDomainForEndpointRequest) GetRegistrarType

func (x *ProvisionDomainForEndpointRequest) GetRegistrarType() string

func (*ProvisionDomainForEndpointRequest) GetStackName

func (x *ProvisionDomainForEndpointRequest) GetStackName() string

func (*ProvisionDomainForEndpointRequest) GetTargetHostResolved

func (x *ProvisionDomainForEndpointRequest) GetTargetHostResolved() string

func (*ProvisionDomainForEndpointRequest) GetWebsocket

func (x *ProvisionDomainForEndpointRequest) GetWebsocket() bool

func (*ProvisionDomainForEndpointRequest) ProtoMessage

func (*ProvisionDomainForEndpointRequest) ProtoMessage()

func (*ProvisionDomainForEndpointRequest) ProtoReflect

func (*ProvisionDomainForEndpointRequest) Reset

func (*ProvisionDomainForEndpointRequest) String

type ProvisionDomainForEndpointResponse

type ProvisionDomainForEndpointResponse struct {
	Urn string `protobuf:"bytes,1,opt,name=urn,proto3" json:"urn,omitempty"`
	// contains filtered or unexported fields
}

func (*ProvisionDomainForEndpointResponse) Descriptor deprecated

func (*ProvisionDomainForEndpointResponse) Descriptor() ([]byte, []int)

Deprecated: Use ProvisionDomainForEndpointResponse.ProtoReflect.Descriptor instead.

func (*ProvisionDomainForEndpointResponse) GetUrn

func (*ProvisionDomainForEndpointResponse) ProtoMessage

func (*ProvisionDomainForEndpointResponse) ProtoMessage()

func (*ProvisionDomainForEndpointResponse) ProtoReflect

func (*ProvisionDomainForEndpointResponse) Reset

func (*ProvisionDomainForEndpointResponse) String

type ProvisionRegistrarRequest

type ProvisionRegistrarRequest struct {
	Header        *RequestHeader         `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	RegistrarType string                 `protobuf:"bytes,2,opt,name=registrar_type,json=registrarType,proto3" json:"registrar_type,omitempty"` // from SchemaResponse.registrar_types
	Config        map[string]*InputValue ``                                                                                                     // registrar config (zone name, api token, account id, …)
	/* 139-byte string literal not displayed */
	// The DEPLOYING STACK's preferred base DNS zone (client.yaml `baseDnsZone`),
	// empty when the stack states no preference. Mirrors pulumi/api.DnsPreference,
	// which SC core already hands to every in-tree registrar via
	// ProvisionParams.DnsPreference (registrars.go multiRegistrar.build).
	//
	// This field is NOT redundant with the zone name in `config`. A registrar's
	// configured zone is only a DEFAULT: the fleet's parent server.yaml declares
	// one catch-all Cloudflare registrar (`default: true`) that authenticates
	// against a whole account and is expected to look up whichever zone the
	// deploying stack names. Without this field a plugin registrar cannot see
	// that name, falls back to its own configured zone, and writes the record
	// into the WRONG zone — which Pulumi sees as an input diff on zone_id,
	// forcing a create-before-delete replace that DELETES the live record while
	// reporting a green deploy. Stable URNs do not protect against this.
	BaseDnsZone string `protobuf:"bytes,4,opt,name=base_dns_zone,json=baseDnsZone,proto3" json:"base_dns_zone,omitempty"`
	// contains filtered or unexported fields
}

func (*ProvisionRegistrarRequest) Descriptor deprecated

func (*ProvisionRegistrarRequest) Descriptor() ([]byte, []int)

Deprecated: Use ProvisionRegistrarRequest.ProtoReflect.Descriptor instead.

func (*ProvisionRegistrarRequest) GetBaseDnsZone

func (x *ProvisionRegistrarRequest) GetBaseDnsZone() string

func (*ProvisionRegistrarRequest) GetConfig

func (x *ProvisionRegistrarRequest) GetConfig() map[string]*InputValue

func (*ProvisionRegistrarRequest) GetHeader

func (x *ProvisionRegistrarRequest) GetHeader() *RequestHeader

func (*ProvisionRegistrarRequest) GetRegistrarType

func (x *ProvisionRegistrarRequest) GetRegistrarType() string

func (*ProvisionRegistrarRequest) ProtoMessage

func (*ProvisionRegistrarRequest) ProtoMessage()

func (*ProvisionRegistrarRequest) ProtoReflect

func (*ProvisionRegistrarRequest) Reset

func (x *ProvisionRegistrarRequest) Reset()

func (*ProvisionRegistrarRequest) String

func (x *ProvisionRegistrarRequest) String() string

type ProvisionRegistrarResponse

type ProvisionRegistrarResponse struct {

	// The registrar's "main domain" — typically the zone name. SC core caches
	// this on the per-stack registrar handle.
	MainDomain string `protobuf:"bytes,1,opt,name=main_domain,json=mainDomain,proto3" json:"main_domain,omitempty"`
	// URNs of any resources the plugin registered up-front (e.g. a provider
	// or a looked-up zone data source). Optional.
	RegisteredUrns []string `protobuf:"bytes,2,rep,name=registered_urns,json=registeredUrns,proto3" json:"registered_urns,omitempty"`
	// contains filtered or unexported fields
}

func (*ProvisionRegistrarResponse) Descriptor deprecated

func (*ProvisionRegistrarResponse) Descriptor() ([]byte, []int)

Deprecated: Use ProvisionRegistrarResponse.ProtoReflect.Descriptor instead.

func (*ProvisionRegistrarResponse) GetMainDomain

func (x *ProvisionRegistrarResponse) GetMainDomain() string

func (*ProvisionRegistrarResponse) GetRegisteredUrns

func (x *ProvisionRegistrarResponse) GetRegisteredUrns() []string

func (*ProvisionRegistrarResponse) ProtoMessage

func (*ProvisionRegistrarResponse) ProtoMessage()

func (*ProvisionRegistrarResponse) ProtoReflect

func (*ProvisionRegistrarResponse) Reset

func (x *ProvisionRegistrarResponse) Reset()

func (*ProvisionRegistrarResponse) String

func (x *ProvisionRegistrarResponse) String() string

type ProvisionRequest

type ProvisionRequest struct {
	Header       *RequestHeader         `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	ResourceType string                 `protobuf:"bytes,2,opt,name=resource_type,json=resourceType,proto3" json:"resource_type,omitempty"` // from SchemaResponse.resource_types
	ResourceName string                 `protobuf:"bytes,3,opt,name=resource_name,json=resourceName,proto3" json:"resource_name,omitempty"` // the pre-split-compatible name (see 04 §1.2)
	Inputs       map[string]*InputValue ``                                                                                                  // resource-specific inputs
	/* 139-byte string literal not displayed */
	DependencyOutputs map[string]string `` // outputs from previously provisioned deps
	/* 186-byte string literal not displayed */
	ParentUrn string `protobuf:"bytes,6,opt,name=parent_urn,json=parentUrn,proto3" json:"parent_urn,omitempty"` // parent ComponentResource URN, if any
	// The consuming stack's compute context: the env vars its `uses:` resources
	// contributed (what an in-tree template reads from
	// pApi.ProvisionParams.ComputeContext). Set only for a compute template (a
	// client stack's deploy, e.g. yc-serverless-container); empty for a plain
	// resource. Same message ComputeProcessResponse.env_vars uses, so a var
	// crosses the bus in either direction with its stack/resource metadata.
	// Older plugins ignore the field.
	ComputeEnvVars []*ComputeEnvVariable `protobuf:"bytes,7,rep,name=compute_env_vars,json=computeEnvVars,proto3" json:"compute_env_vars,omitempty"`
	// Active registrar for the deploying stack, so a plugin whose
	// Provision needs DNS registration can proxy the call back to the
	// registrar plugin via SCCore.PeerInvoke (D8). SC core fills these
	// in the Provision sidecar — see pkg/clouds/pulumi/plugin_sidecars.go
	// makeResourceSidecar. Empty when the deploying stack has no
	// registrar (preview-only / scratch stacks); a plugin that assumes
	// one is present must handle the empty case with a clear error.
	RegistrarPluginName string `protobuf:"bytes,8,opt,name=registrar_plugin_name,json=registrarPluginName,proto3" json:"registrar_plugin_name,omitempty"`  // e.g. "cloudflare"
	RegistrarType       string `protobuf:"bytes,9,opt,name=registrar_type,json=registrarType,proto3" json:"registrar_type,omitempty"`                      // the registrar type token (e.g. "cloudflare")
	RegistrarMainDomain string `protobuf:"bytes,10,opt,name=registrar_main_domain,json=registrarMainDomain,proto3" json:"registrar_main_domain,omitempty"` // MainDomain() value — pApi.Registrar's base zone
	// ParentInfo blob for a template Provision that reads outputs from a
	// parent stack — kubeconfig/registry-url on `gcp-gke-autopilot`, zone
	// creds on `aws-static-website`, ANY template whose provisioning
	// body reaches into `params.ParentStack.FullReference`. Same shape as
	// ComputeProcessRequest.parent_info_json (:391): JSON-marshalled
	// `pApi.ParentInfo`, decoded by `runtime.ParentInfoFromProvisionRequest`
	// on the plugin side and set on `ProvisionParams.ParentStack` before
	// the plugin internal body runs.
	//
	// Older plugins ignore the field and get a nil ParentStack — same as
	// today's silent-drop, but now DOCUMENTED as the fallback. Templates
	// that nil-deref on `params.ParentStack.X` SIGSEGV loudly; every
	// template body that reads the field must nil-check and error with a
	// sentence. See
	// forge/docs/roadmap/items/sc-plugin-provisionrequest-missing-parent-info.md
	// for the two-guardrails-ship-together framing.
	ParentInfoJson []byte `protobuf:"bytes,11,opt,name=parent_info_json,json=parentInfoJson,proto3" json:"parent_info_json,omitempty"`
	// Dependency outputs for a resource whose config implements
	// `api.WithParentDependencies`: the values its sibling resources (provisioned
	// earlier in the same stack) published, keyed by sibling resource name. Each
	// value is a JSON-marshalled `api.PluginResourceOutput` with `PluginName`,
	// `Urn`, and the per-key `Outputs` map (the same values that get re-exported
	// onto the parent stack root — see api PR #569 for why the per-value secret
	// flag travels with each output).
	//
	// Populated in `pkg/clouds/pulumi/plugin_sidecars.go`'s
	// `makeResourceSidecar` from `params.ResourceOutputs`, decoded on the plugin
	// side by `runtime.DependencyOutputsFromProvisionRequest` into
	// `map[string]*api.ResourceOutput` with `Ref: &api.PluginResourceOutput`.
	//
	// The flat `dependency_outputs = 5` field was declared on the proto but never
	// wired by any sidecar (its string-only shape couldn't carry the per-value
	// secret flag or the nested map structure a sibling consumer needs). This
	// JSON blob carries the richer shape instead; the flat field is left in place
	// for wire-compat and may be reused for simpler use-cases later.
	//
	// Older plugins ignore the field: the fallback is an empty
	// `params.ResourceOutputs` map, which is the same silent-drop shape that
	// broke `gcp-docker-image-push` (reading
	// `params.ResourceOutputs[registryResource].Ref` as `*ArtifactRegistryOut`
	// and erroring with `expected registry resource %q to be present in
	// outputs`). See
	// forge/docs/roadmap/items/sc-plugin-dependency-outputs-not-populated.md.
	DependencyOutputsJson []byte `` /* 127-byte string literal not displayed */
	// JSON of the component's `.Raw` map when SC core dispatches this
	// resource via a Component plugin's `deployTo:` sidecar pre-step
	// (slice 1a.1 of sc-components-platform; operator path (b) in design
	// doc §#19). Carries operator-declared `image`/`env`/`ingress`/
	// `signingKey`/etc. so the dispatched template's ProvisionFunc can
	// overlay them on its typed input struct before building the cloud
	// resource. nil/empty when the resource is NOT dispatched via a
	// Component plugin — every non-component Provision call sees this
	// unset.
	//
	// Opt-in advertise via `SchemaResponse.supports_component`; absent
	// advertise + non-empty `component_raw` is a plugin-side panic the
	// operator sees on first smoke (per §#19's path-(b) foot-gun).
	// Mitigation: parse-time validator refuses dispatch when
	// `SupportsComponent` set is empty for the deployTo template's type,
	// so this field only arrives at plugins that already opted in.
	//
	// Older plugin binaries that pre-date this field see no change —
	// the field is unset, decoders skip it, and the Provision RPC
	// behaves as it did before slice 1a.1. Additive by construction;
	// mechanism documented at forge/docs/design/2026-11-10/
	// sc-components-platform/README.md §#19 + the generic
	// `interface_assertion_against_plugin_owned_value_fails_in_prod`
	// memory (cross-ref: why core can't overlay plugin-typed fields
	// itself and must hand the raw map to the plugin).
	ComponentRaw []byte `protobuf:"bytes,13,opt,name=component_raw,json=componentRaw,proto3" json:"component_raw,omitempty"`
	// JSON of the client-level configuration a template's image build reads,
	// which the plugin cannot rebuild from the request: the client.yaml
	// `security:` block (image scan, signing, SBOM, provenance) and `imageBuild:`
	// (reuseExistingCommitTag). In-tree, the template received the whole
	// api.Stack and docker.BuildAndPushImage read stack.Client.Security off it;
	// a plugin builds its api.Stack from the request header alone, so without
	// this field a plugin-owned template deploys every image unsigned, unscanned
	// and without an SBOM, with a green deploy.
	//
	// Shape: api.PluginClientConfig. Empty when the client descriptor sets
	// neither (a parent-stack resource has no client descriptor at all). Older
	// plugins ignore the field, which is the behaviour before it existed.
	ClientConfigJson []byte `protobuf:"bytes,14,opt,name=client_config_json,json=clientConfigJson,proto3" json:"client_config_json,omitempty"`
	// contains filtered or unexported fields
}

func (*ProvisionRequest) Descriptor deprecated

func (*ProvisionRequest) Descriptor() ([]byte, []int)

Deprecated: Use ProvisionRequest.ProtoReflect.Descriptor instead.

func (*ProvisionRequest) GetClientConfigJson

func (x *ProvisionRequest) GetClientConfigJson() []byte

func (*ProvisionRequest) GetComponentRaw

func (x *ProvisionRequest) GetComponentRaw() []byte

func (*ProvisionRequest) GetComputeEnvVars

func (x *ProvisionRequest) GetComputeEnvVars() []*ComputeEnvVariable

func (*ProvisionRequest) GetDependencyOutputs

func (x *ProvisionRequest) GetDependencyOutputs() map[string]string

func (*ProvisionRequest) GetDependencyOutputsJson

func (x *ProvisionRequest) GetDependencyOutputsJson() []byte

func (*ProvisionRequest) GetHeader

func (x *ProvisionRequest) GetHeader() *RequestHeader

func (*ProvisionRequest) GetInputs

func (x *ProvisionRequest) GetInputs() map[string]*InputValue

func (*ProvisionRequest) GetParentInfoJson

func (x *ProvisionRequest) GetParentInfoJson() []byte

func (*ProvisionRequest) GetParentUrn

func (x *ProvisionRequest) GetParentUrn() string

func (*ProvisionRequest) GetRegistrarMainDomain

func (x *ProvisionRequest) GetRegistrarMainDomain() string

func (*ProvisionRequest) GetRegistrarPluginName

func (x *ProvisionRequest) GetRegistrarPluginName() string

func (*ProvisionRequest) GetRegistrarType

func (x *ProvisionRequest) GetRegistrarType() string

func (*ProvisionRequest) GetResourceName

func (x *ProvisionRequest) GetResourceName() string

func (*ProvisionRequest) GetResourceType

func (x *ProvisionRequest) GetResourceType() string

func (*ProvisionRequest) ProtoMessage

func (*ProvisionRequest) ProtoMessage()

func (*ProvisionRequest) ProtoReflect

func (x *ProvisionRequest) ProtoReflect() protoreflect.Message

func (*ProvisionRequest) Reset

func (x *ProvisionRequest) Reset()

func (*ProvisionRequest) String

func (x *ProvisionRequest) String() string

type ProvisionResponse

type ProvisionResponse struct {

	// The URN of the created resource. Must be byte-identical to the pre-split URN
	// for stacks migrated from pre-split SC — see 04 §4 fixture gate.
	Urn string `protobuf:"bytes,1,opt,name=urn,proto3" json:"urn,omitempty"`
	// Resource outputs the SC core compute processor consumes. Field names are the
	// SC-level logical outputs the resource exposes (e.g. "endpoint", "arn", "id").
	Outputs map[string]*InputValue `` /* 141-byte string literal not displayed */
	// Env variables this resource injects into downstream compute (keyed by env var name).
	Env map[string]*InputValue `` /* 133-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*ProvisionResponse) Descriptor deprecated

func (*ProvisionResponse) Descriptor() ([]byte, []int)

Deprecated: Use ProvisionResponse.ProtoReflect.Descriptor instead.

func (*ProvisionResponse) GetEnv

func (x *ProvisionResponse) GetEnv() map[string]*InputValue

func (*ProvisionResponse) GetOutputs

func (x *ProvisionResponse) GetOutputs() map[string]*InputValue

func (*ProvisionResponse) GetUrn

func (x *ProvisionResponse) GetUrn() string

func (*ProvisionResponse) ProtoMessage

func (*ProvisionResponse) ProtoMessage()

func (*ProvisionResponse) ProtoReflect

func (x *ProvisionResponse) ProtoReflect() protoreflect.Message

func (*ProvisionResponse) Reset

func (x *ProvisionResponse) Reset()

func (*ProvisionResponse) String

func (x *ProvisionResponse) String() string

type PulumiPluginRequirement

type PulumiPluginRequirement struct {
	Package           string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`                                                // e.g. "aws"
	Version           string `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`                                                // e.g. "6.17.0"
	PluginDownloadUrl string `protobuf:"bytes,3,opt,name=plugin_download_url,json=pluginDownloadUrl,proto3" json:"plugin_download_url,omitempty"` // empty for official Pulumi registry providers
	// contains filtered or unexported fields
}

func (*PulumiPluginRequirement) Descriptor deprecated

func (*PulumiPluginRequirement) Descriptor() ([]byte, []int)

Deprecated: Use PulumiPluginRequirement.ProtoReflect.Descriptor instead.

func (*PulumiPluginRequirement) GetPackage

func (x *PulumiPluginRequirement) GetPackage() string

func (*PulumiPluginRequirement) GetPluginDownloadUrl

func (x *PulumiPluginRequirement) GetPluginDownloadUrl() string

func (*PulumiPluginRequirement) GetVersion

func (x *PulumiPluginRequirement) GetVersion() string

func (*PulumiPluginRequirement) ProtoMessage

func (*PulumiPluginRequirement) ProtoMessage()

func (*PulumiPluginRequirement) ProtoReflect

func (x *PulumiPluginRequirement) ProtoReflect() protoreflect.Message

func (*PulumiPluginRequirement) Reset

func (x *PulumiPluginRequirement) Reset()

func (*PulumiPluginRequirement) String

func (x *PulumiPluginRequirement) String() string

type RequestHeader

type RequestHeader struct {

	// The address of SC core's Pulumi Resource Monitor. Protocol per
	// pulumi/sdk/v3/go/common/resource/plugin's RunInfo.MonitorAddress — typically a
	// unix:// or passthrough://<host:port> URL. The plugin dials this to call
	// RegisterResource against the SAME engine SC core is using.
	MonitorAddress string `protobuf:"bytes,1,opt,name=monitor_address,json=monitorAddress,proto3" json:"monitor_address,omitempty"`
	// The address of SC core's engine endpoint — the diagnostic / log sink the plugin
	// should post Pulumi-visible events to. Pulumi's RunInfo.EngineAddress.
	EngineAddress string `protobuf:"bytes,2,opt,name=engine_address,json=engineAddress,proto3" json:"engine_address,omitempty"`
	StackName     string `protobuf:"bytes,3,opt,name=stack_name,json=stackName,proto3" json:"stack_name,omitempty"`
	ProjectName   string `protobuf:"bytes,4,opt,name=project_name,json=projectName,proto3" json:"project_name,omitempty"`
	Environment   string `protobuf:"bytes,5,opt,name=environment,proto3" json:"environment,omitempty"`
	// Short-lived scoped token (Vault pattern). Plugin presents this on callback RPCs
	// (ResolveCredential, ResolveSecret). HS256-signed by SC core's ephemeral key.
	RunToken string `protobuf:"bytes,6,opt,name=run_token,json=runToken,proto3" json:"run_token,omitempty"`
	// Trace / correlation id for log stitching.
	TraceId string `protobuf:"bytes,7,opt,name=trace_id,json=traceId,proto3" json:"trace_id,omitempty"`
	// Explicit providers SC core has already registered against the monitor, keyed by
	// "<pkg>::<provider-resource-name>" (e.g. "aws::my-stack--s3-bucket--my-bucket--prod--provider").
	// Values are full Pulumi provider URNs the plugin passes to RegisterResource via
	// ResourceOptions.Provider. These names are byte-identical to the pre-split
	// state's provider URNs, which is how the no-destroy invariant holds —
	// see 04-no-destroy-invariant.md §3.
	ProviderUrns map[string]string `` /* 171-byte string literal not displayed */
	// SCCore callback broker stream id — the hashicorp/go-plugin
	// GRPCBroker ID the plugin dials to reach SC core's SCCore service
	// (ResolveSecret, ResolveCredential, PeerInvoke). Zero means SC core
	// does not expose a callback endpoint (older cores, or test harnesses
	// that spawn plugins without a broker); the plugin must then skip any
	// SCCore RPC. Added in Phase 1e for D8 (PeerInvoke).
	//
	// Deprecated in favour of sccore_address below: the broker's host→plugin
	// ConnInfo delivery races the plugin's first Dial even when host-side
	// Accept is synchronous (observed on sc-plugin-aws / forge-notifier
	// staging preview, 2026-10-30). A plain TCP endpoint is simpler and
	// deterministic. Kept wire-compatible.
	SccoreBrokerStream uint32 `protobuf:"varint,9,opt,name=sccore_broker_stream,json=sccoreBrokerStream,proto3" json:"sccore_broker_stream,omitempty"`
	// SCCore callback endpoint SC core serves this plugin's PeerInvoke /
	// ResolveSecret / ResolveCredential RPCs on. "host:port" over local
	// TCP (loopback-only). Empty when SC core does not expose a callback
	// (older core, test harnesses). Prefer this over sccore_broker_stream.
	SccoreAddress string `protobuf:"bytes,11,opt,name=sccore_address,json=sccoreAddress,proto3" json:"sccore_address,omitempty"`
	// The CLI `--stack` value (parent-stack name — e.g. "forge-notifier"), as
	// distinct from `stack_name` which carries the childStack name
	// ("forge-notifier--staging"). In-tree drivers received stack.Name = CHILD
	// (via `stack` arg) AND deployParams.StackName = PARENT (via
	// `input.StackParams.StackName`). Both are used, and they shape different
	// URNs: a Lambda function/ECR repo named off `stack.Name` CHILD prefix; a
	// secrets-manager Secret named via `toSecretName(deployParams, …)` PARENT
	// prefix. #516 flipped `stack_name` from PARENT to CHILD to fix ECR/Lambda
	// URNs; the plugin needs this PARENT value to keep `toSecretName` matching
	// state and not plan a destroy of every per-env secret.
	//
	// When empty (older SC core), plugins should fall back to `stack_name`.
	CliStackName string `protobuf:"bytes,12,opt,name=cli_stack_name,json=cliStackName,proto3" json:"cli_stack_name,omitempty"`
	// True if the current Pulumi update is a preview (dry-run). Plugins MUST
	// thread this value into `sdk.RunInfo.DryRun` when building their own
	// `sdk.Context` so `pctx.DryRun()` answers truthfully. Without it a plugin's
	// `pctx.DryRun()` is always false and every preview-skip guard misfires —
	// live-caught 2026-10-31 against sc-plugin-cloudflare's Pages uploader:
	// `if ctx.DryRun()` failed to skip the upload-token request in preview, the
	// PagesProject didn't exist yet, and the request hung 30 min until the GH
	// Actions job timed out. The field is explicit on the wire rather than
	// inferred from ctx because `sdk.RunInfo.DryRun` has to be set at
	// `sdk.NewContext(ctx, …)` time — the plugin can't recover the flag from
	// the monitor address alone.
	//
	// When unset (older SC core), plugins should treat as false — same behaviour
	// they had before this field existed, so preview-skip guards keep misfiring
	// against old cores but the plugin itself does not break.
	DryRun bool `protobuf:"varint,13,opt,name=dry_run,json=dryRun,proto3" json:"dry_run,omitempty"`
	// contains filtered or unexported fields
}

RequestHeader rides every plugin-bus RPC. It carries the plumbing a plugin needs to participate in the one Pulumi deployment SC core owns.

func (*RequestHeader) Descriptor deprecated

func (*RequestHeader) Descriptor() ([]byte, []int)

Deprecated: Use RequestHeader.ProtoReflect.Descriptor instead.

func (*RequestHeader) GetCliStackName

func (x *RequestHeader) GetCliStackName() string

func (*RequestHeader) GetDryRun

func (x *RequestHeader) GetDryRun() bool

func (*RequestHeader) GetEngineAddress

func (x *RequestHeader) GetEngineAddress() string

func (*RequestHeader) GetEnvironment

func (x *RequestHeader) GetEnvironment() string

func (*RequestHeader) GetMonitorAddress

func (x *RequestHeader) GetMonitorAddress() string

func (*RequestHeader) GetProjectName

func (x *RequestHeader) GetProjectName() string

func (*RequestHeader) GetProviderUrns

func (x *RequestHeader) GetProviderUrns() map[string]string

func (*RequestHeader) GetRunToken

func (x *RequestHeader) GetRunToken() string

func (*RequestHeader) GetSccoreAddress

func (x *RequestHeader) GetSccoreAddress() string

func (*RequestHeader) GetSccoreBrokerStream

func (x *RequestHeader) GetSccoreBrokerStream() uint32

func (*RequestHeader) GetStackName

func (x *RequestHeader) GetStackName() string

func (*RequestHeader) GetTraceId

func (x *RequestHeader) GetTraceId() string

func (*RequestHeader) ProtoMessage

func (*RequestHeader) ProtoMessage()

func (*RequestHeader) ProtoReflect

func (x *RequestHeader) ProtoReflect() protoreflect.Message

func (*RequestHeader) Reset

func (x *RequestHeader) Reset()

func (*RequestHeader) String

func (x *RequestHeader) String() string

type ResolveCredentialRequest

type ResolveCredentialRequest struct {
	RunToken       string `protobuf:"bytes,1,opt,name=run_token,json=runToken,proto3" json:"run_token,omitempty"`
	CredentialName string `protobuf:"bytes,2,opt,name=credential_name,json=credentialName,proto3" json:"credential_name,omitempty"` // e.g. "aws-access-key-id"
	// contains filtered or unexported fields
}

func (*ResolveCredentialRequest) Descriptor deprecated

func (*ResolveCredentialRequest) Descriptor() ([]byte, []int)

Deprecated: Use ResolveCredentialRequest.ProtoReflect.Descriptor instead.

func (*ResolveCredentialRequest) GetCredentialName

func (x *ResolveCredentialRequest) GetCredentialName() string

func (*ResolveCredentialRequest) GetRunToken

func (x *ResolveCredentialRequest) GetRunToken() string

func (*ResolveCredentialRequest) ProtoMessage

func (*ResolveCredentialRequest) ProtoMessage()

func (*ResolveCredentialRequest) ProtoReflect

func (x *ResolveCredentialRequest) ProtoReflect() protoreflect.Message

func (*ResolveCredentialRequest) Reset

func (x *ResolveCredentialRequest) Reset()

func (*ResolveCredentialRequest) String

func (x *ResolveCredentialRequest) String() string

type ResolveCredentialResponse

type ResolveCredentialResponse struct {
	Value string `protobuf:"bytes,1,opt,name=value,proto3" json:"value,omitempty"`
	// contains filtered or unexported fields
}

func (*ResolveCredentialResponse) Descriptor deprecated

func (*ResolveCredentialResponse) Descriptor() ([]byte, []int)

Deprecated: Use ResolveCredentialResponse.ProtoReflect.Descriptor instead.

func (*ResolveCredentialResponse) GetValue

func (x *ResolveCredentialResponse) GetValue() string

func (*ResolveCredentialResponse) ProtoMessage

func (*ResolveCredentialResponse) ProtoMessage()

func (*ResolveCredentialResponse) ProtoReflect

func (*ResolveCredentialResponse) Reset

func (x *ResolveCredentialResponse) Reset()

func (*ResolveCredentialResponse) String

func (x *ResolveCredentialResponse) String() string

type ResolveSecretRequest

type ResolveSecretRequest struct {
	RunToken  string `protobuf:"bytes,1,opt,name=run_token,json=runToken,proto3" json:"run_token,omitempty"`    // same JWT SC core handed the plugin at spawn
	SecretRef string `protobuf:"bytes,2,opt,name=secret_ref,json=secretRef,proto3" json:"secret_ref,omitempty"` // the opaque ref from InputValue
	// contains filtered or unexported fields
}

func (*ResolveSecretRequest) Descriptor deprecated

func (*ResolveSecretRequest) Descriptor() ([]byte, []int)

Deprecated: Use ResolveSecretRequest.ProtoReflect.Descriptor instead.

func (*ResolveSecretRequest) GetRunToken

func (x *ResolveSecretRequest) GetRunToken() string

func (*ResolveSecretRequest) GetSecretRef

func (x *ResolveSecretRequest) GetSecretRef() string

func (*ResolveSecretRequest) ProtoMessage

func (*ResolveSecretRequest) ProtoMessage()

func (*ResolveSecretRequest) ProtoReflect

func (x *ResolveSecretRequest) ProtoReflect() protoreflect.Message

func (*ResolveSecretRequest) Reset

func (x *ResolveSecretRequest) Reset()

func (*ResolveSecretRequest) String

func (x *ResolveSecretRequest) String() string

type ResolveSecretResponse

type ResolveSecretResponse struct {

	// Cleartext secret value. Only transmitted over the local, mTLS go-plugin channel.
	// Never log this.
	Value string `protobuf:"bytes,1,opt,name=value,proto3" json:"value,omitempty"`
	// contains filtered or unexported fields
}

func (*ResolveSecretResponse) Descriptor deprecated

func (*ResolveSecretResponse) Descriptor() ([]byte, []int)

Deprecated: Use ResolveSecretResponse.ProtoReflect.Descriptor instead.

func (*ResolveSecretResponse) GetValue

func (x *ResolveSecretResponse) GetValue() string

func (*ResolveSecretResponse) ProtoMessage

func (*ResolveSecretResponse) ProtoMessage()

func (*ResolveSecretResponse) ProtoReflect

func (x *ResolveSecretResponse) ProtoReflect() protoreflect.Message

func (*ResolveSecretResponse) Reset

func (x *ResolveSecretResponse) Reset()

func (*ResolveSecretResponse) String

func (x *ResolveSecretResponse) String() string

type ResourcePropertyRef

type ResourcePropertyRef struct {

	// A URN the plugin has ALREADY AWAITED.
	//
	// Not a formality: the engine can only answer for a resource whose step has
	// completed, and awaiting the URN is exactly what waits for that. A plugin that
	// returns a URN it never awaited has reintroduced the bug Addendum H is about,
	// and the symptom is a deploy that hangs rather than an error.
	Urn string `protobuf:"bytes,1,opt,name=urn,proto3" json:"urn,omitempty"`
	// The PROVIDER's output property name, e.g. "privateKeyOpenssh" — not an
	// SC-level name.
	Property string `protobuf:"bytes,2,opt,name=property,proto3" json:"property,omitempty"`
	// contains filtered or unexported fields
}

ResourcePropertyRef points at one property of a resource the plugin registered against the shared monitor. Core resolves it with the engine's built-in pulumi:pulumi:getResource invoke (pkg/plugin/outputref.go).

func (*ResourcePropertyRef) Descriptor deprecated

func (*ResourcePropertyRef) Descriptor() ([]byte, []int)

Deprecated: Use ResourcePropertyRef.ProtoReflect.Descriptor instead.

func (*ResourcePropertyRef) GetProperty

func (x *ResourcePropertyRef) GetProperty() string

func (*ResourcePropertyRef) GetUrn

func (x *ResourcePropertyRef) GetUrn() string

func (*ResourcePropertyRef) ProtoMessage

func (*ResourcePropertyRef) ProtoMessage()

func (*ResourcePropertyRef) ProtoReflect

func (x *ResourcePropertyRef) ProtoReflect() protoreflect.Message

func (*ResourcePropertyRef) Reset

func (x *ResourcePropertyRef) Reset()

func (*ResourcePropertyRef) String

func (x *ResourcePropertyRef) String() string

type SCCloudPluginClient

type SCCloudPluginClient interface {
	Schema(ctx context.Context, in *SchemaRequest, opts ...grpc.CallOption) (*SchemaResponse, error)
	InitStateStore(ctx context.Context, in *InitStateStoreRequest, opts ...grpc.CallOption) (*InitStateStoreResponse, error)
	InitSecretsProvider(ctx context.Context, in *InitSecretsProviderRequest, opts ...grpc.CallOption) (*InitSecretsProviderResponse, error)
	Provider(ctx context.Context, in *ProviderRequest, opts ...grpc.CallOption) (*ProviderResponse, error)
	Provision(ctx context.Context, in *ProvisionRequest, opts ...grpc.CallOption) (*ProvisionResponse, error)
	ComputeProcess(ctx context.Context, in *ComputeProcessRequest, opts ...grpc.CallOption) (*ComputeProcessResponse, error)
	// PreProvision — the generic "lookup before template dispatch"
	// seam. Fires on a Component resource (IsComponentResourceType)
	// ONLY when the plugin advertises
	// `SchemaResponse.supports_pre_provision = true`. The RPC runs
	// in the plugin's Pulumi context (same wire pattern as
	// Provision), so cloud-SDK lookups are legal. SC core remains
	// cloud-blind: it only transports the returned template
	// extensions + env vars onto the shared
	// ComputeContextCollector. See
	// forge/docs/design/2026-11-15/plugin-preprovision-rpc/.
	PreProvision(ctx context.Context, in *PreProvisionRequest, opts ...grpc.CallOption) (*PreProvisionResponse, error)
	// ConvertStackConfig — the plugin's typed Input converter, lifted
	// out of SC-core-side cloud{SingleImage,Compose,StaticSite}ConverterMapping.
	// Called once per deploy per client stack whose template type is
	// plugin-owned (api.IsPluginOwnedType reports the binding). Plugins
	// that do not own templates leave this as the generated Unimplemented
	// stub — SC core only dials it when the type is plugin-owned.
	ConvertStackConfig(ctx context.Context, in *ConvertStackConfigRequest, opts ...grpc.CallOption) (*ConvertStackConfigResponse, error)
	ProvisionRegistrar(ctx context.Context, in *ProvisionRegistrarRequest, opts ...grpc.CallOption) (*ProvisionRegistrarResponse, error)
	// Phase 1b per-method registrar RPCs (the stubbed pluginRegistrar
	// methods on SC core proxy here).
	NewDnsRecord(ctx context.Context, in *NewDnsRecordRequest, opts ...grpc.CallOption) (*NewDnsRecordResponse, error)
	NewOverrideHeaderRule(ctx context.Context, in *NewOverrideHeaderRuleRequest, opts ...grpc.CallOption) (*NewOverrideHeaderRuleResponse, error)
	ProvisionDomainForEndpoint(ctx context.Context, in *ProvisionDomainForEndpointRequest, opts ...grpc.CallOption) (*ProvisionDomainForEndpointResponse, error)
	PreDestroy(ctx context.Context, in *PreDestroyRequest, opts ...grpc.CallOption) (*PreDestroyResponse, error)
	// Phase 1d — the VM seam. One call per `type: vm` resource whose `provider:`
	// names one of this plugin's vm_drivers.
	VmHosts(ctx context.Context, in *VmHostsRequest, opts ...grpc.CallOption) (*VmHostsResponse, error)
	// LogStream — server-streaming side channel for free-form progress /
	// log events. SC core opens exactly one of these per plugin after
	// Schema(), and routes events into the stack's logger with a
	// [plugin %q] prefix. Keeps intra-RPC progress visible without
	// bloating every unary RPC with a streaming variant. See
	// forge/docs/design/2026-10-24/sc-plugin-architecture/ Addendum F.
	LogStream(ctx context.Context, in *LogStreamRequest, opts ...grpc.CallOption) (grpc.ServerStreamingClient[PluginLogEvent], error)
	// PluginInvoke — capability dispatcher on the target plugin. SC
	// core's existing broker (SCCore.PeerInvoke) forwards cross-plugin
	// calls by SCCloudPlugin RPC name; a CALLING plugin dispatches a
	// capability via PeerInvoke(rpc_name="PluginInvoke", payload=
	// marshal(PluginInvokeRequest{capability: "..."})). Target plugin's
	// handler switches on `capability` to its registered function.
	//
	// Eliminates cross-plugin credential duplication — first consumer
	// pair is sc-component-backup → sc-plugin-mongodb for
	// `mint-scoped-user` (backup plugin asks mongodb to mint an Atlas
	// database user without holding its own Atlas admin credential).
	// Pattern generalises to notifier → aws (SES/SNS), monitor →
	// mongodb (metrics-only user), etc.
	//
	// See forge/docs/roadmap/items/sc-components-plugin-peer-invoke.md
	// for the design (SC-core-as-broker, capability advertisement via
	// SchemaResponse.peer_capabilities, first-consumer payload/reply
	// shapes).
	//
	// Older plugin binaries that pre-date this RPC return the generated
	// Unimplemented stub — the broker in SC core's PeerInvoke surfaces
	// that as a "target plugin does not expose capability dispatch"
	// error, distinct from capability-not-advertised.
	PluginInvoke(ctx context.Context, in *PluginInvokeRequest, opts ...grpc.CallOption) (*PluginInvokeResponse, error)
}

SCCloudPluginClient is the client API for SCCloudPlugin service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream.

SCCloudPlugin — implemented by every sc-plugin-<cloud> binary. Called by SC core via hashicorp/go-plugin's gRPC transport. v1 is the scope-reduced "walking skeleton" surface — see pkg/plugin/proto/README.md for the planned additions (ComputeProcess, Registrar, PreDestroy, Fingerprint stream, PeerInvoke).

type SCCloudPluginServer

type SCCloudPluginServer interface {
	Schema(context.Context, *SchemaRequest) (*SchemaResponse, error)
	InitStateStore(context.Context, *InitStateStoreRequest) (*InitStateStoreResponse, error)
	InitSecretsProvider(context.Context, *InitSecretsProviderRequest) (*InitSecretsProviderResponse, error)
	Provider(context.Context, *ProviderRequest) (*ProviderResponse, error)
	Provision(context.Context, *ProvisionRequest) (*ProvisionResponse, error)
	ComputeProcess(context.Context, *ComputeProcessRequest) (*ComputeProcessResponse, error)
	// PreProvision — the generic "lookup before template dispatch"
	// seam. Fires on a Component resource (IsComponentResourceType)
	// ONLY when the plugin advertises
	// `SchemaResponse.supports_pre_provision = true`. The RPC runs
	// in the plugin's Pulumi context (same wire pattern as
	// Provision), so cloud-SDK lookups are legal. SC core remains
	// cloud-blind: it only transports the returned template
	// extensions + env vars onto the shared
	// ComputeContextCollector. See
	// forge/docs/design/2026-11-15/plugin-preprovision-rpc/.
	PreProvision(context.Context, *PreProvisionRequest) (*PreProvisionResponse, error)
	// ConvertStackConfig — the plugin's typed Input converter, lifted
	// out of SC-core-side cloud{SingleImage,Compose,StaticSite}ConverterMapping.
	// Called once per deploy per client stack whose template type is
	// plugin-owned (api.IsPluginOwnedType reports the binding). Plugins
	// that do not own templates leave this as the generated Unimplemented
	// stub — SC core only dials it when the type is plugin-owned.
	ConvertStackConfig(context.Context, *ConvertStackConfigRequest) (*ConvertStackConfigResponse, error)
	ProvisionRegistrar(context.Context, *ProvisionRegistrarRequest) (*ProvisionRegistrarResponse, error)
	// Phase 1b per-method registrar RPCs (the stubbed pluginRegistrar
	// methods on SC core proxy here).
	NewDnsRecord(context.Context, *NewDnsRecordRequest) (*NewDnsRecordResponse, error)
	NewOverrideHeaderRule(context.Context, *NewOverrideHeaderRuleRequest) (*NewOverrideHeaderRuleResponse, error)
	ProvisionDomainForEndpoint(context.Context, *ProvisionDomainForEndpointRequest) (*ProvisionDomainForEndpointResponse, error)
	PreDestroy(context.Context, *PreDestroyRequest) (*PreDestroyResponse, error)
	// Phase 1d — the VM seam. One call per `type: vm` resource whose `provider:`
	// names one of this plugin's vm_drivers.
	VmHosts(context.Context, *VmHostsRequest) (*VmHostsResponse, error)
	// LogStream — server-streaming side channel for free-form progress /
	// log events. SC core opens exactly one of these per plugin after
	// Schema(), and routes events into the stack's logger with a
	// [plugin %q] prefix. Keeps intra-RPC progress visible without
	// bloating every unary RPC with a streaming variant. See
	// forge/docs/design/2026-10-24/sc-plugin-architecture/ Addendum F.
	LogStream(*LogStreamRequest, grpc.ServerStreamingServer[PluginLogEvent]) error
	// PluginInvoke — capability dispatcher on the target plugin. SC
	// core's existing broker (SCCore.PeerInvoke) forwards cross-plugin
	// calls by SCCloudPlugin RPC name; a CALLING plugin dispatches a
	// capability via PeerInvoke(rpc_name="PluginInvoke", payload=
	// marshal(PluginInvokeRequest{capability: "..."})). Target plugin's
	// handler switches on `capability` to its registered function.
	//
	// Eliminates cross-plugin credential duplication — first consumer
	// pair is sc-component-backup → sc-plugin-mongodb for
	// `mint-scoped-user` (backup plugin asks mongodb to mint an Atlas
	// database user without holding its own Atlas admin credential).
	// Pattern generalises to notifier → aws (SES/SNS), monitor →
	// mongodb (metrics-only user), etc.
	//
	// See forge/docs/roadmap/items/sc-components-plugin-peer-invoke.md
	// for the design (SC-core-as-broker, capability advertisement via
	// SchemaResponse.peer_capabilities, first-consumer payload/reply
	// shapes).
	//
	// Older plugin binaries that pre-date this RPC return the generated
	// Unimplemented stub — the broker in SC core's PeerInvoke surfaces
	// that as a "target plugin does not expose capability dispatch"
	// error, distinct from capability-not-advertised.
	PluginInvoke(context.Context, *PluginInvokeRequest) (*PluginInvokeResponse, error)
	// contains filtered or unexported methods
}

SCCloudPluginServer is the server API for SCCloudPlugin service. All implementations must embed UnimplementedSCCloudPluginServer for forward compatibility.

SCCloudPlugin — implemented by every sc-plugin-<cloud> binary. Called by SC core via hashicorp/go-plugin's gRPC transport. v1 is the scope-reduced "walking skeleton" surface — see pkg/plugin/proto/README.md for the planned additions (ComputeProcess, Registrar, PreDestroy, Fingerprint stream, PeerInvoke).

type SCCloudPlugin_LogStreamClient

type SCCloudPlugin_LogStreamClient = grpc.ServerStreamingClient[PluginLogEvent]

This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name.

type SCCloudPlugin_LogStreamServer

type SCCloudPlugin_LogStreamServer = grpc.ServerStreamingServer[PluginLogEvent]

This type alias is provided for backwards compatibility with existing code that references the prior non-generic stream type by name.

type SCCoreClient

type SCCoreClient interface {
	ResolveSecret(ctx context.Context, in *ResolveSecretRequest, opts ...grpc.CallOption) (*ResolveSecretResponse, error)
	ResolveCredential(ctx context.Context, in *ResolveCredentialRequest, opts ...grpc.CallOption) (*ResolveCredentialResponse, error)
	PeerInvoke(ctx context.Context, in *PeerInvokeRequest, opts ...grpc.CallOption) (*PeerInvokeResponse, error)
}

SCCoreClient is the client API for SCCore service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://pkg.go.dev/google.golang.org/grpc/?tab=doc#ClientConn.NewStream.

SCCore — the callback surface SC core exposes to a plugin. Lets the plugin resolve secrets and credentials without SC core sending them in cleartext over the plugin bus up front (Vault pattern — see 03 §6.3), and lets a composite plugin invoke a peer plugin's RPCs without taking a Go module dependency on it (D8 PeerInvoke — see 03 §9).

Reached by dialling RequestHeader.sccore_broker_stream over the plugin's hashicorp/go-plugin GRPCBroker. On the host side, SC core serves this service on that stream for every spawned plugin; see pkg/plugin/callback_server.go.

func NewSCCoreClient

func NewSCCoreClient(cc grpc.ClientConnInterface) SCCoreClient

type SCCoreServer

type SCCoreServer interface {
	ResolveSecret(context.Context, *ResolveSecretRequest) (*ResolveSecretResponse, error)
	ResolveCredential(context.Context, *ResolveCredentialRequest) (*ResolveCredentialResponse, error)
	PeerInvoke(context.Context, *PeerInvokeRequest) (*PeerInvokeResponse, error)
	// contains filtered or unexported methods
}

SCCoreServer is the server API for SCCore service. All implementations must embed UnimplementedSCCoreServer for forward compatibility.

SCCore — the callback surface SC core exposes to a plugin. Lets the plugin resolve secrets and credentials without SC core sending them in cleartext over the plugin bus up front (Vault pattern — see 03 §6.3), and lets a composite plugin invoke a peer plugin's RPCs without taking a Go module dependency on it (D8 PeerInvoke — see 03 §9).

Reached by dialling RequestHeader.sccore_broker_stream over the plugin's hashicorp/go-plugin GRPCBroker. On the host side, SC core serves this service on that stream for every spawned plugin; see pkg/plugin/callback_server.go.

type SchemaRequest

type SchemaRequest struct {
	Header *RequestHeader `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	// contains filtered or unexported fields
}

func (*SchemaRequest) Descriptor deprecated

func (*SchemaRequest) Descriptor() ([]byte, []int)

Deprecated: Use SchemaRequest.ProtoReflect.Descriptor instead.

func (*SchemaRequest) GetHeader

func (x *SchemaRequest) GetHeader() *RequestHeader

func (*SchemaRequest) ProtoMessage

func (*SchemaRequest) ProtoMessage()

func (*SchemaRequest) ProtoReflect

func (x *SchemaRequest) ProtoReflect() protoreflect.Message

func (*SchemaRequest) Reset

func (x *SchemaRequest) Reset()

func (*SchemaRequest) String

func (x *SchemaRequest) String() string

type SchemaResponse

type SchemaResponse struct {

	// The plugin's semantic version (independent of the gRPC protocol version).
	PluginVersion string `protobuf:"bytes,1,opt,name=plugin_version,json=pluginVersion,proto3" json:"plugin_version,omitempty"`
	// Provider auth types this plugin owns, keyed by the ProviderType string this
	// plugin's /api module registered in pkg/api/mapping.go
	// (e.g. "aws", "gcp", "cloudflare", "yandex").
	ProviderTypes []string `protobuf:"bytes,2,rep,name=provider_types,json=providerTypes,proto3" json:"provider_types,omitempty"`
	// Resource types this plugin handles, keyed by SC resource.Type
	// (e.g. "aws:s3/bucket:Bucket", "aws-lambda", "cloud-compose").
	ResourceTypes []string `protobuf:"bytes,3,rep,name=resource_types,json=resourceTypes,proto3" json:"resource_types,omitempty"`
	// Compute processor types this plugin handles (dependency placeholder injection,
	// env variable propagation). Keyed by the Type of the dependency resource.
	ComputeProcessorTypes []string `` /* 126-byte string literal not displayed */
	// DNS registrar types (e.g. "cloudflare", "yandex", "cloudru-dns").
	RegistrarTypes []string `protobuf:"bytes,5,rep,name=registrar_types,json=registrarTypes,proto3" json:"registrar_types,omitempty"`
	// State-store types this plugin can initialise (e.g. "s3", "gcs", "yc-object-storage").
	StateStoreTypes []string `protobuf:"bytes,6,rep,name=state_store_types,json=stateStoreTypes,proto3" json:"state_store_types,omitempty"`
	// Pulumi provider plugin dependencies the engine must have available. Keyed by
	// Pulumi package name (e.g. "aws", "cloudflare"), value is the version + optional
	// PluginDownloadURL this plugin was built against. SC core uses these for the
	// auto-pin algorithm in 04 §3.
	PulumiPlugins []*PulumiPluginRequirement `protobuf:"bytes,7,rep,name=pulumi_plugins,json=pulumiPlugins,proto3" json:"pulumi_plugins,omitempty"`
	// Secrets-provider types this plugin can initialise (e.g. "awskms", "gcpkms",
	// "azurekeyvault"). Step 4b of sc-plugin-architecture; see Addendum C in
	// forge/docs/design/2026-10-24/sc-plugin-architecture/04-no-destroy-invariant.md.
	// SC dispatches these pre-engine, same lifecycle as state_store_types.
	SecretsProviderTypes []string `protobuf:"bytes,8,rep,name=secrets_provider_types,json=secretsProviderTypes,proto3" json:"secrets_provider_types,omitempty"`
	// VM drivers this plugin provides — the `provider:` values a parent stack's
	// `type: vm` resource may name (e.g. "yc-vm", "openstack-vm").
	//
	// This is NOT a resource type: `vm` stays a CORE resource type, and everything
	// above the driver (the SSH connection, readiness, cloud-init, compose, Caddy
	// ingress) stays in core. Only the per-cloud half — create the machines, return
	// reachable hosts — moves out, behind the VmHosts RPC. Hence a dedicated field
	// rather than another string in resource_types: a plugin that advertised `vm`
	// would be claiming the whole path.
	//
	// Each spec carries what pkg/clouds/vm's in-tree driver table carries for a
	// built-in driver, because the same consumers read both: config validation, the
	// generated config reference, and the refusal an operator sees for a driver that
	// does not exist yet. SC core merges these rows into that table pre-engine.
	VmDrivers []*VmDriverSpec `protobuf:"bytes,9,rep,name=vm_drivers,json=vmDrivers,proto3" json:"vm_drivers,omitempty"`
	// Resource types this plugin declares as SAFE for Pulumi's `replace`
	// op — the provider publishes a new revision additively and any
	// consuming resource re-references the new id on the same deploy.
	// SC core suppresses the S4 destructive-replace guard
	// (pkg/clouds/pulumi/destructive_replace.go) for types on this list.
	//
	// Entries must satisfy BOTH:
	//  1. Provider's replace does NOT destroy the previous instance
	//     from the cloud.
	//  2. Downstream resources (service, alias, …) pick up the new id
	//     without operator intervention.
	//
	// When in doubt, leave it off — the operator can still opt out per
	// deploy with SC_ALLOW_DESTRUCTIVE_REPLACE=1. Canonical example:
	// `aws:ecs/taskDefinition:TaskDefinition`, where every deploy
	// publishes a new revision and the FargateService re-references the
	// new ARN on the same deploy. See
	// forge/docs/roadmap/items/sc-safe-to-replace-via-plugin-schema.md.
	SafeToReplaceTypes []string `protobuf:"bytes,10,rep,name=safe_to_replace_types,json=safeToReplaceTypes,proto3" json:"safe_to_replace_types,omitempty"`
	// AuthTypes lists the `type:` discriminators a plugin's auth
	// configs use — e.g. `gcp-service-account`, `mws-service-account`,
	// `aws-token`. SC core seeds `providerConfigMapping` with the opaque
	// `pluginOwnedWrappingDecoder` for each entry, so a server.yaml that
	// declares `auth.<name>.type: <auth-type>` parses without SC core
	// needing to link-time-import the plugin's `/api` module.
	//
	// Before this field existed, `plugin_bootstrap.go`'s hardcoded table
	// was the only path for a plugin core doesn't link-time-import, which
	// meant every new plugin repo needed a bootstrap-table edit on the
	// api side — defeating the "dynamic discovery owns it" promise for
	// the auth half of the config tier (resource/state-store/
	// secrets-provider/registrar/compute-processor/vm were already
	// covered by their own Schema fields). Live-caught trying to
	// register `mws-service-account` and `gcp-service-account` from
	// plugins not in the bootstrap table — both died at parse with
	// `unknown auth type` before any provisioning work ran. See
	// forge/docs/roadmap/items/sc-plugin-auth-type-has-no-wire-path.md.
	//
	// Older plugin binaries that pre-date this field send no auth_types,
	// the stackread loop runs zero times, and the bootstrap-table seed
	// keeps covering aws/yandex/cloudflare/cloudru/mongodb exactly as
	// today — additive by construction.
	AuthTypes []string `protobuf:"bytes,11,rep,name=auth_types,json=authTypes,proto3" json:"auth_types,omitempty"`
	// Resource types this plugin owns that are SC Components — SC core's sidecar
	// wrapper (pkg/clouds/pulumi/plugin_sidecars.go `makeResourceSidecar`)
	// dispatches these into the template named by their `config.deployTo:`
	// field, rather than running the plugin's Provision RPC directly in
	// isolation. The plugin's Provision still fires afterwards, and reads the
	// dispatched service's URL from `DependencyOutputsJson._deployed_service`.
	//
	// Same addressing pattern as `safe_to_replace_types` + `auth_types` above:
	// core builds a fleet-wide set at plugin-load time, dispatch is
	// set-membership. Older plugins omit this field + present as zero component
	// types + keep working — additive by construction.
	//
	// Why this is a Schema-advertised string set rather than a Go interface
	// assertion on the config value: SC core cannot import plugin `/api`
	// modules, so plugin-owned configs arrive as opaque `*api.PluginFieldConfig`
	// in production. A core-defined Go interface can never match a plugin-owned
	// type. See the operator memory
	// `interface_assertion_against_plugin_owned_value_fails_in_prod` + the
	// generic parent `local_shape_not_production_shape`. 7+ exposures of this
	// trap in the first fortnight of the plugin-split work; this design avoids
	// the 8th.
	//
	// See forge/docs/design/2026-11-10/sc-components-platform/README.md §P1
	// (Path A — Schema-advertised + .Raw-reading) for the full shape.
	ComponentResourceTypes []string `` /* 130-byte string literal not displayed */
	// Per-component-resource-type, the `.Raw` keys a plugin MAY set when
	// overriding its dispatched template's config. Core refuses any override
	// not on this list at parse time (defense-in-depth is also enforced at
	// merge time in plugin_sidecars.go).
	//
	// Starter allowlist for most components: `image` + `env` + `ingressRoutes`
	// + `imagePullSecretRef`. Operator-locked by omission: `vpc` / `subnets` /
	// `iam` / anything that would let a plugin point an operator's Lambda at
	// an attacker-controlled network.
	//
	// Keyed by component resource type (one of the strings in
	// `component_resource_types`). Absent key means the plugin allows no
	// overrides (dispatched template runs with operator config verbatim).
	ComponentAllowedOverrides map[string]*StringList `` /* 213-byte string literal not displayed */
	// Resource types this plugin's Provision RPC accepts SC Components
	// dispatch for — i.e. its ProvisionFunc knows how to read
	// `ProvisionRequest.component_raw` and overlay the component's
	// operator-declared fields (`image`, `env`, `ingress`, `signingKey`, …)
	// onto its typed input struct before building the cloud resource.
	//
	// Slice 1a.1 of sc-components-platform (operator path (b) in design
	// doc §#19): advertising opt-in so a plugin that has NOT been updated
	// to honour the ComponentRaw side-channel is NOT a valid `deployTo:`
	// target. Parse-time validation in `pkg/api/component_validation.go`
	// refuses a component resource whose `deployTo:` names a template
	// whose owning plugin has not advertised the template type here,
	// unless the template has an in-tree `componentTemplateMergeFuncs`
	// entry (vm-compose).
	//
	// Mechanism documented at
	// forge/docs/design/2026-11-10/sc-components-platform/ §#19 "path
	// (b) side-channel ComponentRaw on `api.ResourceInput`". Why core
	// can't just overlay the fields on the plugin's behalf: the typed
	// input struct (`*aws.LambdaInput`, etc.) lives in the plugin's
	// `/api` module; a core-side overlay would need to link that
	// module, which is the same import-cycle trap
	// `interface_assertion_against_plugin_owned_value_fails_in_prod`
	// names.
	//
	// Older plugin binaries that pre-date this field send no
	// `supports_component`, the fleet-wide `SupportsComponent` map
	// stays empty for that plugin, and the parse-time validator refuses
	// any dispatch targeting one of its template types. Additive by
	// construction.
	SupportsComponent []string `protobuf:"bytes,14,rep,name=supports_component,json=supportsComponent,proto3" json:"supports_component,omitempty"`
	// Per-Component-resource-type defaults that SC core merges UNDER
	// the operator's declared `.Raw` map at dispatch time (operator
	// wins on every key). JSON-marshalled `map[string]any` per
	// component resource type; keyed by the same token the plugin
	// advertised in `component_resource_types`.
	//
	// Purpose: let a plugin declare the boilerplate its dispatched
	// template needs (e.g. sc-backup wants `cloudExtras.awsRoles:
	// [s3:*, ecs:RunTask, iam:PassRole]` + `cloudExtras.lambdaRoutingType:
	// function-url` for its Lambda; sc-monitor will want log/metrics
	// perms; sc-notifier will want SES/SNS perms) without forcing the
	// operator to spell those out on every stack that uses the component.
	//
	// Merge semantics (documented in `pApi.DeepMergeComponentRaw`):
	//   - Nested maps: per-key union. Plugin keys the operator did not
	//     write stay; operator keys overwrite.
	//   - Lists: operator REPLACES (not appends). Matches the
	//     `ComponentAllowedOverrides` precedent for `env:` + `secrets:`.
	//     Rationale: a list override should be a complete declaration
	//     so the operator sees the exact effective value; an append
	//     would silently pull in plugin defaults the operator might
	//     have meant to remove.
	//   - Scalars: operator wins.
	//
	// Operator-safe: fields the operator did not write get the plugin's
	// default. Fields the operator DID write never silently change
	// under a plugin version bump (operator-wins contract). A plugin
	// that wants to remove a historical default must do it as an
	// explicit migration, not as a silent config change.
	//
	// Opt-in: older plugin binaries omit the field; SC core sees an
	// empty map and merges onto nothing — behaviour unchanged.
	//
	// Live-driver: sc-component-backup slice 1d.6 (roadmap item
	// `sc-components-componentdefaults-operator-ux`). Live-caught trap
	// during the 2026-11-14 minimal-shape smoke: dropping the
	// `cloudExtras.awsRoles` block broke the backup service's own
	// S3-colocated metadata upsert (500); the plugin should carry that
	// default so the operator can't accidentally remove it.
	ComponentDefaults map[string][]byte `` /* 187-byte string literal not displayed */
	// Capability names this plugin exposes to peer plugins via the
	// PeerInvoke RPC (see SCCloudPlugin service definition). Names are
	// plugin-local; cross-plugin dispatch is identified by the pair
	// (target_plugin, capability) where target_plugin is this plugin's
	// name in SC core's loaded plugin map.
	//
	// SC core's broker refuses a PeerInvoke call whose `capability`
	// is not in this list — operator-safe default is "this plugin
	// exposes no peer surface". Older plugin binaries pre-dating
	// the field advertise nothing; the broker treats them as having
	// no capabilities.
	//
	// First adopters (slice `sc-components-plugin-peer-invoke`):
	//   - sc-plugin-mongodb: `mint-scoped-user`, `delete-scoped-user`.
	//
	// Payload/reply schemas per capability are plugin-authored and
	// documented in each plugin's README. SC core does not interpret
	// the payload JSON beyond routing.
	PeerCapabilities []string `protobuf:"bytes,16,rep,name=peer_capabilities,json=peerCapabilities,proto3" json:"peer_capabilities,omitempty"`
	// Whether the plugin implements the PreProvision RPC — the
	// generic "lookup now, land values on the ComputeContextCollector
	// before template dispatch" seam. A plugin opts in by implementing
	// the RPC in its runtime and setting this to true in Schema.
	//
	// SC core's component dispatch calls PreProvision ONLY when this
	// flag is true AND the resource type is a Component
	// (`IsComponentResourceType`). Non-component resources skip it;
	// older plugin binaries (flag defaults to false) skip it
	// regardless. The RPC runs in the plugin's Pulumi context (same
	// shape as Provision), so cloud SDK lookups are legal — SC core
	// itself remains cloud-blind.
	//
	// Design: forge/docs/design/2026-11-15/plugin-preprovision-rpc/README.md.
	//
	// First adopter: sc-component-backup for the `deployTo: lambda`
	// branch — looks up the AWS account's default VPC subnets + a
	// default Fargate SG and returns them as template extensions so
	// `${resource:${name}.subnets-csv}` in env defaults resolves to
	// the account's real values. Removes the operator's
	// `env.BACKUP_ECS_SUBNETS`/`BACKUP_ECS_SECURITY_GROUPS` writeout.
	SupportsPreProvision bool `protobuf:"varint,17,opt,name=supports_pre_provision,json=supportsPreProvision,proto3" json:"supports_pre_provision,omitempty"`
	// contains filtered or unexported fields
}

func (*SchemaResponse) Descriptor deprecated

func (*SchemaResponse) Descriptor() ([]byte, []int)

Deprecated: Use SchemaResponse.ProtoReflect.Descriptor instead.

func (*SchemaResponse) GetAuthTypes

func (x *SchemaResponse) GetAuthTypes() []string

func (*SchemaResponse) GetComponentAllowedOverrides

func (x *SchemaResponse) GetComponentAllowedOverrides() map[string]*StringList

func (*SchemaResponse) GetComponentDefaults

func (x *SchemaResponse) GetComponentDefaults() map[string][]byte

func (*SchemaResponse) GetComponentResourceTypes

func (x *SchemaResponse) GetComponentResourceTypes() []string

func (*SchemaResponse) GetComputeProcessorTypes

func (x *SchemaResponse) GetComputeProcessorTypes() []string

func (*SchemaResponse) GetPeerCapabilities

func (x *SchemaResponse) GetPeerCapabilities() []string

func (*SchemaResponse) GetPluginVersion

func (x *SchemaResponse) GetPluginVersion() string

func (*SchemaResponse) GetProviderTypes

func (x *SchemaResponse) GetProviderTypes() []string

func (*SchemaResponse) GetPulumiPlugins

func (x *SchemaResponse) GetPulumiPlugins() []*PulumiPluginRequirement

func (*SchemaResponse) GetRegistrarTypes

func (x *SchemaResponse) GetRegistrarTypes() []string

func (*SchemaResponse) GetResourceTypes

func (x *SchemaResponse) GetResourceTypes() []string

func (*SchemaResponse) GetSafeToReplaceTypes

func (x *SchemaResponse) GetSafeToReplaceTypes() []string

func (*SchemaResponse) GetSecretsProviderTypes

func (x *SchemaResponse) GetSecretsProviderTypes() []string

func (*SchemaResponse) GetStateStoreTypes

func (x *SchemaResponse) GetStateStoreTypes() []string

func (*SchemaResponse) GetSupportsComponent

func (x *SchemaResponse) GetSupportsComponent() []string

func (*SchemaResponse) GetSupportsPreProvision

func (x *SchemaResponse) GetSupportsPreProvision() bool

func (*SchemaResponse) GetVmDrivers

func (x *SchemaResponse) GetVmDrivers() []*VmDriverSpec

func (*SchemaResponse) ProtoMessage

func (*SchemaResponse) ProtoMessage()

func (*SchemaResponse) ProtoReflect

func (x *SchemaResponse) ProtoReflect() protoreflect.Message

func (*SchemaResponse) Reset

func (x *SchemaResponse) Reset()

func (*SchemaResponse) String

func (x *SchemaResponse) String() string

type StringList

type StringList struct {
	Values []string `protobuf:"bytes,1,rep,name=values,proto3" json:"values,omitempty"`
	// contains filtered or unexported fields
}

StringList is a repeated-string wrapper so `component_allowed_overrides` can be a `map<string, repeated string>` (proto3 forbids repeated values inside maps directly).

func (*StringList) Descriptor deprecated

func (*StringList) Descriptor() ([]byte, []int)

Deprecated: Use StringList.ProtoReflect.Descriptor instead.

func (*StringList) GetValues

func (x *StringList) GetValues() []string

func (*StringList) ProtoMessage

func (*StringList) ProtoMessage()

func (*StringList) ProtoReflect

func (x *StringList) ProtoReflect() protoreflect.Message

func (*StringList) Reset

func (x *StringList) Reset()

func (*StringList) String

func (x *StringList) String() string

type TemplateExtension

type TemplateExtension struct {
	Kind    TemplateExtensionKind `protobuf:"varint,1,opt,name=kind,proto3,enum=sc.plugin.v1.TemplateExtensionKind" json:"kind,omitempty"`
	ResName string                `protobuf:"bytes,2,opt,name=res_name,json=resName,proto3" json:"res_name,omitempty"`
	DepName string                `protobuf:"bytes,3,opt,name=dep_name,json=depName,proto3" json:"dep_name,omitempty"` // only for KIND_DEPENDENCY
	Values  map[string]string     ``                                                                                   /* 139-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*TemplateExtension) Descriptor deprecated

func (*TemplateExtension) Descriptor() ([]byte, []int)

Deprecated: Use TemplateExtension.ProtoReflect.Descriptor instead.

func (*TemplateExtension) GetDepName

func (x *TemplateExtension) GetDepName() string

func (*TemplateExtension) GetKind

func (*TemplateExtension) GetResName

func (x *TemplateExtension) GetResName() string

func (*TemplateExtension) GetValues

func (x *TemplateExtension) GetValues() map[string]string

func (*TemplateExtension) ProtoMessage

func (*TemplateExtension) ProtoMessage()

func (*TemplateExtension) ProtoReflect

func (x *TemplateExtension) ProtoReflect() protoreflect.Message

func (*TemplateExtension) Reset

func (x *TemplateExtension) Reset()

func (*TemplateExtension) String

func (x *TemplateExtension) String() string

type TemplateExtensionKind

type TemplateExtensionKind int32
const (
	TemplateExtensionKind_TEMPLATE_EXTENSION_KIND_UNSPECIFIED TemplateExtensionKind = 0
	TemplateExtensionKind_TEMPLATE_EXTENSION_KIND_RESOURCE    TemplateExtensionKind = 1 // AddResourceTplExtension(res_name, values)
	TemplateExtensionKind_TEMPLATE_EXTENSION_KIND_DEPENDENCY  TemplateExtensionKind = 2 // AddDependencyTplExtension(dep_name, res_name, values)
)

func (TemplateExtensionKind) Descriptor

func (TemplateExtensionKind) Enum

func (TemplateExtensionKind) EnumDescriptor deprecated

func (TemplateExtensionKind) EnumDescriptor() ([]byte, []int)

Deprecated: Use TemplateExtensionKind.Descriptor instead.

func (TemplateExtensionKind) Number

func (TemplateExtensionKind) String

func (x TemplateExtensionKind) String() string

func (TemplateExtensionKind) Type

type UnimplementedSCCloudPluginServer

type UnimplementedSCCloudPluginServer struct{}

UnimplementedSCCloudPluginServer must be embedded to have forward compatible implementations.

NOTE: this should be embedded by value instead of pointer to avoid a nil pointer dereference when methods are called.

func (UnimplementedSCCloudPluginServer) ComputeProcess

func (UnimplementedSCCloudPluginServer) ConvertStackConfig

func (UnimplementedSCCloudPluginServer) InitStateStore

func (UnimplementedSCCloudPluginServer) LogStream

func (UnimplementedSCCloudPluginServer) NewDnsRecord

func (UnimplementedSCCloudPluginServer) PluginInvoke

func (UnimplementedSCCloudPluginServer) PreDestroy

func (UnimplementedSCCloudPluginServer) PreProvision

func (UnimplementedSCCloudPluginServer) Provider

func (UnimplementedSCCloudPluginServer) Provision

func (UnimplementedSCCloudPluginServer) ProvisionRegistrar

func (UnimplementedSCCloudPluginServer) Schema

func (UnimplementedSCCloudPluginServer) VmHosts

type UnimplementedSCCoreServer

type UnimplementedSCCoreServer struct{}

UnimplementedSCCoreServer must be embedded to have forward compatible implementations.

NOTE: this should be embedded by value instead of pointer to avoid a nil pointer dereference when methods are called.

func (UnimplementedSCCoreServer) PeerInvoke

func (UnimplementedSCCoreServer) ResolveSecret

type UnsafeSCCloudPluginServer

type UnsafeSCCloudPluginServer interface {
	// contains filtered or unexported methods
}

UnsafeSCCloudPluginServer may be embedded to opt out of forward compatibility for this service. Use of this interface is not recommended, as added methods to SCCloudPluginServer will result in compilation errors.

type UnsafeSCCoreServer

type UnsafeSCCoreServer interface {
	// contains filtered or unexported methods
}

UnsafeSCCoreServer may be embedded to opt out of forward compatibility for this service. Use of this interface is not recommended, as added methods to SCCoreServer will result in compilation errors.

type VmCapabilities

type VmCapabilities struct {
	CloudInit            bool  `protobuf:"varint,1,opt,name=cloud_init,json=cloudInit,proto3" json:"cloud_init,omitempty"`
	CloudInitNeedsEgress bool  `` /* 126-byte string literal not displayed */
	Regionless           bool  `protobuf:"varint,3,opt,name=regionless,proto3" json:"regionless,omitempty"`
	MultiAzInRegion      int32 `protobuf:"varint,4,opt,name=multi_az_in_region,json=multiAzInRegion,proto3" json:"multi_az_in_region,omitempty"`
	PrivateNetwork       bool  `protobuf:"varint,5,opt,name=private_network,json=privateNetwork,proto3" json:"private_network,omitempty"`
	FloatingIp           bool  `protobuf:"varint,6,opt,name=floating_ip,json=floatingIp,proto3" json:"floating_ip,omitempty"`
	SecurityGroups       bool  `protobuf:"varint,7,opt,name=security_groups,json=securityGroups,proto3" json:"security_groups,omitempty"`
	BlockStorageCsi      bool  `protobuf:"varint,8,opt,name=block_storage_csi,json=blockStorageCsi,proto3" json:"block_storage_csi,omitempty"`
	ContainerRegistry    bool  `protobuf:"varint,9,opt,name=container_registry,json=containerRegistry,proto3" json:"container_registry,omitempty"`
	DnsInIac             bool  `protobuf:"varint,10,opt,name=dns_in_iac,json=dnsInIac,proto3" json:"dns_in_iac,omitempty"`
	// contains filtered or unexported fields
}

VmCapabilities mirrors pkg/clouds/vm.Capabilities: what the cloud behind a driver physically does, so the differences live in one table instead of becoming `if provider == …` branches in shared code.

A plugin that has not measured a field must leave it at the zero value. The in-tree table deliberately ships cloud rows zeroed for exactly this reason — a table of half-guesses that shared code branches on is worse than an empty one — and `multi_az_in_region = 0` specifically means "not measured", not "no zones".

func (*VmCapabilities) Descriptor deprecated

func (*VmCapabilities) Descriptor() ([]byte, []int)

Deprecated: Use VmCapabilities.ProtoReflect.Descriptor instead.

func (*VmCapabilities) GetBlockStorageCsi

func (x *VmCapabilities) GetBlockStorageCsi() bool

func (*VmCapabilities) GetCloudInit

func (x *VmCapabilities) GetCloudInit() bool

func (*VmCapabilities) GetCloudInitNeedsEgress

func (x *VmCapabilities) GetCloudInitNeedsEgress() bool

func (*VmCapabilities) GetContainerRegistry

func (x *VmCapabilities) GetContainerRegistry() bool

func (*VmCapabilities) GetDnsInIac

func (x *VmCapabilities) GetDnsInIac() bool

func (*VmCapabilities) GetFloatingIp

func (x *VmCapabilities) GetFloatingIp() bool

func (*VmCapabilities) GetMultiAzInRegion

func (x *VmCapabilities) GetMultiAzInRegion() int32

func (*VmCapabilities) GetPrivateNetwork

func (x *VmCapabilities) GetPrivateNetwork() bool

func (*VmCapabilities) GetRegionless

func (x *VmCapabilities) GetRegionless() bool

func (*VmCapabilities) GetSecurityGroups

func (x *VmCapabilities) GetSecurityGroups() bool

func (*VmCapabilities) ProtoMessage

func (*VmCapabilities) ProtoMessage()

func (*VmCapabilities) ProtoReflect

func (x *VmCapabilities) ProtoReflect() protoreflect.Message

func (*VmCapabilities) Reset

func (x *VmCapabilities) Reset()

func (*VmCapabilities) String

func (x *VmCapabilities) String() string

type VmDriverSpec

type VmDriverSpec struct {

	// The `provider:` value, e.g. "yc-vm". Frozen once published: renaming one turns
	// an existing parent stack into "unknown vm provider".
	Driver      string `protobuf:"bytes,1,opt,name=driver,proto3" json:"driver,omitempty"`
	Implemented bool   `protobuf:"varint,2,opt,name=implemented,proto3" json:"implemented,omitempty"`
	// Non-empty means the driver's code exists but has never provisioned a machine on
	// the cloud it addresses, and this string says why not. Quoted VERBATIM in the
	// refusal, so write it for an operator: what estate it was written against, and
	// what to use instead.
	Unverified string `protobuf:"bytes,3,opt,name=unverified,proto3" json:"unverified,omitempty"`
	// The forge roadmap item tracking this driver — also quoted verbatim in the
	// refusal an unimplemented driver returns.
	RoadmapItem  string          `protobuf:"bytes,4,opt,name=roadmap_item,json=roadmapItem,proto3" json:"roadmap_item,omitempty"`
	Capabilities *VmCapabilities `protobuf:"bytes,5,opt,name=capabilities,proto3" json:"capabilities,omitempty"`
	// contains filtered or unexported fields
}

VmDriverSpec is one row of the VM driver table, as advertised by a plugin. Mirrors pkg/clouds/vm.DriverInfo; see its field comments for the semantics, which are the contract and not restated here.

func (*VmDriverSpec) Descriptor deprecated

func (*VmDriverSpec) Descriptor() ([]byte, []int)

Deprecated: Use VmDriverSpec.ProtoReflect.Descriptor instead.

func (*VmDriverSpec) GetCapabilities

func (x *VmDriverSpec) GetCapabilities() *VmCapabilities

func (*VmDriverSpec) GetDriver

func (x *VmDriverSpec) GetDriver() string

func (*VmDriverSpec) GetImplemented

func (x *VmDriverSpec) GetImplemented() bool

func (*VmDriverSpec) GetRoadmapItem

func (x *VmDriverSpec) GetRoadmapItem() string

func (*VmDriverSpec) GetUnverified

func (x *VmDriverSpec) GetUnverified() string

func (*VmDriverSpec) ProtoMessage

func (*VmDriverSpec) ProtoMessage()

func (*VmDriverSpec) ProtoReflect

func (x *VmDriverSpec) ProtoReflect() protoreflect.Message

func (*VmDriverSpec) Reset

func (x *VmDriverSpec) Reset()

func (*VmDriverSpec) String

func (x *VmDriverSpec) String() string

type VmHostFacts

type VmHostFacts struct {

	// Stable, resource-name-safe identifier within the vm resource.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	User string `protobuf:"bytes,2,opt,name=user,proto3" json:"user,omitempty"`
	Port int32  `protobuf:"varint,3,opt,name=port,proto3" json:"port,omitempty"`
	// vm.HostRole — what the machine is being prepared for.
	Role string `protobuf:"bytes,4,opt,name=role,proto3" json:"role,omitempty"`
	// The four fields that are sdk.StringOutput in HostFacts.
	//
	// They are OutputValue and not plain strings because a cloud driver only learns
	// an address once the instance (or its floating IP) exists, and only learns a
	// generated key once the key resource exists. They are not bare "<urn>#<property>"
	// strings either: for the `byo` driver every one of these is a config literal,
	// and `private_key_password` is a literal "" on both Cloud.ru drivers. §3.5.
	Address *OutputValue `protobuf:"bytes,5,opt,name=address,proto3" json:"address,omitempty"`
	// ALREADY the deploy key; core re-wraps it as a Pulumi secret unconditionally.
	PrivateKey *OutputValue `protobuf:"bytes,6,opt,name=private_key,json=privateKey,proto3" json:"private_key,omitempty"`
	// Empty unless the key is an encrypted PEM. Also re-wrapped secret.
	PrivateKeyPassword *OutputValue `protobuf:"bytes,7,opt,name=private_key_password,json=privateKeyPassword,proto3" json:"private_key_password,omitempty"`
	// The machine's PUBLIC host key as an authorized_keys line. Deliberately not
	// secret: keeping it readable is what lets an operator compare it against the
	// cloud console by eye. Core normalises surrounding whitespace on receipt.
	HostKey *OutputValue `protobuf:"bytes,8,opt,name=host_key,json=hostKey,proto3" json:"host_key,omitempty"`
	// Whether host_key carries a key at all.
	//
	// Separate from host_key, and a plain bool, because the question it answers —
	// "will this connection verify the machine's identity?" — must be answerable
	// while the graph is being built: it decides whether to set the connection's host
	// key at all (an empty one fails every connection rather than falling back) and
	// whether to warn. A driver always knows the answer, even when it does not yet
	// know the key.
	HostKeyPinned bool `protobuf:"varint,9,opt,name=host_key_pinned,json=hostKeyPinned,proto3" json:"host_key_pinned,omitempty"`
	// URNs of resources that must exist before anything connects. Core rehydrates
	// each into an sdk.Resource for DependsOn (type token and name are read out of
	// the URN, so core never needs to know a plugin's resource types). Empty for a
	// machine that predates the stack.
	DependsOn []string `protobuf:"bytes,10,rep,name=depends_on,json=dependsOn,proto3" json:"depends_on,omitempty"`
	// contains filtered or unexported fields
}

VmHostFacts is one reachable machine — pkg/clouds/pulumi/vm.HostFacts over the wire. Everything the layers above the driver need, and nothing about how the machine came to exist.

func (*VmHostFacts) Descriptor deprecated

func (*VmHostFacts) Descriptor() ([]byte, []int)

Deprecated: Use VmHostFacts.ProtoReflect.Descriptor instead.

func (*VmHostFacts) GetAddress

func (x *VmHostFacts) GetAddress() *OutputValue

func (*VmHostFacts) GetDependsOn

func (x *VmHostFacts) GetDependsOn() []string

func (*VmHostFacts) GetHostKey

func (x *VmHostFacts) GetHostKey() *OutputValue

func (*VmHostFacts) GetHostKeyPinned

func (x *VmHostFacts) GetHostKeyPinned() bool

func (*VmHostFacts) GetName

func (x *VmHostFacts) GetName() string

func (*VmHostFacts) GetPort

func (x *VmHostFacts) GetPort() int32

func (*VmHostFacts) GetPrivateKey

func (x *VmHostFacts) GetPrivateKey() *OutputValue

func (*VmHostFacts) GetPrivateKeyPassword

func (x *VmHostFacts) GetPrivateKeyPassword() *OutputValue

func (*VmHostFacts) GetRole

func (x *VmHostFacts) GetRole() string

func (*VmHostFacts) GetUser

func (x *VmHostFacts) GetUser() string

func (*VmHostFacts) ProtoMessage

func (*VmHostFacts) ProtoMessage()

func (*VmHostFacts) ProtoReflect

func (x *VmHostFacts) ProtoReflect() protoreflect.Message

func (*VmHostFacts) Reset

func (x *VmHostFacts) Reset()

func (*VmHostFacts) String

func (x *VmHostFacts) String() string

type VmHostsRequest

type VmHostsRequest struct {
	Header *RequestHeader `protobuf:"bytes,1,opt,name=header,proto3" json:"header,omitempty"`
	// Which of the plugin's advertised vm_drivers this call is for.
	Driver string `protobuf:"bytes,2,opt,name=driver,proto3" json:"driver,omitempty"`
	// The vm resource's SC-level name — what the machines' resource names are built
	// from, and therefore part of the no-destroy invariant.
	ResourceName string `protobuf:"bytes,3,opt,name=resource_name,json=resourceName,proto3" json:"resource_name,omitempty"`
	// The resource's config: the JSON of pkg/clouds/vm.VmConfig.
	//
	// Bytes rather than map<string, InputValue> because VmConfig is a deep struct
	// (size, network, ingress with its ACME/EAB block, hosts, ingressPorts) that is
	// already defined with json tags and already round-trips through JSON in the
	// config reader. Flattening it onto InputValue would invent a second encoding
	// of the same struct that both sides must agree on, and every new config field
	// would then need a wire change. A plugin unmarshals this into
	// pkg/clouds/vm.VmConfig from the api module it already imports.
	//
	// `credentials` IS in here, and that is a statement of what works today rather
	// than of what should: the SCCore.ResolveCredential callback this bus declares
	// (Vault pattern, 03 §6.3) has no core-side implementation — nothing in
	// pkg/clouds/pulumi serves the SCCore service, and no plugin can call it. Every
	// other surface on this bus already ships the resource's `credentials` inline
	// (serializeConfigToInputs JSON-marshals the whole config, credentials included),
	// so a VM driver that did it differently would be the one surface a plugin author
	// could not copy. See credential_name for where this goes.
	ConfigJson []byte `protobuf:"bytes,4,opt,name=config_json,json=configJson,proto3" json:"config_json,omitempty"`
	// RESERVED, and empty on every call today.
	//
	// When SCCore.ResolveCredential is implemented core-side, this carries the
	// `${auth:…}` name for the plugin to fetch, `credentials` comes out of
	// config_json, and a cloud's root credential stops crossing this bus at all. It
	// is kept declared, rather than added later, so that moving to the callback is a
	// behaviour change on both ends and not a wire change.
	CredentialName string `protobuf:"bytes,5,opt,name=credential_name,json=credentialName,proto3" json:"credential_name,omitempty"`
	// Every hole to open in the machine's firewall, already resolved by core's
	// firewall.go: the base set, the resource's `ingressPorts`, and the presets
	// inferred from the consumers that name this resource in the parent stack.
	//
	// Resolved by core and passed in, because that inference needs the WHOLE parent
	// stack — which a driver is deliberately not given, and a plugin could not be
	// given without shipping it the other services' configs.
	//
	// Empty for a driver whose cloud SC cannot write firewall rules in (capabilities'
	// security_groups = false); such a driver must ignore it rather than guess.
	Ports []*VmPortRange `protobuf:"bytes,6,rep,name=ports,proto3" json:"ports,omitempty"`
	// Parent ComponentResource URN, if core registered one. Empty today: core
	// registers a vm resource's machines at the stack root, so there is no parent to
	// name. Declared because a plugin that nests its resources under a component of
	// its own needs somewhere to hang it, and because adding the field once a
	// plugin's state exists would renumber nothing but still be a wire change.
	ParentUrn string `protobuf:"bytes,7,opt,name=parent_urn,json=parentUrn,proto3" json:"parent_urn,omitempty"`
	// contains filtered or unexported fields
}

func (*VmHostsRequest) Descriptor deprecated

func (*VmHostsRequest) Descriptor() ([]byte, []int)

Deprecated: Use VmHostsRequest.ProtoReflect.Descriptor instead.

func (*VmHostsRequest) GetConfigJson

func (x *VmHostsRequest) GetConfigJson() []byte

func (*VmHostsRequest) GetCredentialName

func (x *VmHostsRequest) GetCredentialName() string

func (*VmHostsRequest) GetDriver

func (x *VmHostsRequest) GetDriver() string

func (*VmHostsRequest) GetHeader

func (x *VmHostsRequest) GetHeader() *RequestHeader

func (*VmHostsRequest) GetParentUrn

func (x *VmHostsRequest) GetParentUrn() string

func (*VmHostsRequest) GetPorts

func (x *VmHostsRequest) GetPorts() []*VmPortRange

func (*VmHostsRequest) GetResourceName

func (x *VmHostsRequest) GetResourceName() string

func (*VmHostsRequest) ProtoMessage

func (*VmHostsRequest) ProtoMessage()

func (*VmHostsRequest) ProtoReflect

func (x *VmHostsRequest) ProtoReflect() protoreflect.Message

func (*VmHostsRequest) Reset

func (x *VmHostsRequest) Reset()

func (*VmHostsRequest) String

func (x *VmHostsRequest) String() string

type VmHostsResponse

type VmHostsResponse struct {
	Hosts []*VmHostFacts `protobuf:"bytes,1,rep,name=hosts,proto3" json:"hosts,omitempty"`
	// contains filtered or unexported fields
}

func (*VmHostsResponse) Descriptor deprecated

func (*VmHostsResponse) Descriptor() ([]byte, []int)

Deprecated: Use VmHostsResponse.ProtoReflect.Descriptor instead.

func (*VmHostsResponse) GetHosts

func (x *VmHostsResponse) GetHosts() []*VmHostFacts

func (*VmHostsResponse) ProtoMessage

func (*VmHostsResponse) ProtoMessage()

func (*VmHostsResponse) ProtoReflect

func (x *VmHostsResponse) ProtoReflect() protoreflect.Message

func (*VmHostsResponse) Reset

func (x *VmHostsResponse) Reset()

func (*VmHostsResponse) String

func (x *VmHostsResponse) String() string

type VmPortRange

type VmPortRange struct {

	// Label is part of the contract, not decoration: on at least one cloud it becomes
	// the rule's Pulumi resource NAME (so renaming one replaces a rule) and on
	// another the rule's description, which is the only way a destroy can tell SC's
	// rules apart from the ones the project's shared default group came with.
	Label    string `protobuf:"bytes,1,opt,name=label,proto3" json:"label,omitempty"`
	Protocol string `protobuf:"bytes,2,opt,name=protocol,proto3" json:"protocol,omitempty"` // "tcp" / "udp", lowercase
	From     int32  `protobuf:"varint,3,opt,name=from,proto3" json:"from,omitempty"`
	To       int32  `protobuf:"varint,4,opt,name=to,proto3" json:"to,omitempty"`
	// Internal restricts the hole to the other machines of this vm resource rather
	// than opening it to the internet — the kubelet and etcd ports of a multi-node
	// k3s cluster. How it is enforced is the driver's business (source security group,
	// private subnet CIDR, …), but ignoring it is not: that is a cluster anyone can
	// take over.
	Internal bool `protobuf:"varint,5,opt,name=internal,proto3" json:"internal,omitempty"`
	// contains filtered or unexported fields
}

VmPortRange mirrors pkg/clouds/vm.PortRange.

func (*VmPortRange) Descriptor deprecated

func (*VmPortRange) Descriptor() ([]byte, []int)

Deprecated: Use VmPortRange.ProtoReflect.Descriptor instead.

func (*VmPortRange) GetFrom

func (x *VmPortRange) GetFrom() int32

func (*VmPortRange) GetInternal

func (x *VmPortRange) GetInternal() bool

func (*VmPortRange) GetLabel

func (x *VmPortRange) GetLabel() string

func (*VmPortRange) GetProtocol

func (x *VmPortRange) GetProtocol() string

func (*VmPortRange) GetTo

func (x *VmPortRange) GetTo() int32

func (*VmPortRange) ProtoMessage

func (*VmPortRange) ProtoMessage()

func (*VmPortRange) ProtoReflect

func (x *VmPortRange) ProtoReflect() protoreflect.Message

func (*VmPortRange) Reset

func (x *VmPortRange) Reset()

func (*VmPortRange) String

func (x *VmPortRange) String() string

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL