pluginv1

type ActionDescriptor struct {

	// The action's stable, versioned identifier, e.g. "text.uppercase@1".
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// One human-readable sentence: what this action does.
	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
	// JSON Schema describing the shape ExecuteActionRequest.input must
	// match.
	InputSchema *structpb.Struct `protobuf:"bytes,3,opt,name=input_schema,json=inputSchema,proto3" json:"input_schema,omitempty"`
	// JSON Schema describing the shape ExecuteActionResponse.output will
	// match.
	OutputSchema *structpb.Struct `protobuf:"bytes,4,opt,name=output_schema,json=outputSchema,proto3" json:"output_schema,omitempty"`
	// Default timeout for a call to this action, in seconds. Zero means the
	// agent's own default applies — an action does not have to declare one.
	DefaultTimeoutSeconds uint32 `` /* 127-byte string literal not displayed */
	// contains filtered or unexported fields
}

type ConnectorConfig struct {
	Type    string           `protobuf:"bytes,1,opt,name=type,proto3" json:"type,omitempty"`
	Config  *structpb.Struct `protobuf:"bytes,2,opt,name=config,proto3" json:"config,omitempty"`
	Secrets *structpb.Struct `protobuf:"bytes,3,opt,name=secrets,proto3" json:"secrets,omitempty"`
	// contains filtered or unexported fields
}

type ConnectorDescriptor struct {

	// The connector type's stable, versioned identifier, e.g.
	// "postgresql.connection@1".
	Type string `protobuf:"bytes,1,opt,name=type,proto3" json:"type,omitempty"`
	// One human-readable sentence: what system this connector reaches.
	Description string `protobuf:"bytes,2,opt,name=description,proto3" json:"description,omitempty"`
	// JSON Schema describing the shape of this connector's non-secret
	// configuration (ConnectorConfig.config). Never covers secret values —
	// those never appear in a schema meant to be shown or stored (ADR-0009).
	ConfigSchema *structpb.Struct `protobuf:"bytes,3,opt,name=config_schema,json=configSchema,proto3" json:"config_schema,omitempty"`
	// contains filtered or unexported fields
}

type Contributions struct {
	Connectors []*ConnectorDescriptor `protobuf:"bytes,3,rep,name=connectors,proto3" json:"connectors,omitempty"`
	Actions    []*ActionDescriptor    `protobuf:"bytes,4,rep,name=actions,proto3" json:"actions,omitempty"`
	// contains filtered or unexported fields
}

type ExecuteActionRequest struct {

	// The action identifier, e.g. "text.uppercase@1".
	Action string           `protobuf:"bytes,1,opt,name=action,proto3" json:"action,omitempty"`
	Input  *structpb.Struct `protobuf:"bytes,2,opt,name=input,proto3" json:"input,omitempty"`
	// The resolved configuration and secrets of the connector the calling
	// workflow step bound to this action, if any. Absent when the step bound
	// no connector. Never persisted by the agent — assembled fresh for this
	// one call.
	Connector *ConnectorConfig `protobuf:"bytes,3,opt,name=connector,proto3" json:"connector,omitempty"`
	// contains filtered or unexported fields
}

type ExecuteActionResponse struct {
	Output *structpb.Struct `protobuf:"bytes,1,opt,name=output,proto3" json:"output,omitempty"`
	// contains filtered or unexported fields
}

type HandshakeRequest struct {

	// Highest plugin protocol version the calling agent supports.
	ProtocolVersion uint32 `protobuf:"varint,1,opt,name=protocol_version,json=protocolVersion,proto3" json:"protocol_version,omitempty"`
	// contains filtered or unexported fields
}

type HandshakeResponse struct {

	// Protocol version the plugin will speak for the rest of this session.
	// Must not exceed HandshakeRequest.protocol_version; the agent rejects the
	// plugin if it does.
	ProtocolVersion uint32         `protobuf:"varint,1,opt,name=protocol_version,json=protocolVersion,proto3" json:"protocol_version,omitempty"`
	PluginId        string         `protobuf:"bytes,2,opt,name=plugin_id,json=pluginId,proto3" json:"plugin_id,omitempty"`
	PluginVersion   string         `protobuf:"bytes,3,opt,name=plugin_version,json=pluginVersion,proto3" json:"plugin_version,omitempty"`
	Contributes     *Contributions `protobuf:"bytes,4,opt,name=contributes,proto3" json:"contributes,omitempty"`
	Permissions     []string       `protobuf:"bytes,5,rep,name=permissions,proto3" json:"permissions,omitempty"`
	// contains filtered or unexported fields
}

type PluginServiceClient interface {
	// Handshake negotiates the protocol version and returns the plugin's
	// manifest: its identity, version, and the connectors/actions it
	// contributes to the agent.
	Handshake(ctx context.Context, in *HandshakeRequest, opts ...grpc.CallOption) (*HandshakeResponse, error)
	// ExecuteAction runs one of the plugin's contributed actions and returns
	// its output. The agent only calls this for actions listed in the
	// manifest's Contributions returned by Handshake.
	ExecuteAction(ctx context.Context, in *ExecuteActionRequest, opts ...grpc.CallOption) (*ExecuteActionResponse, error)
	// TestConnector attempts to use a connector's resolved configuration and
	// secrets to reach the external system it describes, without running any
	// action. A plugin that does not support connector testing returns
	// UNIMPLEMENTED; the agent surfaces that as "this plugin does not support
	// connection testing", distinct from a test that ran and failed (Ok =
	// false). The agent only calls this for a connector whose type is listed
	// in the manifest's Contributions returned by Handshake.
	TestConnector(ctx context.Context, in *TestConnectorRequest, opts ...grpc.CallOption) (*TestConnectorResponse, error)
}

type PluginServiceServer interface {
	// Handshake negotiates the protocol version and returns the plugin's
	// manifest: its identity, version, and the connectors/actions it
	// contributes to the agent.
	Handshake(context.Context, *HandshakeRequest) (*HandshakeResponse, error)
	// ExecuteAction runs one of the plugin's contributed actions and returns
	// its output. The agent only calls this for actions listed in the
	// manifest's Contributions returned by Handshake.
	ExecuteAction(context.Context, *ExecuteActionRequest) (*ExecuteActionResponse, error)
	// TestConnector attempts to use a connector's resolved configuration and
	// secrets to reach the external system it describes, without running any
	// action. A plugin that does not support connector testing returns
	// UNIMPLEMENTED; the agent surfaces that as "this plugin does not support
	// connection testing", distinct from a test that ran and failed (Ok =
	// false). The agent only calls this for a connector whose type is listed
	// in the manifest's Contributions returned by Handshake.
	TestConnector(context.Context, *TestConnectorRequest) (*TestConnectorResponse, error)
	// contains filtered or unexported methods
}

type TestConnectorRequest struct {
	Connector *ConnectorConfig `protobuf:"bytes,1,opt,name=connector,proto3" json:"connector,omitempty"`
	// contains filtered or unexported fields
}

type TestConnectorResponse struct {
	Ok bool `protobuf:"varint,1,opt,name=ok,proto3" json:"ok,omitempty"`
	// Human-readable detail: the error message on failure, or empty/a short
	// confirmation on success.
	Message string `protobuf:"bytes,2,opt,name=message,proto3" json:"message,omitempty"`
	// contains filtered or unexported fields
}

type UnimplementedPluginServiceServer struct{}

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